要点
APIYI は OpenAI の公式ウェブ検索を完全にサポートしています: Responses API (/v1/responses) と web_search ツールを使用してください。gpt-5.5 と gpt-5.4 の両方で、実際にウェブを検索し、出典の引用付きで最新情報を返すことが確認済みです。default-group のキーはそのまま使えます — 特別な有効化は不要です。
実運用での利用可能性(テストデータ、2026-06-11)
クイックスタート
cURL
Python (OpenAI SDK)
レスポンス構造
output 配列には、実行順に次が含まれます:
status: "completed" は正常に終了したことを意味します。incomplete は通常、max_output_tokens が小さすぎたことを意味します — 増やしてください。
課金(重要)
Web 検索には 2 つの内訳からなるツール呼び出し料金が発生します:Web 対応の Q&A 1 回あたりの実測総コスト: gpt-5.4 は検索料金 ≈ $0.01 + 9k tokens、gpt-5.5 は検索料金 ≈ $0.08 + 約 50k tokens です。想定されるクエリ量に照らして見積もってください。
注意事項
- Responses API を使用してください — Chat Completions の
web_search_optionsは使用しないでください: gpt-5 シリーズのモデルはそのパラメータをサポートしていません(OpenAI の公式な挙動で、400Unknown parameter: 'web_search_options'を返します)。web_search_optionsは専用の*-search-previewモデルにのみ適用されます。 max_output_tokensは少なくとも 8192 に設定してください: gpt-5.5 は多くの reasoning tokens を消費します。小さい上限では最終回答なしでstatus: "incomplete"が返り、tokens は引き続き課金されます。- 従来のツールタイプ
web_search_previewも同じ挙動で利用できます。新しい統合では、web_searchを直接使用してください。 - コストを抑えるには、プロンプトで検索動作を制約するか(たとえば「最大 2 回まで検索する」)、gpt-5.4 を使用してください。
FAQ
Q: 回答が本当にウェブを使ったものか、どう確認できますか? A: レスポンスoutput に type="web_search_call" を含む項目があるか、また message の注釈に url_citation が含まれているかを確認してください。両方がそろっていれば実際のウェブアクセスです。これら 2 つのマーカーがなく、回答文だけがある場合は、モデルが学習データから答えています。
Q: 別のグループや特別なキーは必要ですか?
A: いいえ。OpenAI モデルでは、デフォルトグループのキーでウェブ検索を直接呼び出せます。
Q: どのモデルがサポートされていますか?
A: gpt-5.5 と gpt-5.4 は検証済みです。ほかの gpt-5 シリーズのモデルも、原則として Responses API web_search ツールをサポートしているはずです。依存する前に、上の FAQ にある検証チェックを実行してください。
関連ドキュメント
OpenAI ネイティブ呼び出し (Responses API)
Responses API のエンドポイント、パラメータ、設定
OpenAI プロンプトキャッシュ
ウェブ検索によって挿入される大量の input token は、キャッシュと相性が良いです