Documentação

Referência da API

Consultar recursos de imagens persistentes

GET/v1/image-models

O catálogo aceita atualmente Ark Seedream Pro/Lite e Qwen; correções não integradas do espaço persistente Venice ficam fora desta base. Retorna opções de ativação e recursos da mesma chave; não garante disponibilidade em produção.

Autenticação e permissões

Use sua chave atual do GloopAPI. Modelos, recursos e permissões disponíveis dependem do catálogo da chave e da documentação do endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticação: BearerAuth

Respostas e erros

HTTP 200

Recursos de imagens persistentes consultados com sucesso

application/json

Tipo
object
Campos obrigatórios
workspace_enabledfile_storage_enableddataupload_enabled
  • workspace_enabledbooleanObrigatório

    Se novas tarefas estão ativadas no espaço atual; não implica exclusão do histórico.

  • file_storage_enabledbooleanObrigatório

    Se o serviço ativa armazenamento gerenciado.

  • dataarrayObrigatório

    Array de dados da página/catálogo atual.

    Campos filhos de data (1)
    • []objectOpcional
      Campos filhos de [] (8)
      • idstringObrigatório

        Identificador público do objeto, usado na sua rota de detalhes.

      • namestringObrigatório

        Nome legível para o usuário.

      • providerstringObrigatório

        Nome do provedor do modelo exibido no catálogo de recursos.

      • max_referencesintegerObrigatório

        Máximo de referências do modelo escolhido.

      • max_nintegerObrigatório

        Máximo de imagens de saída do modelo escolhido.

      • sizesarrayObrigatório

        Tamanhos permitidos por este modelo.

        Campos filhos de sizes (1)
        • []objectOpcional
          Campos filhos de [] (2)
          • valuestringObrigatório

            Valor de tamanho realmente enviado.

          • labelstringObrigatório

            Nome de exibição do tamanho.

      • versionstringObrigatório

        Versão do contrato/recurso ou ferramenta; a execução usa a versão retornada pelo catálogo.

      • outputstringObrigatório

        JSON da saída da ferramenta ou formato do modelo, definido por seu schema/recurso.

  • upload_enabledbooleanObrigatório

    Se o serviço ativa uploads de referências.

HTTP 400

Campos ou parâmetros de solicitação inválidos.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 401

A chave está ausente, inválida, expirada ou revogada.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 403

Permissões insuficientes de IP, conta, modelo ou ferramenta.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 404

Objeto/recurso indisponível ou função desativada.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 409

Conflito de idempotência/cotação, objeto não pronto ou ainda referenciado.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 429

Limite de solicitações/fila.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 500

Falha interna de autenticação ou armazenamento de dados.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 503

Serviço, preços ou armazenamento indisponíveis.

application/json

Tipo
object
Campos obrigatórios
error
Pronto para criar? Abra console para criar uma chave de API, ou explore recursos.