メインコンテンツへスキップ
OrcaRouter 経由のウェブ検索には 2 つのパスがあります:
  1. Search-preview モデル — /v1/chat/completions で検索バリアント を直接呼び出す
  2. 通常モデルへのツール / オプション — web_search_options (Chat) または tools: [{"type": "web_search"}] (Responses) を渡す

​
Search-preview モデル (OpenAI)

OpenAI は複数のモデルに対して search-preview バリアントを公開して います——例: openai/gpt-4o-search-preview と openai/gpt-5-search-api。これらのいずれかを /v1/chat/completions の model に指定すると、上流がサーバサイドで 検索を処理します。 実時カタログは /v1/models を呼んで取得してください。

​
web_search_options (Chat Completions)

curl https://api.orcarouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-orca-..." \
  -d '{
    "model": "openai/gpt-4o-search-preview",
    "messages": [{"role": "user", "content": "What changed in OpenAI pricing this week?"}],
    "web_search_options": {"search_context_size": "medium"}
  }'
search_context_size: low / medium / high。検索の深さを制御 します (web_search の 1 回あたり価格はサイズによらず同じ)。

​
ツール (Responses API)

/v1/responses は OpenAI モデルと任意の Grok モデルの両方で tools: [{"type": "web_search"}] を受け付けます——xAI の Agent Tools のインターフェースは同じエンドポイント上にあります。 
# OpenAI
curl https://api.orcarouter.ai/v1/responses \
  -H "Authorization: Bearer sk-orca-..." \
  -d '{
    "model": "openai/gpt-5",
    "input": "What changed in OpenAI pricing this week?",
    "tools": [{"type": "web_search"}]
  }'

# Grok (xAI Agent Tools)
curl https://api.orcarouter.ai/v1/responses \
  -H "Authorization: Bearer sk-orca-..." \
  -d '{
    "model": "grok/grok-4-fast-reasoning",
    "input": "What changed in xAI pricing this week?",
    "tools": [{"type": "web_search"}]
  }'
上流が発する web_search_call のたびに課金されます—— 運用 / 課金と使用量 を参照 してください。

​
プロバイダ間サポート

ウェブ検索はそれを提供するすべてのプロバイダに到達します。入口だけ が異なります:
プロバイダウェブ検索方法
OpenAI✅Search-preview モデル、または /v1/responses に web_search ツールを渡す
xAI Grok✅/v1/responses に任意の Grok モデルと tools: [{"type": "web_search"}] を渡す ——xAI の Agent Tools API。(xAI は 2026-01-12 に chat completions 上の旧 search_parameters を廃止；旧 *-search モデル名バリアントは動作しません。)
Anthropic✅Chat Completions リクエストで web_search_options を渡す —— Anthropic ネイティブの web_search サーバツールに変換されます。search_context_size (low/medium/high) は max_uses に、user_location.approximate は Anthropic の user_location に対応付けられます。
Gemini✅googleSearch という名前の関数ツールを渡す (下記参照) —— Gemini ネイティブの GoogleSearch グラウンディングツールに変換されます。
DeepSeek❌DeepSeek API はウェブ検索を提供しません。

​
googleSearch 経由の Gemini グラウンディング

Gemini モデルの場合、OrcaRouter の変換層は マジック関数名 googleSearch を認識し、Gemini ネイティブの GoogleSearch グラウンディングツールに変換します。OpenAI 形式の他の関数ツールと 同じように渡してください: 
curl https://api.orcarouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [{"role":"user","content":"What changed in Gemini pricing this week?"}],
    "tools": [{"type":"function","function":{"name":"googleSearch"}}]
  }'
Gemini が返すグラウンディングメタデータ (webSearchQueries 等) は ゲートウェイが課金用に捕捉し、標準の chat-completion フィールドを 通じて公開します。同じコード経路で認識される関連マジック名が 2 つ あります:
  • codeExecution —— Gemini ネイティブのコード実行ツールを有効化
  • urlContext —— Gemini の URL コンテキストツールを有効化

​
あるいはネイティブで

すでに Gemini の /v1beta/ ネイティブプロトコルを使っているなら、 マジック名変換なしに Gemini 形式で googleSearch を直接渡せます: 
curl "https://api.orcarouter.ai/v1beta/models/google/gemini-2.5-flash:generateContent" \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role":"user","parts":[{"text":"What changed in Gemini pricing this week?"}]}],
    "tools": [{"googleSearch": {}}]
  }'
{"codeExecution": {}} と {"urlContext": {}} もネイティブパスで同様 に動作します。ネイティブ形式 / Gemini を 参照してください。

​
課金

web_search と web_search_preview は内蔵ツールの呼び出しとして 記録されます。価格層が異なります —— 運用 / 課金と使用量 で内訳を 確認してください。