OpenAI Decisions API vs Responses API

Para qué es cada API

La Responses API es la herramienta general: envías texto o imágenes, recibes texto generado, JSON válido por esquema o llamadas a herramientas, y mantienes la conversación entre turnos. Es el endpoint que usas cuando el modelo tiene que producir algo nuevo.

La Decisions API es más estrecha por diseño. Envías contexto más una pregunta con un conjunto finito de respuestas que defines tú, y devuelve una de esas respuestas — con una probabilidad por opción y una confianza, según el anuncio de OpenAI. Está en vista previa limitada al 2026-09-30, con lanzamiento amplio anunciado para los próximos días. El endpoint de este sitio ejecuta hoy el mismo patrón de respuesta finita con decisions-1.

Lado a lado

Una decisión con la Responses API hoy

Ya puedes aproximar una decisión con la Responses API: restringe la salida con un esquema JSON y un enum. Recibes una etiqueta válida — pero sin probabilidades por opción para las 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" }

La misma tarea como petición de decisión

Como pregunta choice en el endpoint de este sitio, la misma tarea de enrutamiento devuelve la etiqueta ganadora, una probabilidad por cada opción y una confianza — los datos que necesitas para enrutar automáticamente los casos claros y escalar los cerrados.

// 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 }

Cuándo usar cuál

Usa la Responses API cuando el modelo tenga que producir contenido: redactar la respuesta, escribir el resumen, llamar a la herramienta. Usa una API de decisión cuando el modelo tenga que elegir — qué cola, qué rama, qué siguiente acción — y cuando necesites la distribución para decidir si confiar.

Se componen bien: una llamada de decisión elige la rama y luego una llamada a la Responses API escribe la respuesta para esa rama. Elegir y escribir son trabajos distintos.

Preguntas frecuentes