BroadRouter
始める

JSON モード(JSON mode)

更新日

JSON モード(JSON mode)とは、OpenAI 形式の API で response_format {"type": "json_object"} と指定する設定で、モデルの応答を有効でパース可能な JSON にします。JSON Schema を使う構造化出力と違い、どのキー、型、値が入るかは保証しません。

別名: JSON出力モード、json_object モード、JSON 形式で出力、json_object、JSON output mode、JSON response mode

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 抽出を紹介しています。

よくある質問

JSON モードと構造化出力は同じものですか?

いいえ。OpenAI のガイドによると、どちらも有効な JSON を生成しますが、スキーマへの準拠を保証するのは Structured Outputs だけです。JSON モードはどんな有効なオブジェクトでも返しえます。

JSON モードで「JSON」という単語に関するエラーが出るのはなぜですか?

OpenAI では、メッセージのどこかで JSON を出力するよう指示する必要があり、コンテキストに文字列「JSON」が含まれていないとエラーになります。

JSON モードでも壊れた JSON が返ってくることはありますか?

あります。応答が max_tokens やコンテキストの上限で途中で切れた場合です。パースする前に finish_reason を確認してください。

Markdown で読むChatGPT に聞くClaude に聞くPerplexity に聞く