OpenAI Decisions API Dokumentation

Endpoint

Senden Sie POST /api/v1/decisions an diesen Host. Es gibt keinen chat-completions-Pfad und kein Streaming. GET /api/v1/models listet die Modell-ID.

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

Authentifizierung

Setzen Sie den Dashboard-Schlüssel in Authorization: Bearer. Ein fehlender oder abgelehnter Schlüssel ergibt 401. Der Playground legt beim Ausführen einen Schlüssel für das Konto an.

Schnellstart

Setze DECISIONS_API_KEY auf einen Schlüssel aus deinem Dashboard und sende den Request unten. Neue Besucher erhalten 1 kostenloser Call — genug für 1 erfolgreichen Requests.

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?"
    }
  }
}'

Mit KI-Coding-Tools verwenden

Kopieren Sie einen Prompt mit dem vollständigen Anfragevertrag und fügen Sie ihn zusammen mit Ihrer Aufgabe in Cursor, Claude Code oder ChatGPT ein. Dieselbe Referenz liegt unter /llms.txt.

Anfrage-Body

model ist decisions-1 oder decisions-latest. state ist ein String, JSON-Objekt oder Textarray, bis 60.000 Zeichen. questions ist eine Map von 1 bis 6 snake_case-IDs. Die ID ist nur das Label, unter dem Ihre Antwort zurückkommt, keine Frage. Die echte Frage steht in instructions als Text von 1 bis 2.000 Zeichen.

{
  "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?"
    }
  }
}

Fragetypen

Noul

type noul braucht nur instructions. Das Feld noul ist die Wahrscheinlichkeit von 0 bis 1, dass die Aussage wahr ist. Es gibt kein separates confidence-Feld. Senden Sie criteria bei einer noul-Frage, ignoriert dieser Endpoint es.

Choice

type choice braucht instructions und criteria: ein Objekt von 2 bis 8 snake_case-IDs, jeweils mit einer Beschreibung von bis zu 300 Zeichen. Die Antwort enthält choice, probabilities jeder Option und confidence.

Score

type score braucht instructions und criteria als geordnetes Array von 2 bis 10 Stufen, die niedrigste zuerst. Die Antwort enthält score, legend, probabilities und confidence.

Antwort

Ein erfolgreicher Body hat model, answers unter Ihren Frage-IDs, usage mit input_tokens und output_tokens, und credits_used. model meldet decisions-1, auch wenn Sie decisions-latest gesendet haben. Unten eine Beispielantwort auf die Schnellstart-Anfrage, usage ausgelassen.

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

Wahrscheinlichkeiten und confidence lesen

Noul ist die Wahrscheinlichkeit, dass die Aussage in instructions wahr ist. Choice und Score liefern eine Wahrscheinlichkeit je Option oder Stufe, plus confidence.

Der Zweite ist das Signal zur Übergabe. Wenn confidence niedrig ist oder zwei Optionen nah beieinander liegen, geben Sie den Fall an eine Person oder stellen Sie eine genauere Frage. Senken Sie den Cutoff nicht, bevor Sie diese knappen Fälle gesehen haben.

Limits

OpenAI Decisions API: Was bisher dokumentiert ist

OpenAI hat seine Decisions API am DevDay 2026-09-29 angekündigt: ein spezialisiertes GPT-6-Luna-Modell, das Text- oder Bildkontext, eine Frage und eine endliche Antwortliste entgegennimmt und eine Antwort mit Konfidenz zurückgibt. Es befindet sich in eingeschränkter Vorschau.

OpenAI hat weder Request-Schema, SDK-Methoden, Rate-Limits noch Preise veröffentlicht. Alles auf dieser Seite dokumentiert den Endpoint dieser Seite — bitte nicht als OpenAI-Dokumentation lesen. Wenn OpenAIs Referenz erscheint, beschreiben die Felder oben dasselbe Entscheidungsmuster: Kontext rein, eine deiner Antworten raus.

Wie sich dieser Endpoint von der OpenAI Decisions API unterscheidet

OpenAIs Decisions API ist ein separates Produkt in eingeschränkter Vorschau; Request- und Response-Schema sind nicht veröffentlicht. Diese Seite liefert einen unabhängigen Endpoint auf demselben Entscheidungsmuster — ein state, typisierte Fragen und Antworten mit Wahrscheinlichkeiten pro Option.

• Eingabe: OpenAIs Ankündigung beschreibt Text- oder Bildkontext; dieser Endpoint nimmt nur Text — einen String, ein JSON-Objekt oder ein Text-Array bis 60.000 Zeichen.
• Modell-ID: sende decisions-1 oder decisions-latest. Eine versionierte ID wie decisions-1.0 liefert 422.
• Antworten: OpenAI beschreibt eine Antwort plus Konfidenzwert; dieser Endpoint liefert eine Antwort pro Frage-ID, mit einer Wahrscheinlichkeit für jede Option oder Stufe.
• Verfügbarkeit: OpenAIs Decisions API ist in eingeschränkter Vorschau; dieser Endpoint ist heute mit einem Schlüssel aus dem Dashboard aufrufbar.
• Abrechnung: 1 Credit pro erfolgreichem Call auf dieser Seite, unabhängig von der Token-Anzahl. OpenAI hat keine Preise für die Decisions API veröffentlicht.

Fehler

• 401 — fehlender oder abgelehnter API-Schlüssel.
• 402 — der Schlüssel ist gültig, das Guthaben reicht nicht. Ein Upstream-Fehler verbraucht kein Credit.
• 422 — der Body hat die Prüfung nicht bestanden. Die Meldung nennt das Feld.
• 429 — der Entscheidungsdienst ist begrenzt. Später erneut versuchen.
• 502 — der Dienst hat keine Antworten geliefert. Es wird kein Credit verwendet.