OpenAI Decisions API vs Responses API

Para que serve cada API

A Responses API é a ferramenta geral: envie texto ou imagens, receba texto gerado, JSON válido por schema ou chamadas de ferramentas, e mantenha a conversa entre turnos. É o endpoint que você usa quando o modelo precisa produzir algo novo.

A Decisions API é mais estreita por design. Você envia contexto mais uma pergunta com um conjunto finito de respostas que define, e ela retorna uma dessas respostas — com uma probabilidade por opção e uma confiança, segundo o anúncio da OpenAI. Está em prévia limitada em 2026-09-30, com lançamento amplo anunciado para os próximos dias. O endpoint deste site executa hoje o mesmo padrão de resposta finita com decisions-1.

Lado a lado

Uma decisão na Responses API hoje

Você já pode aproximar uma decisão com a Responses API: restrinja a saída com um schema JSON e um enum. Você recebe um rótulo válido — mas sem probabilidades por opção para as demais alternativas.

// OpenAI Responses API: ask for a label inside a JSON schema.
// You get a label — not a probability per option.
const res = await client.responses.create({
  model: "YOUR_MODEL",
  input: "The page renders blank in Safari. Route this ticket.",
  text: {
    format: {
      type: "json_schema",
      name: "route",
      strict: true,
      schema: {
        type: "object",
        properties: {
          team: { type: "string", enum: ["payments", "frontend", "account"] },
        },
        required: ["team"],
        additionalProperties: false,
      },
    },
  },
});
// res.output_text -> { "team": "frontend" }

A mesma tarefa como requisição de decisão

Como pergunta choice no endpoint deste site, a mesma tarefa de roteamento retorna o rótulo vencedor, uma probabilidade para cada opção e uma confiança — os dados necessários para rotear automaticamente os casos claros e escalar os apertados.

// decisions-1 on this site: the same routing task as a choice question.
const res = await fetch("https://decisions-api.net/api/v1/decisions", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "decisions-1",
    state: "The page renders blank in Safari.",
    questions: {
      team: {
        type: "choice",
        instructions: "Which team should own this ticket?",
        criteria: {
          payments: "Checkout or billing.",
          frontend: "Rendering or browser behavior.",
          account: "Login or permissions.",
        },
      },
    },
  }),
});
// Illustrative response: answers.team ->
//   { choice: "frontend", probabilities: {...}, confidence: 0.86 }

Quando usar qual

Use a Responses API quando o modelo precisar produzir conteúdo: redigir a resposta, escrever o resumo, chamar a ferramenta. Use uma API de decisão quando o modelo precisar escolher — qual fila, qual ramo, qual próxima ação — e quando você precisar da distribuição para decidir se pode confiar.

Elas se compõem bem: uma chamada de decisão escolhe o ramo, depois uma chamada à Responses API escreve a resposta para esse ramo. Escolher e escrever são trabalhos diferentes.

Perguntas frequentes