OpenAI Decisions API vs Structured Outputs

La vraie différence

Structured Outputs contraint la forme de la réponse — le modèle doit produire un JSON conforme à votre schéma. Si vous lui demandez une étiquette dans ce schéma, vous obtenez une étiquette, et rien sur les perdantes.

Un appel de décision contraint la sémantique — le modèle choisit une de vos réponses finies et renvoie une probabilité pour chaque option plus une valeur de confiance. L'option en deuxième place et sa probabilité sont tout l'intérêt : elles disent s'il faut agir automatiquement ou escalader à un humain.

Côte à côte

Structured Outputs vous donne un champ enum analysable. L'endpoint de décision vous donne le même enum plus la distribution derrière.

// Structured Outputs: the model fills a JSON schema.
// You get a parseable label — not a probability per option.
{
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "route",
      "schema": {
        "type": "object",
        "properties": {
          "team": { "enum": ["payments", "frontend", "account"] }
        }
      }
    }
  }
}

La version décision

La même tâche de routage, exprimée en question choice. La réponse porte le gagnant, les probabilités par option et une confiance — de quoi router automatiquement à 0,8 et escalader en dessous.

// Decision endpoint: the answer carries a probability
// for every option plus a confidence — enough to set a threshold.
{
  "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."
      }
    }
  }
}

Quand utiliser lequel

Utilisez Structured Outputs quand le modèle doit produire des données — extraction, remplissage de formulaires, réponses multi-champs où chaque champ compte. Utilisez un endpoint de décision quand le travail du modèle est de choisir une branche et que vous devez savoir si le choix était serré.

Ils se composent proprement : un appel de décision choisit la route, puis une génération structurée produit la charge pour cette route.

FAQ