En bref. Brave Answers documente country pour les résultats de recherche et language pour la réponse comme deux champs de requête distincts.
Définition : Oui, au niveau de la requête. Brave Answers définit
countrycomme le pays ciblé pour les résultats de recherche etlanguagecomme la langue de réponse : ces deux réglages sont transmis dans des champs distincts.
Points clés
- La documentation d’Answers de Brave indique que les paramètres supplémentaires du SDK OpenAI sont transmis via
extra_body. - Cette même page définit
countrycomme le pays ciblé pour les résultats de recherche et indiqueuscomme valeur par défaut. - Elle définit
languagecomme la langue de réponse et indiqueencomme valeur par défaut. - La référence de l’API Web Search de Brave utilise un champ distinct,
search_lang, pour la langue dans laquelle les résultats de recherche sont fournis. - La référence Web Search décrit
ui_langcomme la langue d’interface souhaitée dans la réponse, généralement au format langue-pays.
Comment les deux réglages d’Answers sont-ils séparés ?
La page Answers de Brave place les deux réglages dans le corps de la requête transmis via extra_body. Son exemple associe country à la valeur IT et language à la valeur it, à côté des paramètres de citation des sources et de recherche approfondie :
extra_body={
"country": "IT",
"language": "it",
"enable_citations": True,
"enable_research": False,
}
La liste des paramètres attribue une fonction différente à chaque champ. country désigne le pays ciblé pour les résultats de recherche, tandis que language désigne la langue de réponse. Cette séparation permet de spécifier, dans les champs respectifs d’une même requête, un pays de recherche et une langue de réponse différente de celle de ce pays. La page de Brave ne présente pas de réponse illustrant une telle combinaison ; cette conclusion porte donc sur les paramètres de requête documentés.
Que contrôle country ?
Dans la documentation d’Answers, country cible le pays des résultats de recherche et prend par défaut la valeur us. La page utilise la valeur IT dans son exemple de paramètres avancés. Le réglage du pays relève donc de la recherche web effectuée par la requête Answers, tandis que la langue de réponse relève du champ distinct language.
Le service Answers utilise le point de terminaison (endpoint) suivant :
https://api.search.brave.com/res/v1/chat/completions
La documentation décrit ce service comme une API de réponses fondées sur une recherche web en temps réel et des sources vérifiables. La valeur du pays constitue donc un paramètre de ciblage de la recherche ; la langue dans laquelle la réponse renvoyée doit être rédigée se règle séparément.
En quoi les noms des paramètres diffèrent-ils de ceux de l’API Web Search ?
La référence Web Search de Brave définit country comme le code à deux caractères du pays dont proviennent les résultats de recherche. Son paramètre search_lang est le code de langue, d’au moins deux caractères, pour lequel les résultats de recherche sont fournis. Elle répertorie aussi ui_lang, qui indique la langue d’interface souhaitée dans la réponse, généralement sous la forme d’un code de langue suivi d’un code de pays.
Ces noms ont leur importance lorsqu’une application utilise les deux services. Dans une requête Answers, le champ documenté language sert à définir la langue de réponse. Dans une requête Web Search, search_lang désigne la langue des résultats et ui_lang celle de l’interface. La référence Web Search indique US, en et en-US comme valeurs par défaut respectives de country, search_lang et ui_lang.
Termes associés
- Brave Answers API
- Comment définir le pays et la langue pour un test de l’API Brave Search ?
- Localisation de Brave Search
- Langue d’interface et langue de recherche
Questions fréquentes
Puis-je utiliser IT et en dans la même requête Answers ?
Oui. La documentation d’Answers présente country et language comme des champs distincts : vous pouvez donc transmettre IT pour le pays de recherche et en pour la langue de réponse au niveau de la requête.
Le champ language d’Answers correspond-il au champ search_lang de Web Search ?
Non. Brave décrit le champ d’Answers comme la langue de réponse. Dans la référence Web Search, search_lang correspond à la langue pour laquelle les résultats de recherche sont fournis.
Que se passe-t-il si j’omets les deux champs ?
La documentation d’Answers indique us comme valeur par défaut de country et en comme valeur par défaut de language.
Sources
Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO