Passer au contenu principal
Deux chemins vers la recherche web via OrcaRouter :
  1. Modèles search-preview — appelez directement une variante de recherche via /v1/chat/completions
  2. Outils / options sur un modèle régulier — passez web_search_options (Chat) ou tools: [{"type": "web_search"}] (Responses)

​
Modèles search-preview (OpenAI)

OpenAI publie des variantes search-preview pour plusieurs modèles — par exemple openai/gpt-4o-search-preview et openai/gpt-5-search-api. Choisissez l’un d’entre eux comme model sur /v1/chat/completions et l’amont gère la recherche côté serveur. Appelez /v1/models pour le catalogue en direct.

​
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. Contrôle la profondeur de recherche (le prix par appel pour web_search est le même quelle que soit la taille).

​
Outils (API Responses)

/v1/responses accepte tools: [{"type": "web_search"}] sur les modèles OpenAI et tout modèle Grok — la surface Agent Tools de xAI vit sur le même endpoint. 
# 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 (Agent Tools xAI)
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"}]
  }'
Chaque web_search_call émis par l’amont est compté pour la facturation — voir Opérations / Facturation et utilisation.

​
Support inter-fournisseurs

La recherche web atteint chaque fournisseur qui l’expose ; seul le point d’entrée diffère :
FournisseurRecherche webComment
OpenAI✅Modèles search-preview, ou passer l’outil web_search à /v1/responses
xAI Grok✅Appeler /v1/responses avec tools: [{"type": "web_search"}] et tout modèle Grok — l’API Agent Tools de xAI. (xAI a déprécié les anciens search_parameters sur chat completions le 2026-01-12 ; les anciennes variantes de noms de modèles *-search ne fonctionnent plus.)
Anthropic✅Passez web_search_options sur une requête Chat Completions — traduit vers l’outil serveur natif web_search d’Anthropic. search_context_size (low/medium/high) mappe à max_uses ; user_location.approximate mappe au user_location d’Anthropic.
Gemini✅Passez un outil de fonction nommé googleSearch (voir ci-dessous) — traduit vers l’outil d’ancrage natif GoogleSearch de Gemini.
DeepSeek❌L’API DeepSeek n’expose pas la recherche web.

​
Ancrage Gemini via googleSearch

Pour les modèles Gemini, la couche de traduction d’OrcaRouter reconnaît un nom de fonction magique googleSearch et le transforme en outil d’ancrage natif GoogleSearch de Gemini. Envoyez-le comme tout autre outil de fonction de style 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"}}]
  }'
Les métadonnées d’ancrage que Gemini retourne (webSearchQueries, etc.) sont capturées par la passerelle pour la facturation et exposées via les champs standard de chat-completion. Deux noms de fonctions magiques liés sont reconnus sur le même chemin de code :
  • codeExecution — active l’outil natif d’exécution de code de Gemini
  • urlContext — active l’outil URL-context de Gemini

​
Ou en mode natif

Si vous êtes déjà sur le protocole natif Gemini via /v1beta/, passez googleSearch directement en forme Gemini — aucune traduction de nom magique nécessaire : 
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": {}} et {"urlContext": {}} fonctionnent de la même manière sur le chemin natif. Voir Formats natifs / Gemini.

​
Facturation

web_search et web_search_preview sont suivis comme appels d’outils intégrés. Ils ont différents niveaux de prix — voir Opérations / Facturation et utilisation pour le détail.