Referência da API
Obter cotação de imagem persistente
/v1/image-quotesSó valida entradas e permissões; não bloqueia imagens. Cotação válida por 60 segundos; a criação revalida rota/preço/solicitação. Serviço desativado retorna 503.
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_KEYEsquemas de autenticação: BearerAuth
Solicitação
Corpo da solicitação · application/json
- Tipo
- object
- Campos obrigatórios
modelpromptsize- Propriedades adicionais
- false
Corpo da solicitação obrigatório
modelstringObrigatórioID público do modelo no catálogo da chave atual.
- Comprimento máximo
191
promptstringObrigatórioNão vazio, máximo de 32000 bytes UTF-8; maxLength do OpenAPI conta caracteres, por isso não se inventa um máximo de caracteres.
sizestringObrigatórioTamanho retornado por image-models selecionado; recursos e tamanhos são validados por modelo.
nintegerOpcionalOmitido ou 0 normaliza para 1. Limite real: max_n de image-models; máximo global não é recurso do modelo.
- Valor padrão
1- Mínimo
1- Máximo
6
referencesarrayOpcionalEm cada item, apenas um de file_id, asset_id ou url; quantidade conforme max_references.
- Máximo de itens
14
Campos filhos de references (1)
[]objectOpcionalCampos filhos de [] (3)
Ramificação oneOf 1
Obrigatório nesta ramificação: file_id
Ramificação oneOf 2
Obrigatório nesta ramificação: asset_id
Ramificação oneOf 3
Obrigatório nesta ramificação: url
source_task_idstringOpcionalTarefa de origem opcional da mesma chave, apenas para rastreabilidade; não substitui references.
- Comprimento máximo
64
quote_idstringOpcionalNa criação, deve ser uma cotação válida e correspondente à solicitação; ignorada em solicitações de cotação.
Respostas e erros
HTTP 200
Cotação de imagem persistente obtida com sucesso
application/json
- Tipo
- object
- Campos obrigatórios
pricing_noteidexpires_atreserved_quotaestimated_costcurrency
pricing_notestringObrigatórioDescrição do preço do modelo; liquidação final conforme medição confirmada.
idstringObrigatórioIdentificador público do objeto, usado na sua rota de detalhes.
expires_atintegerObrigatórioExpiração em segundos Unix; 0 indica ausência de expiração fixa.
reserved_quotaintegerObrigatórioReserva em unidades quota da plataforma, não em USD.
estimated_costnumberObrigatórioCobrança de venda estimada na moeda cotada.
currencystringObrigatórioMoeda da cotação/cobrança.
HTTP 400
Campos ou parâmetros de solicitação inválidos.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 401
A chave está ausente, inválida, expirada ou revogada.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 403
Permissões insuficientes de IP, conta, modelo ou ferramenta.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 404
Objeto/recurso indisponível ou função desativada.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 409
Conflito de idempotência/cotação, objeto não pronto ou ainda referenciado.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 429
Limite de solicitações/fila.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 500
Falha interna de autenticação ou armazenamento de dados.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 503
Serviço, preços ou armazenamento indisponíveis.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional