メインコンテンツへスキップ
リクエストに JSON Schema を付けて送ると、モデルは自由形式のテキストではなく、その形の JSON を返します。それでも、使う前にはコードで解析と検証を行ってください。

形式を選ぶ

形式を指定する場所はエンドポイントによって異なります。

スキーマを送る

JSON はメッセージの内容に文字列として返されます。

スキーマを設計する

小さなオブジェクトから始めてください。すべてのフィールドを required に並べ、既知のカテゴリには enum を使い、余分なキーを拒否する必要がある場合は additionalProperties: false を設定します。スキーマはサーバー側のバリデーターと一緒にバージョン管理し、両者がずれないようにしてください。

結果を検証する

解析する前に、拒否、内容の欠落、途中で切れた回答(finish_reason が stop 以外)がないかを確認します。その後、解析したオブジェクトを検証します。次の Zod バリデーターは上のスキーマに対応しています。
検証に失敗した場合は、エラーをプロンプトに含めて 1 回だけ再試行し、それでも失敗したら安全な失敗を返します。再試行のたびに課金されます。有効な JSON であっても、値が正しいことや、操作が認可されていることの証明にはなりません。 検証の失敗はモデルとスキーマのバージョンごとに記録し、どちらかが変わったら評価ケースを実行し直してください。不正な形式の JSON を自動で修復するには、レスポンスの修復を参照してください。
最終更新日 2026年11月5日