Documentação

Referência da API

Obter cotação da ferramenta

POST/v1/tools/{id}/quote

Aceita flat constante por chamada, input calculado previamente pelas entradas e usage pelo uso final. pricing.quote_required determina se a cotação é obrigatória; requires_usage, se limite de custo e uso final oficial são exigidos. Nenhum é inferido de schema_version. Com metered_pricing desativado, só novas chamadas que exigem uso final são restritas; regras constantes/por entrada sem esse requisito continuam disponíveis. A chave atual precisa de autorização de ferramentas; identidade e resultados são limitados à chave original. Com a opção geral desativada, o catálogo fica vazio; catálogo anônimo não autoriza execução. O id da rota identifica a ferramenta; o corpo público só aceita version obrigatória não vazia e input conforme input_schema. Rejeita extras como tool_id, quote_id e max_cost_usd. Cotação válida por 300 segundos, vinculada à mesma chave, versão exata, entrada normalizada e configuração de preço/origem; retorna tool_id/version/maximum_usd e não envia ao serviç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

Solicitação

Parâmetros de caminho

  • idstringObrigatório

    ID da ferramenta do catálogo ou execução original, conforme objeto da operação.

Corpo da solicitação · application/json

Tipo
object
Campos obrigatórios
versioninput
Propriedades adicionais
false

Corpo da solicitação obrigatório

  • versionstringObrigatório

    Versão do contrato obrigatória e não vazia; use version exata dos detalhes, sem padrão para a atual.

    Comprimento mínimo
    1
    Padrão
    ".*\\S.*"
  • inputunknownObrigatório

    Deve cumprir input_schema dessa version; apenas JSON normalizado, sem campos extras como route_id de administrador.

Respostas e erros

HTTP 200

Cotação da ferramenta obtida com sucesso

application/json

Tipo
object
Campos obrigatórios
quote_idmaximum_usdprice_versionexpires_atcomponentstool_idversion
  • quote_idstringObrigatório

    ID público da cotação; deve corresponder ao preço e à solicitação na criação.

  • maximum_usdstringObrigatório

    Reserva máxima USD para esta entrada normalizada.

  • price_versionintegerObrigatório

    Revisão do preço de venda.

  • expires_atintegerObrigatório

    Expiração em segundos Unix; cotações de ferramentas valem 300 segundos, conforme o expires_at real.

  • componentsunknownObrigatório

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

  • tool_idstringObrigatório

    ID da ferramenta vinculado a esta cotação.

  • versionstringObrigatório

    Versão exata do contrato vinculada a esta cotação.

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.