Erste Schritte
Was ist AI Search?
AI Search ist ein einzelnes Novita-Gateway, das Ihrer Anwendung Live-Zugriff auf die Websuche bietet. Sie rufen Novita mit einem API-Schlüssel auf und wählen pro Anfrage einen Suchanbieter aus, anstatt sich bei jedem Anbieter separat zu registrieren. Siehe den Schnellstart für den vollständigen Überblick.Welche Anbieter werden unterstützt?
Derzeit Exa und Tavily. Jeder wird als Passthrough-Endpunkt bereitgestellt, der das eigene Anfrage- und Antwortformat des Anbieters widerspiegelt. Siehe den Quickstart für die Endpunktliste.Benötige ich ein separates Exa- oder Tavily-Konto?
Nein. Ihr Novita-API-Schlüssel authentifiziert jede AI Search-Anfrage. Sie müssen keine Schlüssel oder Konten von Upstream-Anbietern verwalten.Authentifizierung & Einrichtung
Wie authentifiziere ich mich?
Verwenden Sie Ihren Novita-API-Schlüssel als Bearer-Token:Authorization: Bearer <api_key>. Derselbe Schlüssel funktioniert für jeden Anbieter. Informationen zum Erstellen oder Verwalten von Schlüsseln finden Sie unter API-Schlüsselverwaltung.
Gibt es ein Novita SDK für AI Search?
Nein — und du brauchst auch keines. AI Search ist eine Integration, kein verpacktes Produkt: Jeder Endpoint ist ein Passthrough, der deine Anfrage im nativen Format des jeweiligen Anbieters an den Provider (Exa oder Tavily) weiterleitet. Das bedeutet, du hast zwei solide Optionen:- Verwende das eigene SDK des Providers. Wenn das SDK es erlaubt, eine benutzerdefinierte Basis-URL festzulegen, richte sie auf die passende Gateway-Route aus und übergib deinen Novita-Schlüssel. Zum Beispiel akzeptiert das Exa Python SDK
base_url="https://api.novita.ai/v3/exa". Siehe Schnellstart für ein vollständiges Beispiel. - Rufen Sie die REST-Endpunkte direkt auf. Funktioniert mit jedem HTTP-Client und benötigt überhaupt kein SDK. Der Schnellstart zeigt Beispiele für curl, Python und JavaScript.
Kann ich den Anbieter wechseln, ohne meine Codestruktur zu ändern?
Größtenteils. Authentifizierung, Host und der Anfrageablauf bleiben identisch — Sie ändern die Route (z. B./v3/tavily/search → /v3/exa/search) und den Body an den Feldnamen dieses Anbieters ausrichten (zum Beispiel Tavilys max_results im Vergleich zu Exas numResults).
Suchverhalten
Wie aktuell sind die Ergebnisse?
Die Ergebnisse spiegeln Live-Webinhalte wider. Bei zeitkritischen Fragen schränke nach Datum ein, um veraltete Seiten auszuschließen: Tavily bietettime_range und start_date/end_date; Exa stellt bereit startPublishedDate/endPublishedDate.
Wie beschränke ich Ergebnisse auf vertrauenswürdige Websites?
Verwenden Sie Domain-Filter —include_domains/exclude_domains auf Tavily, includeDomains/excludeDomains auf Exa — um den Abruf auf Quellen zu beschränken, denen Sie vertrauen.
Was ist der Unterschied zwischen search, extract und crawl?
- Search findet relevante Seiten anhand einer Abfrage.
- Extract / Contents zieht bereinigten Text aus URLs, die Sie bereits haben.
- Crawl / Map folgt Links, um viele Seiten einer Website zu sammeln oder aufzulisten.
Kann AI Search eine Antwort generieren, nicht nur Links?
Ja. Tavily Search gibt eine LLM-Antwort zurück, wenn Sieinclude_answer, und Exa bietet eine dedizierte Answer-Endpunkt. Für die vollständige Kontrolle über Formulierungen und Quellenangaben rufen Sie Ergebnisse ab und synthetisieren Sie sie mit der LLM API stattdessen — siehe Web-gestützte Antworten.
Limits & Fehlerbehebung
Welche Rate Limits gelten?
AI Search-Anfragen unterliegen sowohl den Limits der Novita-Plattform als auch den eigenen Limits jedes Upstream-Anbieters, die von der mit Ihrem Konto verknüpften Anbieter-Stufe abhängen. Wenn Sie ein Limit überschreiten, gibt die API zurück429 Too Many Requests — warten Sie und versuchen Sie es mit exponentieller Verzögerung erneut. Diese Limits sind von der LLM API Ratenlimits; ein Suchaufruf verbraucht dein LLM-Kontingent nicht.
Warum erhalte ich einen 400-Fehler?
Ein Parameter entspricht wahrscheinlich nicht dem Schema des Anbieters. Stelle sicher, dass du die Feldnamen dieses Anbieters verwendest — eine häufige Ursache ist das Senden von Tavilysmax_results an eine Exa-Route (die erwartet numResults).