phaseo:web_search pour que le modèle puisse rechercher sur le Web lorsqu’il a besoin d’informations récentes ou appuyées par des sources. Le modèle rédige la requête de recherche et peut chercher plusieurs fois au cours d’une même requête ; Phaseo renvoie des URL, des titres, des extraits, des passages mis en évidence et, en option, le texte des pages, et le modèle rédige une réponse étayée.
tools sur /v1/responses et /v1/messages.
Paramètres
Ce que le modèle envoie
Chaque appel contient unequery. Le modèle peut aussi envoyer max_results, engine, search_context_size, les listes de domaines, include_text, include_highlights, max_characters et ces indications de localisation :
Les valeurs envoyées par le modèle remplacent les valeurs par défaut de l’outil pour cet appel.
max_results reste plafonné par ce qu’il reste de max_total_results ; une fois ce total épuisé, les appels suivants renvoient max_total_results_reached.
Choisir un moteur
Si un moteur géré n’est pas activé, l’appel renvoie
search_not_configured au modèle.
Avec engine: "native" sur /v1/chat/completions ou /v1/responses, la requête n’est envoyée qu’aux fournisseurs qui exécutent eux-mêmes la recherche Web. Si aucun ne sert le modèle, Phaseo exécute à la place son moteur par défaut et le facture comme une recherche gérée.
Les fournisseurs qui exécutent eux-mêmes la recherche Web sur ces endpoints sont OpenAI, les déploiements Azure OpenAI sur /v1/responses, xAI et DeepSeek sur deepseek/deepseek-v4.1-flash-1017. DeepSeek ne recherche par lui-même que lorsque la recherche Web est le seul outil de la requête, sans listes de domaines ni position de l’utilisateur, sans sortie JSON et sans tool_choice forcé. Son API rejette les listes de domaines, la position et la sortie JSON, désactive sa recherche Web lorsque la requête contient d’autres outils et ne peut pas forcer une recherche. Les autres requêtes vers ce modèle utilisent à la place la recherche de Phaseo, qui fonctionne avec vos propres outils. Lorsque le raisonnement est activé, DeepSeek lance une recherche plus approfondie qui ouvre et lit des pages en plusieurs étapes.
Envoyer l’outil propre à OpenAI { "type": "web_search" } fonctionne comme engine: "native". Définissez native uniquement dans la définition de l’outil : si le modèle demande native dans un appel, l’appel renvoie unsupported_search_engine, car l’outil du fournisseur doit être choisi avant l’envoi de la requête.
Filtrer par domaine
Utilisezallowed_domains lorsque la réponse doit provenir d’un ensemble fixe de sources, et excluded_domains pour écarter certains sites d’une recherche autrement ouverte.
- Perplexity accepte l’une ou l’autre liste, pas les deux, et jusqu’à 20 domaines. Les domaines exclus sont envoyés dans son format de liste de refus.
- Firecrawl accepte l’une ou l’autre liste, pas les deux.
- TinyFish accepte les deux et les convertit en opérateurs
site:et-site:dans la requête de recherche. - DeepSeek accepte les deux et les convertit en opérateurs
site:et-site:. Ses requêtes sont limitées à 128 caractères : la requête est donc raccourcie pour laisser de la place aux opérateurs. Si les listes de domaines dépassent à elles seules la limite, l’appel renvoiesearch_query_too_long.
Ce que l’outil renvoie
Un résultat JSON avec le moteur, la requête de recherche et un tableauresults. Chaque résultat contient un title, une url, un snippet ou des highlights, et text lorsque le texte de la page a été demandé et que le moteur le fournit.
Utilisation et tarification
Chaque recherche s’ajoute àusage.server_tool_use :
server_tool_web_search_requests et server_tool_web_search_extra_results. Les recherches qui échouent ne sont pas facturées, et TinyFish Search est gratuit sur ses offres publiées : engine: "tinyfish" n’ajoute donc aucun coût de recherche. Les recherches sur des moteurs payants nécessitent du crédit même lorsque le modèle est gratuit. La recherche native est facturée avec native_web_search_requests au prix publié par le fournisseur : par exemple $10 pour 1,000 recherches chez OpenAI et Anthropic, et $0.75 pour 1,000 chez DeepSeek, où seules les recherches qui renvoient des résultats comptent. DeepSeek facture aussi chaque récupération de page, où il lit une URL avec son outil de lecture de liens, à $0.75 pour 1,000, sous la forme de native_web_fetch_requests. Lorsque le raisonnement est activé, une seule réponse de DeepSeek peut lancer une douzaine de recherches ou plus, et les résultats qu’il lit s’ajoutent aux tokens d’entrée.