Documentación de la OpenAI Decisions API

Endpoint

Envía POST /api/v1/decisions en este host. No hay ruta chat-completions ni respuesta en streaming. GET /api/v1/models lista el id del modelo.

POST https://decisions-api.net/api/v1/decisions
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Autenticación

Pon la clave del panel en Authorization: Bearer. Una clave ausente o rechazada devuelve 401. El playground crea una clave de la cuenta al ejecutar.

Inicio rápido

Pon DECISIONS_API_KEY a una clave de tu panel y envía la solicitud de abajo. Los visitantes nuevos reciben 2 llamadas gratis, suficiente para 2 peticiones correctas.

curl https://decisions-api.net/api/v1/decisions \
  -H "Authorization: Bearer $DECISIONS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "decisions-1",
  "state": "Thanks for the refund. Still annoyed it took three emails.",
  "questions": {
    "sentiment": {
      "type": "choice",
      "instructions": "What is the overall sentiment of this message?",
      "criteria": {
        "positive": "Satisfied or thankful overall.",
        "mixed": "Both satisfied and unhappy.",
        "negative": "Unhappy overall."
      }
    },
    "needs_follow_up": {
      "type": "noul",
      "instructions": "Should a person reply to this message?"
    }
  }
}'

Usar con herramientas de programación con IA

Copia un prompt con el contrato de solicitud completo y pégalo en Cursor, Claude Code o ChatGPT junto con tu tarea. La misma referencia está en /llms.txt.

Cuerpo de la solicitud

model es decisions-1 o decisions-latest. state es una cadena, objeto JSON o array de texto, hasta 60,000 caracteres. questions es un mapa de 1 a 6 ids snake_case. El id es solo la etiqueta bajo la que vuelve tu respuesta, no una pregunta. La pregunta real va en instructions, como texto de 1 a 2,000 caracteres.

{
  "model": "decisions-1",
  "state": "Thanks for the refund. Still annoyed it took three emails.",
  "questions": {
    "sentiment": {
      "type": "choice",
      "instructions": "What is the overall sentiment of this message?",
      "criteria": {
        "positive": "Satisfied or thankful overall.",
        "mixed": "Both satisfied and unhappy.",
        "negative": "Unhappy overall."
      }
    },
    "needs_follow_up": {
      "type": "noul",
      "instructions": "Should a person reply to this message?"
    }
  }
}

Tipos de pregunta

Noul

type noul solo necesita instructions. El campo noul es la probabilidad de 0 a 1 de que la afirmación sea cierta. No hay un campo confidence aparte. Si envías criteria en una pregunta noul, este endpoint la ignora.

Choice

type choice necesita instructions y criteria: un objeto de 2 a 8 ids snake_case mapeados a descripciones de hasta 300 caracteres. La respuesta incluye choice, probabilities de cada opción y confidence.

Score

type score necesita instructions y criteria como un array ordenado de 2 a 10 niveles, el más bajo primero. La respuesta incluye score, legend, probabilities y confidence.

Respuesta

Un cuerpo correcto tiene model, answers con tus ids de pregunta, usage con input_tokens y output_tokens, y credits_used. model informa decisions-1 aunque envíes decisions-latest. Abajo hay una respuesta de ejemplo a la solicitud del inicio rápido, con usage omitido.

{
  "model": "decisions-1",
  "answers": {
    "sentiment": {
      "type": "choice",
      "choice": "mixed",
      "probabilities": { "mixed": 0.79, "negative": 0.2, "positive": 0.01 },
      "confidence": 0.61
    },
    "needs_follow_up": { "type": "noul", "noul": 0.83 }
  },
  "credits_used": 1
}

Cómo leer probabilidades y confidence

Noul es la probabilidad de que la afirmación en instructions sea cierta. Choice y Score devuelven una probabilidad por opción o nivel, más confidence.

El segundo es la señal para pasar a una persona. Cuando confidence es bajo o dos opciones están cerca, envía el caso a una persona o haz una pregunta más concreta. No bajes el umbral antes de mirar esos casos ajustados.

Límites

Decisions API de OpenAI: lo documentado hasta ahora

OpenAI anunció su Decisions API en el DevDay del 2026-09-29: un modelo GPT-6 Luna especializado que toma contexto de texto o imagen, una pregunta y una lista finita de respuestas, y devuelve una respuesta con confianza. Está en vista previa limitada.

OpenAI no ha publicado su esquema de petición, métodos SDK, límites ni precios. Todo lo de esta página documenta el endpoint de este sitio — no lo leas como documentación de OpenAI. Cuando OpenAI publique su referencia, los campos de arriba describen el mismo patrón: entra contexto, sale una de tus respuestas.

En qué se diferencia este endpoint de la OpenAI Decisions API

La Decisions API de OpenAI es un producto aparte en vista previa limitada y su esquema de petición y respuesta no está publicado. Este sitio sirve un endpoint independiente construido sobre el mismo patrón de decisión — un state, preguntas tipadas y respuestas con probabilidades por opción.

• Entrada: el anuncio de OpenAI describe contexto de texto o imagen; este endpoint solo acepta texto — una cadena, objeto JSON o array de texto de hasta 60.000 caracteres.
• Id de modelo: envía decisions-1 o decisions-latest. Un id versionado como decisions-1.0 devuelve 422.
• Respuestas: OpenAI describe una respuesta más una puntuación de confianza; este endpoint devuelve una respuesta por id de pregunta, con una probabilidad para cada opción o nivel.
• Disponibilidad: la Decisions API de OpenAI está en vista previa limitada; este endpoint se puede llamar hoy con una clave del panel.
• Facturación: 1 crédito por llamada correcta en este sitio, sea cual sea el recuento de tokens. OpenAI no ha publicado el precio de la Decisions API.

Errores

• 401 — clave ausente o rechazada.
• 402 — la clave es válida y el saldo no cubre la llamada. Un fallo upstream no usa un crédito.
• 422 — el cuerpo no pasó la validación. El mensaje nombra el campo.
• 429 — el servicio de decisión está limitado. Reintenta más tarde.
• 502 — el servicio no devolvió respuestas. No se usa un crédito.