構造化アウトプットとは何ですか?

構造化出力は、フリーテキストではなくコードが解析可能なJSONを言語モデルに返します。JSONモードでは構文的に有効なJSONオブジェクトを返し、さらにJSONスキーマは、レスポンスを定義したスキーマと必須のフィールドや型に一致させるという進化をさらに進めます。

基本概念

構造化されたアウトプットが重要な理由

アプリケーションはしばしば、請求書から抽出されたフィールド、サポートチケットのラベル、計画の手順、保存すべきレコードなど、データとしてモデルの回答を必要とします。プロンプトで JSON を求めるのであれば、ほとんどの場合はうまくいきますが、JSON の前に説明を添えたり、その周りにコードのフェンスを設けたり、欠落したフィールドや文字列として書かれた数字を表示したりする自由テキストが届くこともあります。これらはそれぞれパーサーを壊します。

構造化出力は生成自体を制約します。応答は有効なJSONであり、スキーマがあればあなたが求めていた形状もまさに存在します。

JSONモードとJSONスキーマ

レベルは2つあり、どちらも次のように設定されています。 response_format:

  • JSONモード。 {"type": "json_object"} モデルに有効な JSON オブジェクトを返します。プロンプトで指定したいフィールドを指定し、図形は強制されません。
  • JSON スキーマ。 {"type": "json_schema", "json_schema": {...}}} 要する 名称、a スキーマ および 厳格、そして出力がその JSON スキーマに準拠するようにします:必須フィールドが存在し、型が正しく、設定しても追加のキーがありません additionalProperties から 偽りお問い合わせ.

モデルが対応している JSON スキーマを使用し、コードが正確なフィールドに依存している場合にしてください。コードが読み取るすべてのフィールドを必須としてマークし、 enum(列挙) 固定選択の場合は、入れ子を浅く保ち、ショートを追加しましょう 説明 名前からは意味が明らかでないあらゆる分野へ。

請求書エクストラクターの場合、スキーマには ベンダー 弦として、 合計 数値として、 通貨 として enum(列挙) あなたが受け入れるコードの中、 line_items オブジェクトの配列として 説明 および 金額.とともに 厳格 設定 確かに各レスポンスにはその型のフィールドが格納されるため、コードは毎回同じキーを読み取る。JSON モードでは、代わりに短いサンプルオブジェクトをプロンプトに配置し、モデルに従うべき形を持たせます。

モデルおよびエンドポイントごとのサポート

サポートはモデルごとに設定されます。その structured_output フィールドオン 早く/v1/models/{model} 読む json_schema モデルがスキーマをサポートしている場合 json_object JSON モードのみをサポートし、このページのモデルがそれぞれのレベルを示す場合。モデルがサポートしない形式を送信すると返されます 400お問い合わせ.

同じ機能は、各テキスト端点の独自の形状で動作します:

  • /v1/chat/completions および /v1/completions: response_formatお問い合わせ.
  • お問い合わせ: text.formatお問い合わせ.
  • お問い合わせ: output_config.フォーマット、または response_format リクエストの他の部分の隣に。

では Playground、それをサポートするチャットモデルには、Off、JSON モード、JSON スキーマコントロールがあり、スキーマ用のボックスがあります。その 互換性ガイド 完全なリクエスト例があります。

実践的な指針

  • それでも認めておきましょう。 コード内のすべての応答を解析し、チェックします。出力制限によってカットされた応答は次のように報告されます。 finish_reason 長さ、は不完全なJSONなので設定 max_tokens 予想する最大の物体には十分な高さです。
  • 推論モデルを確認しましょう。 一部のモデルでは、次のようなリクエストがあります。 response_format 理由を使わずに答える、ただしそれが設定しない限り enable thinking を使うお問い合わせ.
  • サポートのないモデル。 プロンプトで JSON を入力するよう求め、図形の例を含めて結果を検証します。
  • 適切な機能を選択してください。 JSON が最終的な答えとなる場合は構造化出力を使用してください。利用 関数呼び出し モデルがコードを実行するアクションを選択するタイミング。

閲覧 テキストモデル 各レベルをサポートしているものを比較するために。

モデル別の構造化出力への対応

62 個のモデル。各モデルのページに料金表、パラメーター、コードがあります。

