En bref. L’API Answers de Brave accepte un message utilisateur par requête ; les applications préparent donc les relances sous forme de questions autonomes.

Définition : Au 17 octobre 2026, l’API Answers de Brave accepte exactement un message user par requête. Pour poursuivre une conversation, l’application doit donc préparer une question autonome dans la chaîne content de ce message.

Points clés

La référence de l’API Answers de Brave limite le tableau messages à un seul message dont le rôle est user.
Le fichier de compétence (skill) Answers de Brave reprend cette exigence d’un message unique et présente des requêtes authentifiées avec X-Subscription-Token.
La documentation d’Answers de Brave décrit le mode recherche comme une succession de recherches qui affinent progressivement une stratégie de recherche.

Comment une application doit-elle traiter une relance ?

L’historique des messages est la suite des questions précédentes de l’utilisateur et des réponses de l’assistant. Une requête à plusieurs tours (multi-turn) contient les messages précédents ainsi qu’une nouvelle question. Le schéma de requête de Brave limite messages à exactement un message user, avec un champ content de type chaîne de caractères.

Une application peut conserver l’historique de la conversation et formuler chaque relance comme une question autonome, en intégrant le contexte antérieur pertinent dans content. Cette recommandation de mise en œuvre découle de la contrainte du schéma qui impose un message unique.

La même référence indique que metadata est ignoré et que ses paires ne sont ni stockées ni renvoyées ; ce champ ne convient donc pas à la transmission de l’historique de conversation.

À quoi ressemble une requête de suivi ?

Le guide de démarrage rapide de Brave envoie les requêtes au point de terminaison ci-dessous et inclut une question sur un séjour à Paris avec des enfants dans son exemple de SDK. Cet exemple adapté rend autonome une relance sur les activités en intérieur en reprenant la destination et le contexte familial. Il illustre la construction d’une requête plutôt qu’une conversation enregistrée.

curl -X POST "https://api.search.brave.com/res/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "x-subscription-token: <YOUR_BRAVE_SEARCH_API_KEY>" \
  -d '{
    "stream": false,
    "messages": [{
      "role": "user",
      "content": "For a family visiting Paris with kids, which indoor activities are suitable?"
    }]
  }'

La même documentation présente des requêtes synchrones avec le SDK, utilise stream=False et lit la réponse dans completions.choices[0].message.content. Conserver cette réponse dans l’historique de l’application permet de préparer la question autonome suivante.

Le mode recherche modifie-t-il le format des messages ?

Le fichier de compétence publié par Brave applique l’exigence d’un message unique au point de terminaison et décrit la recherche comme une succession d’itérations. Le mode recherche utilise enable_research=true et exige stream=true.

Les itérations de recherche concernent la manière dont une réponse est élaborée au sein d’une requête. Le traitement des relances par l’application doit toujours respecter l’exigence d’un message unique en entrée. Le changement de mode de recherche ne fournit aucun autre format documenté pour l’historique des messages.

Termes associés

Questions fréquentes

Puis-je envoyer les réponses précédentes de l’assistant sous forme de messages distincts ?

Le fichier de compétence de Brave exige exactement un message user. Vous pouvez préparer une nouvelle question autonome en intégrant le contexte antérieur pertinent dans sa chaîne content.

Puis-je continuer à utiliser un client du SDK OpenAI ?

L’exemple de SDK de Brave utilise une clé d’API Brave et base_url="https://api.search.brave.com/res/v1". Vous devez toujours respecter le format de requête à message unique de Brave lorsque vous préparez chaque relance.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Comment poursuivre une conversation avec l’API Answers de Brave ?