En bref. Lisez le JSON des citations dans le contenu balisé diffusé en continu après avoir activé stream et enable_citations en mode recherche unique.

Définition : Les citations diffusées en continu (streaming) par l’API Answers de Brave sont des enregistrements de sources encodés en JSON à l’intérieur de balises <citation> dans le contenu de la réponse. Au 17 octobre 2026, Brave documente ces balises de citation intégrées au texte pour les requêtes à recherche unique avec diffusion en continu activée.

Points clés

La référence de l’API de Brave fixe enable_citations à false par défaut et exige stream=true lorsque cette option est activée.
Le guide Answers de Brave présente des enregistrements de citation contenant start_index, end_index, number, url, favicon et snippet.
Le fichier de compétence Answers de Brave décrit les événements envoyés par le serveur (server-sent events, SSE) : un flux de messages data: contenant des fragments de réponse, suivi de data: [DONE].

Quelle requête active les citations intégrées au texte ?

La référence de l’API accepte exactement un message utilisateur. Elle propose les modèles brave et brave-pro, avec brave-pro comme valeur par défaut. Le corps de requête suivant active explicitement la diffusion en continu et les citations intégrées au texte :

{
  "messages": [{"role": "user", "content": "Explain quantum computing"}],
  "model": "brave",
  "stream": true,
  "enable_citations": true,
  "enable_research": false
}

La référence limite enable_citations aux requêtes hors du mode recherche. Elle définit séparément enable_research comme une recherche itérative qui exige la diffusion en continu. Cette distinction intervient dans le choix de l’analyseur syntaxique (parser) : l’option de citation intégrée au texte relève du format à recherche unique.

Où apparaissent les données de citation ?

Le guide Answers de Brave lit le contenu diffusé en continu dans choices[0].delta.content. Il donne cet exemple de citation :

<citation>{"start_index": 0, "end_index": 10, "number": 1, "url": "https://...", "favicon": "...", "snippet": "..."}</citation>

L’URL et les points de suspension servent de valeurs de substitution dans la documentation. L’analyseur du guide vérifie la présence des balises de citation ouvrante et fermante, les supprime, puis décode le JSON qu’elles contiennent. Il affiche un lien dont le libellé est number et la destination url. L’enregistrement contient également les champs d’extrait et de favicon présentés ci-dessus.

Le même exemple traite les balises <usage> séparément et affiche progressivement le texte ordinaire de la réponse. Les métadonnées d’utilisation arrivent dans le dernier message du flux et comprennent notamment les champs X-Request-Queries et X-Request-Total-Cost.

En quoi le flux externe diffère-t-il de la sortie du mode recherche ?

Le fichier de compétence Answers de Brave présente la structure externe des messages SSE :

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","choices":[{"delta":{"content":"Based on"},"index":0}]}

data: [DONE]

La lecture de ce format consiste à extraire le contenu du fragment de réponse, puis à interpréter les balises qu’il contient. Le préfixe SSE data: appartient à l’enveloppe de transport ; <citation> appartient au contenu de la réponse.

Pour le mode recherche, le même fichier décrit des événements <progress> et un élément final <answer> contenant les citations intégrées. Il mentionne aussi <usage> pour les données de coût. Un programme qui traite la sortie du mode recherche doit donc prendre en charge les balises documentées pour ce mode, en plus du traitement des citations à recherche unique.

Termes connexes

Questions fréquentes

Pourquoi les balises de citation intégrées au texte sont-elles absentes ?

Vérifiez enable_citations : la référence de l’API fixe sa valeur par défaut à false. Pour demander ces balises, définissez cette option sur true, activez la diffusion en continu et laissez le mode recherche désactivé.

Puis-je placer des surlignages à l’aide des champs d’indice ?

Le guide Answers présente start_index et end_index, sans préciser l’unité des positions ni la convention utilisée pour les bornes. Son exemple d’affichage utilise directement le numéro de citation et l’URL.

Sources

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

Comment lire les citations diffusées en continu par l’API Answers de Brave ?