モデル構造化出力コンテキスト長
DeepSeek V4 Pro DeepSeekJSON Schema1M トークン
DeepSeek V4 Pro 0813 DeepSeekJSON Schema1M トークン
Fugu Max Sakana AIJSON Schema1M トークン
Fugu Ultra v1.1 Sakana AIJSON Schema1M トークン
Fugu Ultra v2.0 Sakana AIJSON Schema1M トークン
Gemma 4 26B-A4B GoogleJSON Schema256K トークン
Kimi K2.6 Moonshot AIJSON Schema256K トークン
Kimi K2.7 Code Moonshot AIJSON Schema256K トークン
62 個のモデルをすべて表示
モデル構造化出力コンテキスト長
Kimi K2.7 Code Highspeed Moonshot AIJSON Schema256K トークン
Kimi K3 Moonshot AIJSON Schema1M トークン
Kimi K3.1 Pro Moonshot AIJSON Schema1M トークン
MiMo V2.6 Flash XiaomiJSON Schema1M トークン
MiMo V2.6 Pro XiaomiJSON Schema1M トークン
MiMo V2.6 Pro UltraSpeed XiaomiJSON Schema1M トークン
Mistral Small 3.1 Mistral AIJSON Schema89.6K トークン
Muse Glimmer 30B Meta AIJSON Schema128K トークン
Muse Spark 1.1 Meta AIJSON Schema1M トークン
Muse Spark 1.2 Meta AIJSON Schema1M トークン
Muse Spark 1.3 Meta AIJSON Schema1M トークン
Qwen3.5 4B Alibaba CloudJSON Schema256K トークン
Qwen3.5 9B Alibaba CloudJSON Schema256K トークン
Qwen3.5 Omni Plus Alibaba CloudJSON Schema192K トークン
Qwen3.6 35B A3B Alibaba CloudJSON Schema128K トークン
Qwen3.7 Flash Alibaba CloudJSON Schema983.6K トークン
Qwen3.7 Max Alibaba CloudJSON Schema983.6K トークン
Qwen3.7 Plus Alibaba CloudJSON Schema983.6K トークン
Qwen3.8 27B Alibaba CloudJSON Schema256K トークン
Qwen3.8 Flash Alibaba CloudJSON Schema983.6K トークン
Qwen3.8 Max Alibaba CloudJSON Schema983.6K トークン
Qwen3.8 Max 0902 Alibaba CloudJSON Schema983.6K トークン
Qwen3.8 Omni Flash Alibaba CloudJSON Schema1.01M トークン
Qwen4 Max Alibaba CloudJSON Schema983.6K トークン
Seed 2.0 Lite ByteDanceJSON Schema229.1K トークン
Seed 2.0 Mini ByteDanceJSON Schema229.2K トークン
Seed 2.0 Pro ByteDanceJSON Schema229.1K トークン
Seed 2.1 Turbo ByteDanceJSON Schema229.1K トークン
Step 5 Preview StepFunJSON Schema1.02M トークン
DeepSeek V4 Flash 0731 DeepSeekJSON モード1M トークン
DeepSeek V4.1 Flash 1017 DeepSeekJSON モード1M トークン
Fugu Ultra v1.0 Sakana AIJSON モード1M トークン
GLM 4.5 Flash Z.aiJSON モード128K トークン
GLM 4.6V Flash Z.aiJSON モード128K トークン
GLM 4.6V FlashX Z.aiJSON モード128K トークン
GLM 4.7 Flash Z.aiJSON モード202.8K トークン
GLM 4.7 FlashX Z.aiJSON モード202.8K トークン
GLM 5.1 Z.aiJSON モード202.7K トークン
GLM 5.2 Z.aiJSON モード1M トークン
GLM 5.3 Z.aiJSON モード1M トークン
GLM 5.3 Flash Z.aiJSON モード1M トークン
Mistral Small 4 Mistral AIJSON モード256K トークン
Qwen3.5 122B-A10B Alibaba CloudJSON モード258K トークン
Qwen3.5 27B Alibaba CloudJSON モード258K トークン
Qwen3.5 35B-A3B Alibaba CloudJSON モード258K トークン
Qwen3.5 397B-A17B Alibaba CloudJSON モード258K トークン
Qwen3.5 Flash Alibaba CloudJSON モード995.9K トークン
Qwen3.5 Plus Alibaba CloudJSON モード983.6K トークン
Qwen3.6 27B Alibaba CloudJSON モード224K トークン
Qwen3.6 Flash Alibaba CloudJSON モード983.6K トークン
Qwen3.6 Plus Alibaba CloudJSON モード983.6K トークン
Step 3.7 Flash StepFunJSON モード256K トークン
StepAudio 2.5 Chat StepFunJSON モード256K トークン
StepAudio 3 Chat StepFunJSON モード256K トークン

よくある質問

JSON モードと JSON スキーマの違いは何ですか?

JSON モードは有効な JSON オブジェクトを返しますが、その形状はプロンプトに従って残されます。JSON スキーマは、必須フィールドや型を含め、指定したスキーマに応答を一致させます。

どのモデルが構造化アウトプットをサポートしていますか?

サポートはモデルごとに異なります。各モデルのstructured_outputフィールドには、スキーマサポートの場合はjson_schema、JSON モードのみの場合は json_object と表示され、サポートされていない形式のリクエストは 400 エラーを返します。

それでもJSONを検証する必要がありますか?

はい。応答は出力制限によって切り離されることがあり、アプリケーションにはスキーマでは表現できないルールが存在する場合もあるため、すべての応答を解析し検証してください。

Responses または Messages エンドポイントで構造化出力を使うことはできますか?

はい。Responses エンドポイントは text.format を使用し、Messages エンドポイントは output_config.format または response_format フィールドを受け付けます。

より良いエンドポイントを使う準備はできていますか?

ご自身のモデルを当社のスタックに展開したい方は、ぜひご価格をご覧ください。