OpenAI Decisions API vs Responses API

Wofür jede API gedacht ist

Die Responses API ist das allgemeine Arbeitstier: Text oder Bilder senden, generierten Text, schema-konformes JSON oder Tool-Aufrufe erhalten und die Konversation über Turns hinweg fortsetzen. Sie ist der Endpunkt, wenn das Modell etwas Neues produzieren muss.

Die Decisions API ist bewusst enger. Sie senden Kontext plus eine Frage mit einer endlichen Menge von Antworten, die Sie definieren, und sie gibt eine dieser Antworten zurück — mit einer Wahrscheinlichkeit pro Option und einer Konfidenz, laut OpenAIs Ankündigung. Stand 2026-09-30 ist sie in begrenzter Vorschau, eine breite Veröffentlichung wurde für die kommenden Tage angekündigt. Der Endpunkt auf dieser Website führt dasselbe Muster endlicher Antworten heute mit decisions-1 aus.

Seite an Seite

Eine Entscheidung mit der Responses API heute

Mit der Responses API können Sie eine Entscheidung schon heute annähern: Beschränken Sie die Ausgabe mit einem JSON-Schema und einem Enum. Sie erhalten ein gültiges Label — aber keine Wahrscheinlichkeiten pro Option für die unterlegenen.

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

Dieselbe Aufgabe als Entscheidungsanfrage

Als choice-Frage auf dem Endpunkt dieser Website liefert dieselbe Routing-Aufgabe das Gewinner-Label, eine Wahrscheinlichkeit für jede Option und eine Konfidenz — die Eingaben, die Sie brauchen, um klare Fälle automatisch zu routen und knappe zu eskalieren.

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

Wann welche verwenden

Nutzen Sie die Responses API, wenn das Modell Inhalte produzieren muss: die Antwort entwerfen, die Zusammenfassung schreiben, das Tool aufrufen. Nutzen Sie eine Decisions-API, wenn das Modell wählen muss — welche Warteschlange, welcher Zweig, welche nächste Aktion — und wenn Sie die Verteilung brauchen, um zu entscheiden, ob Sie der Wahl trauen.

Sie lassen sich gut kombinieren: Ein Entscheidungsaufruf wählt den Zweig, dann schreibt ein Responses-API-Aufruf die Antwort für diesen Zweig. Wählen und Schreiben sind unterschiedliche Aufgaben.

FAQ