構造化出力は、フリーテキストではなくコードが解析可能なJSONを言語モデルに返します。JSONモードでは構文的に有効なJSONオブジェクトを返し、さらにJSONスキーマは、レスポンスを定義したスキーマと必須のフィールドや型に一致させるという進化をさらに進めます。
アプリケーションはしばしば、請求書から抽出されたフィールド、サポートチケットのラベル、計画の手順、保存すべきレコードなど、データとしてモデルの回答を必要とします。プロンプトで JSON を求めるのであれば、ほとんどの場合はうまくいきますが、JSON の前に説明を添えたり、その周りにコードのフェンスを設けたり、欠落したフィールドや文字列として書かれた数字を表示したりする自由テキストが届くこともあります。これらはそれぞれパーサーを壊します。
構造化出力は生成自体を制約します。応答は有効なJSONであり、スキーマがあればあなたが求めていた形状もまさに存在します。
レベルは2つあり、どちらも次のように設定されています。 response_format:
{"type": "json_object"} モデルに有効な 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 を使うお問い合わせ.閲覧 テキストモデル 各レベルをサポートしているものを比較するために。
62 個のモデル。各モデルのページに料金表、パラメーター、コードがあります。
| モデル | 構造化出力 | コンテキスト長 |
|---|---|---|
| DeepSeek V4 Pro DeepSeek | JSON Schema | 1M トークン |
| DeepSeek V4 Pro 0813 DeepSeek | JSON Schema | 1M トークン |
| Fugu Max Sakana AI | JSON Schema | 1M トークン |
| Fugu Ultra v1.1 Sakana AI | JSON Schema | 1M トークン |
| Fugu Ultra v2.0 Sakana AI | JSON Schema | 1M トークン |
| Gemma 4 26B-A4B Google | JSON Schema | 256K トークン |
| Kimi K2.6 Moonshot AI | JSON Schema | 256K トークン |
| Kimi K2.7 Code Moonshot AI | JSON Schema | 256K トークン |
| モデル | 構造化出力 | コンテキスト長 |
|---|---|---|
| Kimi K2.7 Code Highspeed Moonshot AI | JSON Schema | 256K トークン |
| Kimi K3 Moonshot AI | JSON Schema | 1M トークン |
| Kimi K3.1 Pro Moonshot AI | JSON Schema | 1M トークン |
| MiMo V2.6 Flash Xiaomi | JSON Schema | 1M トークン |
| MiMo V2.6 Pro Xiaomi | JSON Schema | 1M トークン |
| MiMo V2.6 Pro UltraSpeed Xiaomi | JSON Schema | 1M トークン |
| Mistral Small 3.1 Mistral AI | JSON Schema | 89.6K トークン |
| Muse Glimmer 30B Meta AI | JSON Schema | 128K トークン |
| Muse Spark 1.1 Meta AI | JSON Schema | 1M トークン |
| Muse Spark 1.2 Meta AI | JSON Schema | 1M トークン |
| Muse Spark 1.3 Meta AI | JSON Schema | 1M トークン |
| Qwen3.5 4B Alibaba Cloud | JSON Schema | 256K トークン |
| Qwen3.5 9B Alibaba Cloud | JSON Schema | 256K トークン |
| Qwen3.5 Omni Plus Alibaba Cloud | JSON Schema | 192K トークン |
| Qwen3.6 35B A3B Alibaba Cloud | JSON Schema | 128K トークン |
| Qwen3.7 Flash Alibaba Cloud | JSON Schema | 983.6K トークン |
| Qwen3.7 Max Alibaba Cloud | JSON Schema | 983.6K トークン |
| Qwen3.7 Plus Alibaba Cloud | JSON Schema | 983.6K トークン |
| Qwen3.8 27B Alibaba Cloud | JSON Schema | 256K トークン |
| Qwen3.8 Flash Alibaba Cloud | JSON Schema | 983.6K トークン |
| Qwen3.8 Max Alibaba Cloud | JSON Schema | 983.6K トークン |
| Qwen3.8 Max 0902 Alibaba Cloud | JSON Schema | 983.6K トークン |
| Qwen3.8 Omni Flash Alibaba Cloud | JSON Schema | 1.01M トークン |
| Qwen4 Max Alibaba Cloud | JSON Schema | 983.6K トークン |
| Seed 2.0 Lite ByteDance | JSON Schema | 229.1K トークン |
| Seed 2.0 Mini ByteDance | JSON Schema | 229.2K トークン |
| Seed 2.0 Pro ByteDance | JSON Schema | 229.1K トークン |
| Seed 2.1 Turbo ByteDance | JSON Schema | 229.1K トークン |
| Step 5 Preview StepFun | JSON Schema | 1.02M トークン |
| DeepSeek V4 Flash 0731 DeepSeek | JSON モード | 1M トークン |
| DeepSeek V4.1 Flash 1017 DeepSeek | JSON モード | 1M トークン |
| Fugu Ultra v1.0 Sakana AI | JSON モード | 1M トークン |
| GLM 4.5 Flash Z.ai | JSON モード | 128K トークン |
| GLM 4.6V Flash Z.ai | JSON モード | 128K トークン |
| GLM 4.6V FlashX Z.ai | JSON モード | 128K トークン |
| GLM 4.7 Flash Z.ai | JSON モード | 202.8K トークン |
| GLM 4.7 FlashX Z.ai | JSON モード | 202.8K トークン |
| GLM 5.1 Z.ai | JSON モード | 202.7K トークン |
| GLM 5.2 Z.ai | JSON モード | 1M トークン |
| GLM 5.3 Z.ai | JSON モード | 1M トークン |
| GLM 5.3 Flash Z.ai | JSON モード | 1M トークン |
| Mistral Small 4 Mistral AI | JSON モード | 256K トークン |
| Qwen3.5 122B-A10B Alibaba Cloud | JSON モード | 258K トークン |
| Qwen3.5 27B Alibaba Cloud | JSON モード | 258K トークン |
| Qwen3.5 35B-A3B Alibaba Cloud | JSON モード | 258K トークン |
| Qwen3.5 397B-A17B Alibaba Cloud | JSON モード | 258K トークン |
| Qwen3.5 Flash Alibaba Cloud | JSON モード | 995.9K トークン |
| Qwen3.5 Plus Alibaba Cloud | JSON モード | 983.6K トークン |
| Qwen3.6 27B Alibaba Cloud | JSON モード | 224K トークン |
| Qwen3.6 Flash Alibaba Cloud | JSON モード | 983.6K トークン |
| Qwen3.6 Plus Alibaba Cloud | JSON モード | 983.6K トークン |
| Step 3.7 Flash StepFun | JSON モード | 256K トークン |
| StepAudio 2.5 Chat StepFun | JSON モード | 256K トークン |
| StepAudio 3 Chat StepFun | JSON モード | 256K トークン |
JSON モードは有効な JSON オブジェクトを返しますが、その形状はプロンプトに従って残されます。JSON スキーマは、必須フィールドや型を含め、指定したスキーマに応答を一致させます。
サポートはモデルごとに異なります。各モデルのstructured_outputフィールドには、スキーマサポートの場合はjson_schema、JSON モードのみの場合は json_object と表示され、サポートされていない形式のリクエストは 400 エラーを返します。
はい。応答は出力制限によって切り離されることがあり、アプリケーションにはスキーマでは表現できないルールが存在する場合もあるため、すべての応答を解析し検証してください。
はい。Responses エンドポイントは text.format を使用し、Messages エンドポイントは output_config.format または response_format フィールドを受け付けます。