> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ d’AI Search

## Premiers pas

### Qu’est-ce qu’AI Search ?

AI Search est une passerelle Novita unique qui donne à votre application un accès en direct à la recherche sur le Web. Vous appelez Novita avec une seule clé API et choisissez un fournisseur de recherche par requête, au lieu de vous inscrire séparément auprès de chaque fournisseur. Consultez le [Démarrage rapide](/docs/fr/guides/ai-search-quickstart) pour une vue d’ensemble complète.

### Quels fournisseurs sont pris en charge ?

Actuellement **Exa** et **Tavily**. Chacun est exposé comme un point de terminaison passthrough qui reflète le format de requête et de réponse propre au fournisseur. Consultez le [Démarrage rapide](/docs/fr/guides/ai-search-quickstart) pour la liste des endpoints.

### Ai-je besoin d’un compte Exa ou Tavily séparé ?

Non. Votre clé API Novita authentifie chaque requête AI Search. Vous ne gérez pas les clés ni les comptes des fournisseurs en amont.

## Authentification et configuration

### Comment m’authentifier ?

Utilisez votre clé API Novita comme jeton bearer : `Authorization: Bearer <api_key>`. La même clé fonctionne pour chaque fournisseur. Pour créer ou gérer des clés, consultez [Gestion des clés API](/docs/fr/api-reference/basic-authentication).

### Existe-t-il un SDK Novita pour AI Search ?

Non — et vous n’en avez pas besoin. AI Search est une intégration, pas un produit encapsulé : chaque point de terminaison est un relais qui transmet votre requête au fournisseur (Exa ou Tavily) dans le format natif de ce fournisseur. Cela signifie que vous avez deux options solides :

* **Utiliser le SDK du fournisseur.** Si le SDK vous permet de définir une URL de base personnalisée, faites-la pointer vers la route de passerelle correspondante et transmettez votre clé Novita. Par exemple, le SDK Python Exa accepte `base_url="https://api.novita.ai/v3/exa"`. Consultez le [Démarrage rapide](/docs/fr/guides/ai-search-quickstart#bring-your-own-provider-sdk) pour un exemple complet.
* **Appelez directement les points de terminaison REST.** Fonctionne avec n’importe quel client HTTP et ne nécessite aucun SDK. Le [guide de démarrage rapide](/docs/fr/guides/ai-search-quickstart) présente des exemples en curl, Python, et JavaScript.

Si un SDK n’expose pas de paramètre d’URL de base, utilisez plutôt le chemin REST.

## Puis-je changer de fournisseur sans modifier la structure de mon code ?

Pour l’essentiel. L’authentification, l’hôte, et le flux de requête restent identiques — vous changez la route (p. ex. `/v3/tavily/search` → `/v3/exa/search`) et alignez le corps sur les noms de champs de ce fournisseur (par exemple, ceux de Tavily `max_results` par rapport à Exa's `numResults`).

## Comportement de recherche

### À quel point les résultats sont-ils récents ?

Les résultats reflètent le contenu web en direct. Pour les questions sensibles au temps, limitez par date pour exclure les pages obsolètes : Tavily expose `time_range` et `start_date`/`end_date`; Exa expose `startPublishedDate`/`endPublishedDate`.

### Comment restreindre les résultats aux sites de confiance ?

Utilisez les filtres de domaine — `include_domains`/`exclude_domains` sur Tavily, `includeDomains`/`excludeDomains` sur Exa — pour limiter la récupération aux sources auxquelles vous faites confiance.

### Quelle est la différence entre search, extract et crawl ?

* **Search** découvre des pages pertinentes à partir d’une requête.
* **Extract / Contents** extrait du texte propre à partir des URLs que vous avez déjà.
* **Crawl / Map** suit les liens pour collecter ou lister de nombreuses pages d’un site.

Voir [Réponses ancrées dans le Web](/docs/fr/guides/ai-search-grounded-answers#search-vs-extract-vs-crawl) pour savoir lequel utiliser.

### AI Search peut-il générer une réponse, et pas seulement des liens ?

Oui. Tavily Search renvoie une réponse de LLM lorsque vous définissez `include_answer`, et Exa propose une solution dédiée [Answer](/docs/fr/api-reference/model-apis-exa-answer) point de terminaison. Pour un contrôle total sur la formulation et les citations, récupérez les résultats et synthétisez-les avec l’[API LLM](/docs/fr/guides/llm-api) à la place — voir [Réponses ancrées sur le Web](/docs/fr/guides/ai-search-grounded-answers).

## Limites & dépannage

### Quelles sont les limites de débit ?

Les requêtes AI Search sont soumises à la fois aux limites de la plateforme Novita et aux limites propres à chaque fournisseur en amont, qui dépendent du niveau du fournisseur associé à votre compte. Lorsque vous dépassez une limite, l’API renvoie `429 Too Many Requests` — temporisez et réessayez avec un délai exponentiel. Ces limites sont distinctes de l’[API LLM](/docs/fr/guides/llm-api) limites de débit ; un appel de recherche ne consomme pas votre quota LLM.

### Pourquoi est-ce que j’obtiens une erreur 400 ?

Un paramètre ne correspond probablement pas au schéma du fournisseur. Vérifiez que vous utilisez les noms de champs de ce fournisseur — une cause fréquente est l’envoi de ceux de Tavily `max_results` vers une route Exa (qui attend `numResults`).

### Où puis-je obtenir plus d’aide ?

Pour les questions d’intégration ou des limites plus élevées, [réservez un appel avec notre équipe](https://meet.brevo.com/novita-ai/contact-sales).