Démarrage rapide de Novita AI Search : votre premier appel de recherche web

AI Search donne à votre application un accès en direct au web via une seule passerelle Novita. Au lieu de vous inscrire auprès de chaque fournisseur de recherche, de gérer des clés séparées et d’apprendre différents schémas d’authentification, vous appelez Novita avec une seule clé API et choisissez le moteur de recherche souhaité pour chaque requête. Ce guide vous mène de zéro à une recherche web fonctionnelle en quelques minutes. Vous vous authentifierez avec une seule clé API Novita, lancerez une recherche et verrez comment changer de fournisseur sans modifier votre configuration.

Avant de commencer

Un compte Novita et une clé API. Consultez Gestion des clés API pour en créer une.
Exportez votre clé afin que les exemples ci-dessous puissent l’utiliser. NOVITA_API_KEY est simplement votre clé API Novita de l’étape 1 — la même clé fonctionne pour tous les fournisseurs :

export NOVITA_API_KEY="<Your API Key>"

Tous les endpoints AI Search partagent la même URL de base et la même authentification :

URL de base : https://api.novita.ai
En-tête d’authentification : Authorization: Bearer <api_key>
Type de contenu : application/json

Votre première recherche

L’exemple ci-dessous lance une recherche Exa. Chaque requête se compose simplement d’une route et d’un corps JSON.

curl -X POST 'https://api.novita.ai/v3/exa/search' \
  -H "Authorization: Bearer ${NOVITA_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "latest open-source LLM releases",
    "numResults": 5
  }'

import os
import requests

resp = requests.post(
    "https://api.novita.ai/v3/exa/search",
    headers={
        "Authorization": f"Bearer {os.environ['NOVITA_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "query": "latest open-source LLM releases",
        "numResults": 5,
    },
)
resp.raise_for_status()

for result in resp.json()["results"]:
    print(result["title"], "-", result["url"])

const resp = await fetch("https://api.novita.ai/v3/exa/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.NOVITA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "latest open-source LLM releases",
    numResults: 5,
  }),
});

const data = await resp.json();
for (const result of data.results) {
  console.log(`${result.title} - ${result.url}`);
}

Changer de moteur de recherche

Changer de moteur de recherche signifie modifier la route et le corps de la requête pour correspondre au fournisseur — votre clé, l’hôte et l’en-tête d’authentification restent les mêmes. Voici la même intention exprimée pour Tavily :

curl -X POST 'https://api.novita.ai/v3/tavily/search' \
  -H "Authorization: Bearer ${NOVITA_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "latest open-source LLM releases",
    "max_results": 5
  }'

Notez les petites différences : Exa utilise numResults, Tavily utilise max_results. La liste complète des paramètres de chaque fournisseur se trouve dans sa référence API.

Utiliser le SDK de votre propre fournisseur

AI Search est une intégration passthrough : le SDK officiel d’un fournisseur fonctionne donc tant qu’il vous permet de remplacer l’URL de base — faites-le pointer vers la route de passerelle correspondante et transmettez votre clé Novita. Le SDK Python Exa, par exemple, accepte un base_url :

import os
from exa_py import Exa

exa = Exa(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/v3/exa",
)

results = exa.search("latest open-source LLM releases", num_results=5)
for r in results.results:
    print(r.title, "-", r.url)

Si un SDK n’expose pas de paramètre d’URL de base, appelez simplement les endpoints REST directement avec n’importe quel client HTTP, comme montré ci-dessus — cette approche fonctionne toujours.

Fonctionnement

Novita expose chaque fournisseur sous forme d’endpoint passthrough. Votre requête est authentifiée avec votre clé API Novita, puis transmise au fournisseur en amont en utilisant les formats de requête et de réponse propres à ce fournisseur.

Un seul identifiant. Utilisez votre clé API Novita existante comme Bearer <api_key> pour chaque fournisseur.
Corps natifs du fournisseur. Les structures de requête et de réponse correspondent à celles du fournisseur en amont ; les exemples et formats de requête propres au fournisseur restent donc valables — il suffit de faire pointer l’URL de base vers Novita.
Changer de moteur par requête. Changer de fournisseur signifie modifier la route et le corps, pas votre authentification ni la configuration de votre compte.

C’est utile chaque fois qu’un modèle a besoin d’informations sur lesquelles il n’a pas été entraîné : événements actuels, documentation évoluant rapidement, prix ou tout fait disponible sur le web ouvert. Associez-le à la LLM API pour créer de la génération augmentée par récupération (RAG), des agents de recherche et des assistants ancrés dans le web.

Fournisseurs pris en charge

Exa

Recherche web neuronale et sémantique avec extraction de contenu et synthèse de réponse intégrées. Solide pour la recherche, la recherche de pages par signification et les sorties structurées.

Tavily

Recherche et récupération rapides optimisées pour les LLM, avec exploration et cartographie de sites. Solide pour les sujets d’actualité et de finance, les pipelines d’extraction et les recherches à faible latence.

Aperçu des capacités

Capacité	Ce qu’elle fait	Exa	Tavily
Recherche	Trouver des pages pertinentes à partir d’une requête	Search	Search
Extraction de contenu	Extraire du texte propre/metadata à partir d’URL	Contents	Extract
Synthèse de réponse	Générer une réponse citée à partir des résultats	Answer	via `include_answer`
Exploration de site	Suivre des liens pour collecter de nombreuses pages	—	Crawl
Cartographie de site	Découvrir les URL accessibles d’un site	—	Map

Référence des endpoints

Fournisseur	Endpoint	Route
Exa	Search	`POST /v3/exa/search`
Exa	Contents	`POST /v3/exa/contents`
Exa	Answer	`POST /v3/exa/answer`
Tavily	Search	`POST /v3/tavily/search`
Tavily	Extract	`POST /v3/tavily/extract`
Tavily	Crawl	`POST /v3/tavily/crawl`
Tavily	Map	`POST /v3/tavily/map`

Dépannage

400 Bad Request — un paramètre ne correspond pas au schéma du fournisseur. Vérifiez que vous utilisez les noms de champs de ce fournisseur (par exemple, numResults vs max_results).
429 Too Many Requests — vous avez atteint une limite de débit. Attendez avant de réessayer, ou réduisez le volume de requêtes.

Pour la liste complète, consultez la section Erreurs de n’importe quelle page de référence API AI Search.

Où aller ensuite

Réponses ancrées dans le web et RAG

Injectez les résultats de recherche dans la LLM API pour créer des pipelines de génération augmentée par récupération (RAG) avec des réponses citées.

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

Démarrage rapide

Avant de commencer

Votre première recherche

Changer de moteur de recherche

Utiliser le SDK de votre propre fournisseur

Fonctionnement

Fournisseurs pris en charge

Exa

Tavily

Aperçu des capacités

Référence des endpoints

Dépannage

Où aller ensuite

Réponses ancrées dans le web et RAG

​Avant de commencer

​Votre première recherche

​Changer de moteur de recherche

​Utiliser le SDK de votre propre fournisseur

​Fonctionnement

​Fournisseurs pris en charge

Exa

Tavily

​Aperçu des capacités

​Référence des endpoints

​Dépannage

​Où aller ensuite

Réponses ancrées dans le web et RAG

Avant de commencer

Votre première recherche

Changer de moteur de recherche

Utiliser le SDK de votre propre fournisseur

Fonctionnement

Fournisseurs pris en charge

Aperçu des capacités

Référence des endpoints

Dépannage

Où aller ensuite