Aan de slag
Wat is AI Search?
AI Search is één Novita-gateway die je applicatie live toegang geeft om op het web te zoeken. Je roept Novita aan met één API-sleutel en kiest per verzoek een zoekprovider, in plaats van je afzonderlijk bij elke provider aan te melden. Zie de Snelstart voor het volledige beeld.Welke providers worden ondersteund?
Momenteel Exa en Tavily. Elk wordt aangeboden als een passthrough-endpoint dat de eigen aanvraag- en responsindeling van de provider weerspiegelt. Zie de Quickstart voor de lijst met endpoints.Heb ik een apart Exa- of Tavily-account nodig?
Nee. Je Novita API-sleutel authenticeert elke AI Search-aanvraag. Je beheert geen upstream provider-sleutels of -accounts.Authenticatie & installatie
Hoe authenticeer ik?
Gebruik je Novita API-sleutel als bearer token:Authorization: Bearer <api_key>. Dezelfde sleutel werkt voor elke provider. Zie voor het aanmaken of beheren van sleutels API-sleutelbeheer.
Is er een Novita SDK voor AI Search?
Nee — en je hebt er geen nodig. AI Search is een integratie, geen verpakt product: elk endpoint is een passthrough die je request doorstuurt naar de provider (Exa of Tavily) in het native format van die provider. Dat betekent dat je twee solide opties hebt:- Gebruik de eigen SDK van de provider. Als de SDK je een aangepaste base URL laat instellen, wijs die dan naar de bijbehorende gateway-route en geef je Novita key mee. De Exa Python SDK accepteert bijvoorbeeld
base_url="https://api.novita.ai/v3/exa". Zie de Snelstart voor een volledig voorbeeld. - Roep de REST-eindpunten rechtstreeks aan. Werkt met elke HTTP-client en heeft helemaal geen SDK nodig. De Snelstart toont curl-, Python- en JavaScript-voorbeelden.
Kan ik van provider wisselen zonder mijn codestructuur te wijzigen?
Grotendeels. Authenticatie, host en de request-flow blijven identiek — je wijzigt de route (bijv./v3/tavily/search → /v3/exa/search) en stem de body af op de veldnamen van die provider (bijvoorbeeld die van Tavily max_results vs die van Exa numResults).
Zoekgedrag
Hoe actueel zijn de resultaten?
Resultaten weerspiegelen live webcontent. Voor tijdgevoelige vragen, beperk op datum om verouderde pagina’s uit te sluiten: Tavily stelttime_range en start_date/end_date; Exa stelt beschikbaar startPublishedDate/endPublishedDate.
Hoe beperk ik resultaten tot vertrouwde sites?
Gebruik domeinfilters —include_domains/exclude_domains op Tavily, includeDomains/excludeDomains op Exa — om retrieval binnen bronnen te houden die je vertrouwt.
Wat is het verschil tussen search, extract en crawl?
- Search vindt relevante pagina’s op basis van een query.
- Extract / Contents haalt schone tekst op uit URL’s die je al hebt.
- Crawl / Map volgt links om veel pagina’s van een site te verzamelen of op te sommen.
Kan AI Search een antwoord genereren, niet alleen links?
Ja. Tavily Search retourneert een LLM-antwoord wanneer je insteltinclude_answer, en Exa biedt een speciale Antwoord endpoint. Voor volledige controle over formulering en citaties, haal resultaten op en synthetiseer met de LLM-API in plaats daarvan — zie Web-onderbouwde antwoorden.
Limieten & probleemoplossing
Wat zijn de rate limits?
AI Search-aanvragen zijn onderworpen aan zowel de limieten van het Novita-platform als de eigen limieten van elke upstream-provider, die afhankelijk zijn van het providerniveau dat aan je account is gekoppeld. Wanneer je een limiet overschrijdt, retourneert de API429 Too Many Requests — wacht en probeer het opnieuw met exponentiële vertraging. Deze limieten staan los van de LLM-API snelheidslimieten; een zoekaanroep verbruikt je LLM-quotum niet.
Waarom krijg ik een 400-fout?
Een parameter komt waarschijnlijk niet overeen met het schema van de provider. Controleer of je de veldnamen van die provider gebruikt — een veelvoorkomende oorzaak is het verzenden van Tavily’smax_results naar een Exa-route (die verwacht numResults).