---
title: "API de recherche web pour LLM · réponses sourcées depuis l'UE"
description: "Laissez les modèles ouverts chercher sur le web pendant une requête grâce à l'outil web_search de l'API Responses. Réponses à jour, sources citées."
canonical: "https://inference.eu/fr/api/web-search/"
language: "fr"
---

POST /v1/responses

# Outil de recherche web : des réponses à jour et sourcées, depuis l'UE

Un modèle de langage ne connaît que ses données d'entraînement. L'outil de recherche web lui permet de vérifier des informations pendant qu'il répond : réglementation récente, tarifs sur le site d'un fournisseur, notes de version ou actualité du jour. Vous ajoutez une entrée au tableau \`tools\` d'une requête Responses, et la réponse revient avec des citations des pages utilisées.

[Contacter l'équipe](https://inference.eu/fr/contact/)[Exemple de requête](#example)

1.  01Format d'API: OpenAI
2.  02Centres de données dans l'UE
3.  03Couvert par un seul DPA

POST /v1/responses

```
curl https://api.inference.eu/v1/responses \
  -H "Authorization: Bearer $INFERENCE_EU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-oss-120b",
    "tools": [{
      "type": "web_search",
      "user_location": {"type": "approximate", "country": "DE", "city": "Berlin"}
    }],
    "input": "What changed in the German e-invoicing rules for B2B companies this year? Cite your sources."
  }'
