レッスン 2/3 · 8 分

構造化出力を得る

JSON Schema を送ってモデルに決まった形の JSON を返させ、使う前に検証します。

リクエストに JSON Schema を付けて送ると、モデルは自由なテキストではなく、その形の JSON を返します。メールから項目を抜き出すなど、データを受け取りたいときに使います。モデルにアプリへ何かを依頼させたいときは、ツール呼び出しを使います。

type得られるもの
json_schemaスキーマに従った JSON。基本はこれを使います。
json_object形は強制されない、有効な JSON オブジェクト。
textプレーンテキスト(既定)。

形式は、/v1/chat/completions では response_format、/v1/responses では text.format、/v1/messages では output_config.format(json_schema のみ)に指定します。

{
  "model": "openai/gpt-6-astra",
  "messages": [
    { "role": "user", "content": "Return the city and weather for London." }
  ],
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "weather",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {
          "city": { "type": "string" },
          "weather": { "type": "string" }
        },
        "required": ["city", "weather"],
        "additionalProperties": false
      }
    }
  }
}

JSON は、メッセージの content に文字列として返ってきます。解析する前に、拒否、content の欠落、stop 以外の finish_reason がないかを確認します。次に、Zod などで解析したオブジェクトを検証します。検証に失敗したら、エラーをプロンプトに含めて 1 回だけ再試行し、それでもだめなら安全な失敗を返します。再試行のたびに課金されます。また、有効な JSON だからといって、値が正しいとは限りません。

Phaseo は response_format を決して取り除きません。json_schema のリクエストは、構造化出力に対応したプロバイダーにだけルーティングします。モデルのどのプロバイダーも対応していない場合、リクエストは 400 validation_error で失敗します。モデルページでは、対応状況が structured_outputs で示されます。これはケイパビリティのフラグで、リクエストのフィールドではありません。

理解度チェック

構造化出力に対応していないプロバイダーしかないモデルに、json_schema を指定した response_format を送りました。どうなりますか?

実践してみる

請求書のパーサーは json_schema を使っていますが、ときどき total が欠けていて Zod のチェックに失敗します。コードはどうすべきですか?

答えを表示

途中で切れた回答は有効になりえないので、まず finish_reason が stop であることを確認します。次に、検証エラーをプロンプトに含めて 1 回だけ再試行し、再び失敗したら推測せずに安全な失敗を返します。モデルとスキーマのバージョンごとに失敗を記録すれば、どちらかの変更で状況が悪化したときに気づけます。

ポイント

決まった形で必要なデータには json_schema を使い、信頼する前に必ず自分のコードで結果を検証します。

関連リンク

進捗はこのブラウザーに保存されます。

最終確認日:2026年11月17日