Inovacc Desenvolvedores

Referência da API / Motor de decisão

Executar um modelo

POSThttps://ai.inovacc.dev/v1/run

Responde a perguntas estruturadas sobre um estado, com um veredito e uma confiança para cada uma.

Parâmetros do corpo

  • modelstring

    Um id de rota de decisão de GET /v1/models. Sem valor, usa a rota padrão da sua organização.

  • inputobjectobrigatório

    {"state", "questions", "images"?}. Qualquer outro campo é recusado com invalid_decision_input.

  • input.stateanyobrigatório

    O que julgar: qualquer valor JSON, exceto null.

  • input.questionsobjectobrigatório

    De 1 a 64 perguntas indexadas pelos seus ids. Cada uma tem um type (noul, choice ou score), instructions e criteria no formato estrito do seu tipo.

  • input.imagesarray

    No máximo 16 imagens para julgar junto com o estado.

  • escalateboolean | object

    Refaz as perguntas duvidosas no próximo nível mais forte. true usa os padrões; um objeto aceita min_confidence e max_tier.

Cabeçalhos

  • Authorizationstringobrigatório

    Bearer <chave de API>

  • X-Operation-Idstringobrigatório

    um id único que você escolhe, em toda chamada exceto GET

  • Content-Typestringobrigatório

    application/json, em uma chamada com corpo

Veja também

Detalhes da fonte

Entrada do catálogo

Id
identity/component-taxonomy/capabilities#decision
Repositório
identity
Caminho
contracts/component-taxonomy/catalog/capabilities.json
Commit
08ef3cd75d82

Seção do contrato

Id
ai/ai/contract#post-v1run
Repositório
ai
Caminho
apps/cloudflare/workers/api/ai/CONTRACT.md
Commit
972a1c15b9d5
Versão documentada
2.37.0
Versão em produção
2.14.0
Atualizado em 2026-10-10.