比較
OpenAI Decisions API vs Structured Outputs
Structured Outputs はモデルにスキーマ準拠の JSON を出力させます。OpenAI Decisions API の背後にあるデシジョンパターン——そしてこのサイトの decisions-1 エンドポイント——がやることは別です:有限の回答集合から1つを選び、それぞれへの確信度を返します。同じ領域でも、道具は違います。
更新日
実際の違い
Structured Outputs が制約するのはレスポンスの形——モデルはスキーマに合う JSON を出さなければなりません。そのスキーマ内でラベルを求めればラベルは返りますが、次点については何も分かりません。
デシジョン呼び出しが制約するのは意味——モデルは有限の回答から 1 つを選び、全選択肢の確率と確信度を返します。2 位の選択肢とその確率が本質です:自動実行するか人にエスカレーションするかを教えてくれます。
並べて見る
Structured Outputs はパース可能な enum フィールドをくれます。デシジョンエンドポイントは同じ enum にその背後の分布を加えて返します。
Structured Outputs
// 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"] }
}
}
}
}
}デシジョン版
同じルーティングタスクを choice 質問として表現。レスポンスは勝者、選択肢ごとの確率、確信度を持ちます——0.8 以上で自動ルーティング、未満でエスカレーションするのに十分です。
デシジョンリクエスト
// 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."
}
}
}
}どちらを使うか
モデルにデータを产出させたいときは Structured Outputs——抽出、フォーム入力、すべてのフィールドが重要な複数フィールドの応答。モデルの仕事が 1 つの分岐を選ぶことで、その選択がどれだけ僅差だったかを知りたいときはデシジョンエンドポイント。
両者はきれいに組み合わせられます:デシジョン呼び出しがルートを選び、構造化生成がそのルートのペイロードを产出します。
よくある質問
Structured Outputs で確信度スコアは取れますか?
確実には——confidence フィールドを出力させることはできますが、それは生成された数字で、選択肢ごとに計算された確率ではありません。デシジョンエンドポイントは実際の選択肢ごとの確率を返します。
どちらが安いですか?
このエンドポイントではデシジョン呼び出しは質問数に関係なく 1 クレジットです(1〜6 問)。Structured Outputs 呼び出しのコストはプロバイダのトークン価格次第です——自分のワークロードで比較してください。
OpenAI の Decisions API は Structured Outputs を置き換えますか?
必要としているものが違います。Structured Outputs はレスポンスの形を制御し、decisions API は確率つきの制約回答を返します。2026-09-29 の発表によれば OpenAI 版も確率を返します——この違いは残ります。
確率を自分の目で確認
新規訪問者に 2 回の無料トライアルデシジョン——choice 質問を実行して分布を読んでください。