Documentação

Referência da API

Gerar imagens síncronas

POST/v1/images/generations

A geração síncrona valida parâmetros por modelo e só aceita recursos do modelo seleccionado. Qwen: até 6 imagens/3 referências; Ark conforme modelo; Venice gera uma imagem por texto e não aceita referências. Arquivos comuns seguem retenção por dias, diferente de tarefas persistentes.

Limites da saída síncrona

Qwen aceita até 6 saídas e 3 referências; limites de Ark variam por modelo, e Venice só gera uma imagem a partir de texto. Escolha primeiro o modelo e envie seus campos correspondentes; não envie referências a modelos sem suporte.

Se precisar confirmar cotação, manter histórico prolongado e recuperar após desconexão, use imagens persistentes em vez de repetir automaticamente a geração síncrona. Cabeçalhos de arquivamento só descrevem o salvamento. A retenção de arquivos comuns difere da proteção por referências de tarefas; consulte Faturamento.

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

Solicitação

Corpo da solicitação · application/json

Tipo
object
Campos obrigatórios
modelprompt

Corpo da solicitação obrigatório

  • image_urlsarrayOpcional

    Lista de URLs de referências conforme modelo; Qwen/Ark têm limites próprios, Venice síncrono de texto para imagem rejeita o campo.

    Campos filhos de image_urls (1)
    • []stringOpcional
  • modelstringObrigatório

    ID público do modelo no catálogo da chave atual.

  • promptstringObrigatório

    Prompt de geração.

  • nintegerOpcional

    Quantidade de imagens solicitada, sujeita ao máximo do modelo.

  • sizestringOpcional

    Tamanho retornado por image-models selecionado; recursos e tamanhos são validados por modelo.

  • response_formatstringOpcional

    Formato de saída conforme modelo; não presuma suporte a todos os formatos.

  • userunknownOpcional

    Valor JSON definido por schema ou protocolo da ferramenta; sem presumir campos fixos.

  • extra_bodyunknownOpcional

    Valor JSON definido por schema ou protocolo da ferramenta; sem presumir campos fixos.

Respostas e erros

HTTP 200

Imagens síncronas geradas com sucesso

application/json

Tipo
object
Campos obrigatórios
createddata
  • createdintegerObrigatório

    Data de geração da resposta de imagem em segundos Unix.

  • dataarrayObrigatório

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

    Campos filhos de data (1)
    • []objectOpcional
      Campos filhos de [] (7)
      • file_idstringOpcional

        ID público de arquivo gerenciado da mesma conta e chave.

      • storage_statusstringOpcional

        Status de arquivamento; download gerenciado garantido apenas após ready.

      • storage_errorstringOpcional

        Categoria pública de falha de arquivamento.

      • expires_atintegerOpcional

        Expiração em segundos Unix; 0 indica ausência de expiração fixa.

      • urlstringOpcional

        URL de acesso ao resultado ou referência; assinadas só valem temporariamente.

      • b64_jsonstringOpcional

        String Base64 da imagem; não a solicite como URL.

      • revised_promptstringOpcional

        Prompt revisado retornado pelo serviço, se houver.

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.