OpenAI Decisions API ドキュメント

エンドポイント

このホストへ POST /api/v1/decisions を送ります。chat-completions もストリームもありません。GET /api/v1/models がモデル id を返します。

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

認証

ダッシュボードのキーを Authorization: Bearer に置きます。無い、または拒否されたキーは 401 です。プレイグラウンドは実行時にログイン中のアカウント用キーを作れます。

クイックスタート

DECISIONS_API_KEY にダッシュボードのキーを設定し、下のリクエストを送ります。新規訪問者は 1 回の無料呼び出しがあり、成功した 1 リクエスト分に足ります。

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

AI コーディングツールで使う

リクエスト仕様をすべて含むプロンプトをコピーし、やりたいタスクと一緒に Cursor、Claude Code、ChatGPT に貼り付けます。同じリファレンスは /llms.txt にあります。

リクエスト本文

model は decisions-1 か decisions-latest。state は文字列、JSON オブジェクト、テキスト配列で 60,000 文字まで。questions は 1 から 6 個の snake_case id のマップです。id は答えが戻るラベルで、質問ではありません。質問文は instructions に 1 から 2,000 文字のテキストで書きます。

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

質問の型

Noul

type noul は instructions だけです。答えの noul は、その文が真である確率で 0 から 1 です。別の confidence フィールドはありません。noul の質問に criteria を送っても、このエンドポイントは無視します。

Choice

type choice は instructions と criteria が必要です。2 から 8 個の snake_case の選択肢 id と、それぞれ最大 300 文字の説明です。答えには choice、各選択肢の probabilities、confidence があります。

Score

type score は instructions と、低い順に並べた 2 から 10 個の段階説明が必要です。答えには score、段階の legend、確率、confidence があります。

応答

成功時の本文には model、質問 id をキーにした answers、input_tokens と output_tokens を持つ usage、credits_used があります。decisions-latest を送っても model は decisions-1 を報告します。以下はクイックスタートのリクエストへの応答例で、usage は省略しています。

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

確率と confidence の読み方

Noul は instructions の文が真である確率です。Choice と Score は各選択肢・段階の確率に加えて confidence を返します。

次点は人手へ渡す合図です。confidence が低い、または二つの選択肢が近いときは、その件を人へ渡すか、より具体的な質問を一つ足します。近い結果を見る前にしきい値を下げないでください。

制限

OpenAI Decisions API：これまでに公開された情報

OpenAI は 2026-09-29 の DevDay で Decisions API を発表しました。GPT-6 Luna の特別版がテキストまたは画像のコンテキスト、質問、有限の回答リストを受け取り、信頼度付きの回答を返します。現在は限定プレビューです。

OpenAI はリクエストスキーマ、SDK メソッド、レート制限、料金をまだ公開していません。このページのすべてはこのサイトのエンドポイントを説明するものであり、OpenAI のドキュメントとして読まないでください。OpenAI のリファレンスが公開されても、上のフィールドが説明するのは同じデシジョンパターンです：コンテキストを入れて、あなたの回答の 1 つが返る。

このエンドポイントと OpenAI Decisions API の違い

OpenAI の Decisions API は限定プレビューの別製品で、リクエスト・レスポンスのスキーマは未公開です。このサイトは同じデシジョンパターンで構築された独立したエンドポイントを提供します——state、型付き質問、選択肢ごとの確率を持つ回答。

• 入力:OpenAI の発表ではテキストまたは画像のコンテキスト。このエンドポイントはテキストのみ——文字列、JSON オブジェクト、テキスト配列で最大 60,000 文字。
• モデル ID:decisions-1 または decisions-latest を送信。decisions-1.0 のようなバージョン付き ID は 422 を返します。
• 回答:OpenAI の説明では回答 1 つに信頼度スコア。このエンドポイントは質問 ID ごとに回答を返し、すべての選択肢・段階に確率を付けます。
• 提供状況:OpenAI の Decisions API は限定プレビュー。このエンドポイントはダッシュボードのキーで今日から呼べます。
• 課金:このサイトでは成功した呼び出し 1 回につき 1 クレジット(トークン数不問)。OpenAI は Decisions API の料金を公開していません。

エラー

• 401 — API キーが無い、または拒否された。
• 402 — キーは有効だが残高が足りない。上流の失敗ではクレジットを使いません。
• 422 — 本文の検証失敗。メッセージが項目を示します。
• 429 — 判断サービスがレート制限中です。後で再試行してください。
• 502 — 判断サービスが答えを返しませんでした。クレジットは使いません。