Novita AI Search Schnellstart: Ihr erster Websuchaufruf

AI Search gibt Ihrer Anwendung über ein einziges Novita-Gateway Live-Zugriff auf das Web. Anstatt sich bei jedem Suchanbieter anzumelden, separate Schlüssel zu verwalten und unterschiedliche Authentifizierungsschemata zu lernen, rufen Sie Novita mit einem API-Schlüssel auf und wählen die gewünschte Suchmaschine pro Anfrage aus. Dieser Leitfaden bringt Sie in wenigen Minuten von null zu einer funktionierenden Websuche. Sie authentifizieren sich mit einem einzigen Novita API-Schlüssel, führen eine Suche aus und sehen, wie Sie Anbieter wechseln können, ohne Ihre Einrichtung zu ändern.

Bevor Sie beginnen

Ein Novita-Konto und ein API-Schlüssel. Siehe API-Schlüsselverwaltung, um einen zu erstellen.
Exportieren Sie Ihren Schlüssel, damit die folgenden Beispiele ihn verwenden können. NOVITA_API_KEY ist einfach Ihr Novita API-Schlüssel aus Schritt 1 — derselbe Schlüssel funktioniert für jeden Anbieter:

export NOVITA_API_KEY="<Your API Key>"

Alle AI Search-Endpunkte verwenden dieselbe Basis-URL und Authentifizierung:

Basis-URL: https://api.novita.ai
Auth-Header: Authorization: Bearer <api_key>
Content-Type: application/json

Ihre erste Suche

Das folgende Beispiel führt eine Exa-Suche aus. Jede Anfrage besteht einfach aus einer Route plus einem JSON-Body.

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}`);
}

Suchmaschinen wechseln

Eine Suchmaschine zu wechseln bedeutet, die Route und den Request-Body an den Anbieter anzupassen — Ihr Schlüssel, Host und Auth-Header bleiben gleich. Hier ist dieselbe Absicht für Tavily ausgedrückt:

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
  }'

Beachten Sie die kleinen Unterschiede: Exa verwendet numResults, Tavily verwendet max_results. Die vollständige Parameterliste jedes Anbieters finden Sie in seiner API-Referenz.

Eigenes Anbieter-SDK verwenden

AI Search ist eine Passthrough-Integration, daher funktioniert das offizielle SDK eines Anbieters, solange es Ihnen erlaubt, die Basis-URL zu überschreiben — verweisen Sie es auf die passende Gateway-Route und übergeben Sie Ihren Novita-Schlüssel. Das Exa Python SDK akzeptiert zum Beispiel eine 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)

Wenn ein SDK keine Einstellung für die Basis-URL bereitstellt, rufen Sie die REST-Endpunkte einfach direkt mit einem beliebigen HTTP-Client auf, wie oben gezeigt — dieser Weg funktioniert immer.

Funktionsweise

Novita stellt jeden Anbieter als Passthrough-Endpunkt bereit. Ihre Anfrage wird mit Ihrem Novita API-Schlüssel authentifiziert und anschließend an den Upstream-Anbieter weitergeleitet, wobei das anbieter-eigene Anfrage- und Antwortformat verwendet wird.

Ein Zugangsschlüssel. Verwenden Sie Ihren vorhandenen Novita API-Schlüssel als Bearer <api_key> für jeden Anbieter.
Anbieter-native Bodies. Anfrage- und Antwortstrukturen entsprechen dem Upstream-Anbieter, sodass die eigenen Beispiele und Anfrageformate des Anbieters übernommen werden können — richten Sie einfach die Basis-URL auf Novita aus.
Engines pro Anfrage austauschen. Anbieter zu wechseln bedeutet, Route und Body zu ändern, nicht Ihre Authentifizierung oder Ihre Kontoeinrichtung.

Das ist immer dann nützlich, wenn ein Modell Informationen benötigt, auf die es nicht trainiert wurde: aktuelle Ereignisse, sich schnell ändernde Dokumentation, Preise oder jede Tatsache, die im offenen Web zu finden ist. Kombinieren Sie es mit der LLM API, um Retrieval-Augmented Generation (RAG), Research Agents und webbasierte Assistenten zu erstellen.

Unterstützte Anbieter

Exa

Neuronale und semantische Websuche mit integrierter Inhaltsextraktion und Antwortsynthese. Stark für Recherche, das Finden von Seiten nach Bedeutung und strukturierte Ausgabe.

Tavily

Schnelle, LLM-optimierte Suche und Retrieval mit Site-Crawling und Mapping. Stark für Nachrichten- und Finanzthemen, Extraktionspipelines und Lookups mit niedriger Latenz.

Funktionen auf einen Blick

Funktion	Was sie macht	Exa	Tavily
Suche	Relevante Seiten anhand einer Abfrage finden	Search	Search
Inhaltsextraktion	Sauberen Text/metadata aus URLs extrahieren	Contents	Extract
Antwortsynthese	Eine zitierte Antwort aus Ergebnissen generieren	Answer	über `include_answer`
Site-Crawling	Links folgen, um viele Seiten zu sammeln	—	Crawl
Site-Mapping	Erreichbare URLs einer Site ermitteln	—	Map

Endpunktreferenz

Anbieter	Endpunkt	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`

Fehlerbehebung

400 Bad Request — ein Parameter entspricht nicht dem Schema des Anbieters. Prüfen Sie, ob Sie die Feldnamen dieses Anbieters verwenden (zum Beispiel numResults vs. max_results).
429 Too Many Requests — Sie haben ein Rate Limit erreicht. Warten Sie kurz und versuchen Sie es erneut, oder reduzieren Sie das Anfragevolumen.

Die vollständige Liste finden Sie im Abschnitt „Errors“ auf einer beliebigen AI Search-API-Referenzseite.

Wohin als Nächstes

Webbasierte Antworten & RAG

Speisen Sie Suchergebnisse in die LLM API ein, um Retrieval-Augmented-Generation-(RAG)-Pipelines mit zitierten Antworten zu erstellen.

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

Schnellstart

Bevor Sie beginnen

Ihre erste Suche

Suchmaschinen wechseln

Eigenes Anbieter-SDK verwenden

Funktionsweise

Unterstützte Anbieter

Exa

Tavily

Funktionen auf einen Blick

Endpunktreferenz

Fehlerbehebung

Wohin als Nächstes

Webbasierte Antworten & RAG

​Bevor Sie beginnen

​Ihre erste Suche

​Suchmaschinen wechseln

​Eigenes Anbieter-SDK verwenden

​Funktionsweise

​Unterstützte Anbieter

Exa

Tavily

​Funktionen auf einen Blick

​Endpunktreferenz

​Fehlerbehebung

​Wohin als Nächstes

Webbasierte Antworten & RAG

Bevor Sie beginnen

Ihre erste Suche

Suchmaschinen wechseln

Eigenes Anbieter-SDK verwenden

Funktionsweise

Unterstützte Anbieter

Funktionen auf einen Blick

Endpunktreferenz

Fehlerbehebung

Wohin als Nächstes