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 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 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.
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 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 présente des exemples en curl, Python, et JavaScript.
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 exposetime_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.
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éfinissezinclude_answer, et Exa propose une solution dédiée 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 à la place — voir Réponses ancrées sur le Web.
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 renvoie429 Too Many Requests — temporisez et réessayez avec un délai exponentiel. Ces limites sont distinctes de l’API LLM 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 Tavilymax_results vers une route Exa (qui attend numResults).