OpenAI lança Decisions API em beta público até 10x mais rápida

O que é a Decisions API

A OpenAI lançou em beta público a Decisions API, um endpoint dedicado (POST /v1/decisions) que avalia texto, imagens ou ambos e retorna respostas tipadas, com latência cerca de 10 vezes menor que a Responses API. A empresa afirma que a disponibilidade geral (GA) deve ocorrer nas próximas semanas. O único modelo disponível no momento é o gpt-6-luna.

O objetivo declarado do produto é transformar texto e imagens em "decisões que a aplicação possa usar": classificar conteúdo, rotear solicitações e priorizar trabalho. A documentação sugere experimentar no Playground antes de escrever código e exige versões recentes dos SDKs oficiais (Python 3.26.0, JavaScript 7.30.0, Go 3.73.0, Ruby 0.101.0 e Java 4.78.0).

Como funciona

Uma requisição tem três partes: o campo model (hoje, apenas gpt-6-luna), o input - uma string de texto ou mensagens de usuário combinando texto e imagens como evidência compartilhada - e questions, a lista do que avaliar, com tipo, instruções e opções ou níveis permitidos. A resposta devolve um array answers, em que cada item é identificado pelo name único dado à pergunta.

Há três tipos de pergunta:

• predicate: verifica se uma condição é verdadeira (por exemplo, dano visível em uma foto) e retorna uma probability de 0 a 1.
• choice: seleciona um valor de um conjunto fixo fornecido pelo desenvolvedor, como departamento ou categoria de conteúdo; a resposta inclui a escolha, um array de probabilities por opção e um campo confidence.
• score: avalia uma entrada contra níveis ordenados definidos pelo usuário, como gravidade de um problema; o resultado é a média ponderada pelos índices das probabilidades, podendo cair entre níveis.

A documentação orienta usar choice para categorias sem ordem e score para níveis ordenados. Recomenda-se incluir uma opção de reserva como "other" quando as categorias não cobrem todas as entradas, direcionando esses casos para uma fila de revisão geral.

Quando usar (e quando não usar)

A OpenAI delimita o escopo: use a Decisions API quando a aplicação precisar de um desses tipos de resposta. Para gerar objetos que sigam um schema JSON próprio - campos extraídos ou explicações escritas - a orientação é usar Structured Outputs com a Responses API; para que o modelo solicite uma chamada de ferramenta com argumentos, use function calling.

Há limitações técnicas relevantes: imagens devem ser enviadas como data URLs em base64 inline; URLs hospedadas via HTTP/HTTPS e entradas file_id não são aceitas neste endpoint. É possível combinar partes input_text e input_image na mesma mensagem de usuário para avaliar imagens junto com instruções ou outro contexto.

Exemplos ilustrados

A documentação traz exemplos em curl e nos cinco SDKs: um predizado que verifica dano visível em foto de produto (resposta ilustrativa: probabilidade 0,92); um choice que roteia a reclamação "I was charged twice for my order" para o departamento de billing (probabilidade 0,95, confiança 0,93 no exemplo); e um score que classifica a gravidade de um bug de exportação em três níveis - cosmético, com contorno disponível e totalmente bloqueado. As respostas podem incluir um tipo refusal, que o desenvolvedor deve tratar quando o modelo recusa responder a uma pergunta. A documentação remete a uma seção "Interpret the answers" para orientação sobre definição de limiares de decisão.