OpenAI Decisions API vs Responses API

À quoi sert chaque API

La Responses API est l'outil polyvalent : envoyez du texte ou des images, recevez du texte généré, du JSON conforme au schéma ou des appels d'outils, et poursuivez la conversation sur plusieurs tours. C'est l'endpoint à utiliser quand le modèle doit produire quelque chose de nouveau.

La Decisions API est plus étroite par conception. Vous envoyez un contexte plus une question avec un ensemble fini de réponses que vous définissez, et elle retourne l'une de ces réponses — avec une probabilité par option et une confiance, selon l'annonce d'OpenAI. Elle est en preview limitée au 2026-09-30, une disponibilité large étant annoncée pour les prochains jours. L'endpoint de ce site exécute aujourd'hui le même schéma de réponse finie avec decisions-1.

Côte à côte

Une décision avec la Responses API aujourd'hui

Vous pouvez déjà approcher une décision avec la Responses API : contraignez la sortie avec un schéma JSON et un enum. Vous récupérez une étiquette valide — mais aucune probabilité par option pour les perdantes.

// 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 même tâche en requête de décision

Exprimée comme question choice sur l'endpoint de ce site, la même tâche de routage retourne l'étiquette gagnante, une probabilité pour chaque option et une confiance — ce qu'il faut pour router automatiquement les cas clairs et escalader les cas serrés.

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

Quand utiliser laquelle

Utilisez la Responses API quand le modèle doit produire du contenu : rédiger la réponse, écrire le résumé, appeler l'outil. Utilisez une API de décision quand le modèle doit choisir — quelle file, quelle branche, quelle action suivante — et quand vous avez besoin de la distribution pour décider si vous pouvez lui faire confiance.

Elles se composent bien : un appel de décision choisit la branche, puis un appel Responses API rédige la réponse pour cette branche. Choisir et rédiger sont deux métiers différents.

FAQ