JSON モードが答えてくれる問いは 1 つだけです。json.loads() は成功するか。2 つ目の問い、つまり「これはコードが期待しているオブジェクトか」には答えません。
しくみ
Chat Completions API では、1 つのフィールドで有効にします。
{"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Return JSON with keys name and email."},
{"role": "user", "content": "Reach me at Sara, sara@example.com"}]}
OpenAI の API リファレンスはこれを「the older JSON mode, which ensures the message the model generates is valid JSON.」(訳:モデルが生成するメッセージが有効な JSON であることを保証する、旧来の JSON モード)と呼んでいます。ルールは 2 つあります。まず、メッセージで JSON を求めなければなりません。OpenAI のガイドによると、API は「will throw an error if the string ‘JSON’ does not appear somewhere in the context.」(訳:コンテキストのどこにも文字列 ‘JSON’ がなければエラーを投げる)とのことです。次に、形はモデル任せです。ガイドには、JSON モードは「will not guarantee the output matches any specific schema.」(訳:出力が特定のスキーマに一致することは保証しない)と書かれています。
構造化出力はより厳格な選択肢です。{"type": "json_schema", ...} で JSON Schema を渡し、モデルの出力はそれに制約されます。
JSON モード(json_object) |
構造化出力(json_schema) |
|
|---|---|---|
| 有効な JSON | はい | はい |
| 必須キーと型 | いいえ | はい |
| スキーマを渡す | いいえ | はい |
| プロンプトに「JSON」が必須 | はい(OpenAI) | いいえ |
OpenAI は「always using Structured Outputs instead of JSON mode when possible.」(訳:可能な限り、JSON モードではなく常に Structured Outputs を使う)よう勧めています。
なぜ重要か
- 検証は引き続き自分で行う。 JSON モードでは、キーが欠けていても、数値が文字列で返ってきても問題なくパースでき、後になって失敗します。コード側でスキーマに照らして検証してください。
- 途中切れ。 応答が
max_tokensに達すると JSON は不完全になります。推論モデルは思考にも同じ予算を使うため、より影響を受けやすくなります。 - 代替手段。 OpenAI のガイドは、
json_schemaが使えない古いモデル向けに JSON モードを挙げています。対応状況はプロバイダーやモデルによって異なるので、スキーマが受け付けられない場合は、JSON モードと自前の検証の組み合わせが代替手段になります。
BroadNet Inference の場合
BroadNet の API リファレンスでは、GLM 5.3 と Qwen3.8 27B に構造化出力が記載されています。ただし、対応する response_format が json_object と json_schema のどちらなのか、また DeepSeek V4.1 Flash と BroadNet Gemma 4 VL 26B がどちらかを受け付けるのかは書かれていません。お使いのモデルで両方を試してください。スキーマの作成には JSON Schema ジェネレーターを使えます。JSON mode と json_schema の記事では修復と監視を、請求書ガイドでは画像からの JSON 抽出を紹介しています。