```

## Ce que fait l'outil

Ajoutez `{"type": "web_search"}` à `tools` dans une requête `POST /v1/responses`. Le modèle décide si une recherche est nécessaire. Le cas échéant, l'API lance une ou plusieurs recherches depuis notre infrastructure dans l'UE, lit les résultats pertinents et transmet leur contenu au modèle, qui rédige sa réponse à partir de ces sources.

Les recherches apparaissent dans `output` sous forme d'éléments `web_search_call` avec leur `status`. La réponse est un élément `message` dont le contenu `output_text` porte des `annotations` de type `url_citation`, chacune avec l'`url`, le `title` de la page et les positions `start_index` et `end_index` du passage concerné.

## Les réglages clés

`user_location`, avec `type: "approximate"` et des champs comme `country`, `city` et `region`, rend les résultats plus pertinents pour un lieu donné, ce qui compte pour le droit local, les commerces ou les événements. Utilisez un code pays ISO comme `FR`, `BE` ou `CH`.

Avec `tool_choice` réglé sur `{"type": "web_search"}`, la recherche devient obligatoire, utile si vous voulez toujours des sources fraîches. En `auto`, le modèle s'en passe pour les questions auxquelles il peut répondre directement, ce qui est plus rapide. Indiquez dans le prompt vos sources préférées, par exemple les sites officiels, et demandez des citations ; le modèle suit bien ces consignes.

## Un usage éprouvé

La recherche web convient aux assistants de recherche, à la veille concurrentielle et de marché, aux bots de support qui ont besoin d'informations produit à jour et aux agents qui vérifient des faits avant d'agir. Affichez les citations dans votre interface sous forme de liens à côté des phrases qu'elles étayent, pour que le lecteur vérifie en un clic.

Pour le savoir interne, préférez votre propre recherche par embeddings, et combinez les deux dans une requête quand une question mêle données de l'entreprise et informations publiques. Conservez les URL citées avec la réponse si vous devez garder une trace de l'origine des informations.

## Erreurs et cas particuliers

Le web n'a pas toujours raison. Les résultats peuvent être périmés, partiaux ou faux, et le modèle peut mal lire une page. Demandez des citations, affichez-les et gardez un humain dans la boucle pour les décisions aux conséquences juridiques ou financières.

Certaines pages bloquent les accès automatisés ou se trouvent derrière une connexion ou un paywall, et ne peuvent pas être lues. Si rien d'utile n'est trouvé, le modèle doit le dire ; précisez-le dans vos consignes. La recherche ajoute du temps et des tokens d'entrée : ne l'imposez pas inutilement. C'est la requête de recherche, et non toute votre conversation, qui part vers l'index.

## Web search

Endpoint

POST /v1/responses

Catégorie

Outils

Format d'API

OpenAI

Base URL

api.inference.eu/v1

Traitement

Centres de données dans l'UE

Entraînement sur vos données

Jamais

## Web search : questions fréquentes

Les questions que nous posent le plus les achats, les développeurs et les juristes. Il en manque une ? Posez-la-nous directement.

Ajoutez \`{"type": "web\_search"}\` au tableau \`tools\` d'une requête à l'API Responses. Le modèle cherche quand il a besoin d'informations récentes et cite ses sources dans la réponse. Pas besoin de clé d'API de recherche séparée ni de votre propre boucle d'outils.

Oui. Le type d'outil \`web\_search\`, le réglage \`user\_location\`, les éléments de sortie \`web\_search\_call\` et les annotations \`url\_citation\` suivent l'API Responses d'OpenAI. Votre code fonctionne après changement de l'URL de base, de la clé et du modèle.

Lisez les \`annotations\` du contenu \`output\_text\` de la réponse. Chaque \`url\_citation\` contient une \`url\`, un \`title\` et la plage de caractères de la phrase qu'elle étaye. Affichez-les sous forme de liens ou de notes à côté de ce texte.

Oui. Réglez \`tool\_choice\` sur \`{"type": "web\_search"}\` et le modèle cherchera avant de répondre. En \`auto\`, il décide lui-même, ce qui est plus rapide pour les questions auxquelles il peut répondre avec ses connaissances.

Demandez-le dans les consignes, par exemple de privilégier les sources officielles européennes et nationales, et le modèle s'y tiendra le plus souvent. Pour une liste stricte de sites, décrivez-nous votre cas d'usage et nous étudierons les options avec vous.

Uniquement les requêtes de recherche rédigées par le modèle, pas toute votre conversation ni vos documents. Le modèle et l'outil tournent sur notre infrastructure dans l'UE, et les requêtes ne servent jamais à l'entraînement. Évitez les données personnelles dans les prompts susceptibles de devenir des requêtes de recherche.

L'outil intégré fait partie de l'API Responses. Avec chat completions, vous pouvez proposer la recherche comme outil de fonction et appeler un service de recherche depuis votre code. Pour la plupart des nouveaux projets, Responses avec \`web\_search\` est plus simple.

Indiquez l'URL dans votre question et demandez au modèle de la lire ; avec la recherche web activée, il peut ouvrir les pages publiques. Les pages qui exigent une connexion, bloquent les accès automatisés ou sont derrière un paywall ne peuvent pas être lues.

[Poser une question](https://inference.eu/fr/contact/)

## Pages liées

[Présentation de l'API](https://inference.eu/fr/api/)

-   [ResponsesUtilisez le format de l'API Responses d'OpenAI avec des modèles open-weight sur inference.eu. Sorties typées, outils intégrés, traitement dans l'UE.Endpoints](https://inference.eu/fr/api/responses/)
-   [Remote MCP serversConnectez des serveurs MCP distants à vos requêtes avec l'outil mcp de l'API Responses. L'API liste et appelle leurs outils pour vous, dans l'UE.Outils](https://inference.eu/fr/api/mcp/)
-   [Code executionLaissez les modèles ouverts écrire et exécuter du Python en bac à sable grâce à l'outil code\_interpreter de l'API Responses. Analyse de données dans l'UE.Outils](https://inference.eu/fr/api/code-execution/)
-   [Tool callingLaissez des modèles ouverts appeler vos fonctions et vos API grâce à l'appel d'outils compatible OpenAI. Définir les outils, gérer la boucle, dans l'UE.Guides](https://inference.eu/fr/api/tool-calling/)

## Faites passer vos charges IA sur une infrastructure européenne

Dites-nous quels modèles vous utilisez et votre volume approximatif. Nous répondons sous un jour ouvré avec un tarif et la suite.

-   Réponse sous un jour ouvré
-   Tarif adapté à votre volume
-   DPA prêt à signer