Skip to main content
POST
Tomar decisões estruturadas
Use POST /v1/decisions quando sua aplicação precisar de respostas estruturadas que o código possa consumir diretamente. Os modelos suportados incluem TypeSafe Jev 1.13 (typesafe/jev-1.13.0), Together Tev1 4B Experimental (together/tev1-4b-experimental) e Respan Span-01 (respan/span-01:free e respan/span-01). A solicitação contém:
  • state: uma string, objeto ou array com as informações a avaliar.
  • questions: um mapa de perguntas nomeadas. Cada pergunta define type como noul, choice ou score e inclui instructions; os tipos suportados dependem do modelo selecionado.
  • model: o identificador do modelo da Phaseo. Use typesafe/jev-1.13.0 para Jev 1.13 ou typesafe/jev-latest para acompanhar a versão mais recente de Jev.
Liquid D1 (liquid-ai/d1:free, também disponível como liquid-ai/d1) e Perplexity Decider 27B (perplexity/decider-27b) suportam os três tipos de perguntas. D1 é gratuito durante o acesso antecipado experimental. Decider custa US$ 0,04 por milhão de tokens de entrada, incluindo tokens de imagem; os tokens de saída são gratuitos. Adicione uma credencial do provedor Perplexity na Phaseo para usar Decider. Seu estado com imagens usa URLs de dados base64 PNG, JPEG ou WebP; URLs de imagens remotas não são suportadas. Cada pergunta de escolha aceita até 255 opções, e cada pergunta de pontuação até 10 níveis. Verifique a disponibilidade antes de chamar qualquer um dos modelos. Para Respan Span-01, state deve ser um trecho de conversa com um array input de mensagens anteriores e uma mensagem output do assistente. Span-01 suporta apenas perguntas noul. A resposta noul é a probabilidade de o comportamento estar presente; probabilities também inclui as probabilidades de ausência e de não ser observável.
respan/span-01:free é o modelo Lite gratuito com limite diário; a Phaseo o mapeia para o identificador de modelo API span-01-free da Respan. respan/span-01 é mapeado para span-01-pro e cobrado pela Respan a US$ 0,02 por milhão de tokens de entrada; os tokens de saída são gratuitos. Span-01 está em acesso antecipado, então a Respan precisa habilitar o acesso para sua organização. Adicione sua chave de API da Respan como credencial do provedor Respan na Phaseo antes de chamar esses modelos. As respostas usam as mesmas chaves de questions. Respostas choice incluem a opção selecionada, probabilidades e confiança; respostas noul incluem uma probabilidade de 0 a 1; e respostas score incluem uma pontuação ponderada por probabilidade, legenda, probabilidades e confiança. Para o exemplo da Respan, uma resposta tem este formato:
Jev permite combinar os três tipos de perguntas em uma solicitação; Span-01 suporta apenas perguntas noul. Consulte o início rápido para exemplos de cURL, JavaScript, SDK TypeScript e SDK Python prontos para copiar e colar. Jev 1.13 é cobrado a US$ 0,042 por milhão de tokens de entrada; os tokens de saída são gratuitos. Para a semântica das perguntas do provedor, consulte a referência da API da TypeSafe.

Decisões sobre imagens com Clef

cloudflare/clef e cloudflare/clef-flash suportam os três tipos de perguntas e imagens incorporadas pelo Cloudflare Workers AI. Cada um tem uma janela de contexto de 65.536 tokens. A entrada custa US0,24pormilha~odetokensnoClefeUS 0,24 por milhão de tokens no Clef e US 0,09 no Clef Flash.
Você também pode fornecer uma string data:image/png;base64,... em images. O Clef aceita até quatro imagens PNG, JPEG ou WebP, cada uma com no máximo 4 MiB e 16 megapixels, com até 8 MiB de dados de imagem decodificados no total e um corpo de requisição de 13 MiB. URLs remotas não são suportadas. O Cloudflare valida os formatos e dimensões das imagens. Modelos sem suporte a imagens rejeitam requisições com imagens. O Clef aceita no máximo 64 perguntas, com IDs de até 100 letras, dígitos, sublinhados, pontos ou hífens. Perguntas de escolha exigem de 2 a 255 opções; perguntas de pontuação exigem de 2 a 10 níveis. Consulte a documentação do Clef do Cloudflare.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Corpo

application/json
model
string
padrão:typesafe/jev-1.13.0
obrigatório

Identificador canônico do modelo da Phaseo ou alias do modelo do provedor.

state
obrigatório

Estado estruturado avaliado pelo modelo.

questions
object
obrigatório
images
(string | object)[]

Imagens incorporadas para modelos de decisão com capacidade visual. O Clef aceita PNG, JPEG ou WebP; URLs remotas não são suportadas. Máximo de 4 MiB e 16 megapixels por imagem, 8 MiB de dados decodificados no total e 13 MiB por corpo de requisição.

Maximum array length: 4
Pattern: ^[Dd][Aa][Tt][Aa]:image/(png|jpeg|webp);base64,[A-Za-z0-9+/]+={0,2}$
meta
boolean
padrão:false
echo_upstream_request
boolean
debug
object

Controles de depuração do gateway. Essas opções nunca são encaminhadas ao provedor.

provider
object

Preferências de roteamento de provedores para seleção pelo gateway.

routing
object

Preferências de roteamento de provedores para seleção pelo gateway.

metadata
object

Resposta

200 - application/json

Resposta de decisões estruturadas

model
string
answers
object
usage
object
request_id
string | null
meta
object
Última modificação em 2 de outubro de 2026