構造化出力を得る
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日