Skip to main content
このページでは、2026年6月に実際にテストして検証した、APIYI で GPT モデルと web search を使う方法を説明します。

要点

APIYI は OpenAI の公式ウェブ検索を完全にサポートしています: Responses API (/v1/responses) と web_search ツールを使用してください。gpt-5.5 と gpt-5.4 の両方で、実際にウェブを検索し、出典の引用付きで最新情報を返すことが確認済みです。default-group のキーはそのまま使えます — 特別な有効化は不要です。

実運用での利用可能性(テストデータ、2026-06-11)

モデルの選択: 速度とコスト重視なら gpt-5.4 を、網羅性と厳密さ重視なら gpt-5.5 を選んでください(検索ラウンドが増え、取得コンテンツの注入量も大きくなるため、コストとレイテンシが高くなります — 課金セクションを参照してください)。

クイックスタート

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 です。想定されるクエリ量に照らして見積もってください。

注意事項

  1. Responses API を使用してください — Chat Completions の web_search_options は使用しないでください: gpt-5 シリーズのモデルはそのパラメータをサポートしていません(OpenAI の公式な挙動で、400 Unknown parameter: 'web_search_options' を返します)。web_search_options は専用の *-search-preview モデルにのみ適用されます。
  2. max_output_tokens は少なくとも 8192 に設定してください: gpt-5.5 は多くの reasoning tokens を消費します。小さい上限では最終回答なしで status: "incomplete" が返り、tokens は引き続き課金されます。
  3. 従来のツールタイプ web_search_preview も同じ挙動で利用できます。新しい統合では、web_search を直接使用してください。
  4. コストを抑えるには、プロンプトで検索動作を制約するか(たとえば「最大 2 回まで検索する」)、gpt-5.4 を使用してください。

FAQ

Q: 回答が本当にウェブを使ったものか、どう確認できますか? A: レスポンス outputtype="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 は、キャッシュと相性が良いです