OpenRouter API Productie Checklist

Verifieer API-compatibiliteit en Eindpunten

Gebruik de standaard OpenAI-compatibele endpoints voor een betrouwbare integratie.

Het primaire eindpunt is POST /v1/chat/completions. Dit verwerkt tekstgeneratie voor chatgeschiedenissen. Een secundair endpoint, GET /v1/models, lijst beschikbare modellen op. U hebt geen embeddings- of image generatie-eindpunten nodig voor teksttaken. Veel ontwikkelaars denken dat ze een complexe rlaag nodig hebben. OpenRouter vereenvoudigt dit door een enkel toegangspunt bloot te leggen. U verzendt een JSON-payload met uw model-ID en systeemprompts. De service retourneert gestructureerde JSON met inhoud en gebruiksgegevens. Dit ontwerp komt overeen met de verwachtingen van de officiële OpenAI SDK. U kunt modellen wisselen zonder uw clientcode te wijzigen. Werk gewoon de model-ID in uw configuratie bij. Zorg ervoor dat uw client de nieuwste JSON-schema ondersteunt. Oudere versies kunnen nieuwe parameters mogelijk afwijzen. Test uw verbinding voordat u naar productie gaat. Verifieer dat het responsformaat overeenkomt met uw parser.

Configureer authenticatie en keys

Beveilig je API-sleutel onmiddellijk na generatie in omgevingsvariabelen.

Genereer een sleutel via het dashboard van de provider. Bewaar deze op een veilige locatie. Voeg deze niet hardcoded toe aan je broncode. Voeg deze toe via de Authorization: Bearer <key> header. Elke sleutel is gekoppeld aan een specifiek account. Je kunt sleutels draaien als je een lek vermoedt. Sommige providers staan meerdere sleutels per account toe. Dit stelt je in staat verkeer voor ontwikkeling en productie te scheiden. Monitor het verbruik per sleutel om anomalieën te detecteren. Intrek ongebruikte sleutels regelmatig. Gebruik kortlevende sleutels voor tijdelijke scripts. Dit verkleint de impact van een inbreuk. Zorg ervoor dat je SDK-versie bearer token-authenticatie ondersteunt. Oudere bibliotheken vereisen mogelijk een andere header-indeling. Controleer de documentatie voor je specifieke SDK. Controleer of de sleutel voldoende saldo heeft. Een verlopen sleutel retourneert een 401-fout. Een sleutel met een saldo van nul retourneert een 402-fout. Maak in je logica onderscheid tussen deze twee statussen.

Afhandelen van Streaming en Tokengebruik

Schakel streaming in voor lagere latentie en real-time gebruikersfeedback.

Instellen stream: true in je request payload. De server stuurt een reeks Server-Sent Events (SSE). Elk evenement bevat een gedeeltelijke tekstchunk. Je moet deze chunks samenvoegen tot het volledige antwoord. De laatste chunk bevat vaak tokenverbruiksstatistieken. Hiermee kun je kosten real-time bijhouden. Zonder streaming wacht je op het volledige antwoord. Dit verhoogt de waargenomen latentie aanzienlijk. Streaming is essentieel voor chatinterfaces. Het creëert een typ-effect dat responsief aanvoelt. Wees voorzichtig met foutafhandeling tijdens streaming. Als de verbinding verbroken wordt, verlies je de huidige chunk. Reconnectielogica moet de conversatiestatus behouden. Sommige SDKs verwerken streaming automatisch. Andere vereisen handmatige event listeners. Kies de aanpak die past bij je architectuur. Zorg ervoor dat je parser onvolledige JSON-chunks verwerkt. Ga er niet van uit dat elk evenement een compleet object is. Buffer de gegevens totdat je een geldige structuur hebt.

Rate Limits en gelijktijdigheid monitoren

Volg je verzoeken per minuut om serviceonderbrekingen te voorkomen.

OpenRouter handhaaft strikte rate limits per API-sleutel. Het overschrijden van deze limieten leidt tot een 429 Too Many Requests-fout. Je moet exponentiële backoff implementeren in je retry-logica. Gelijktijdige verzoeken tellen ook mee voor je limieten. Controleer de responshdrs voor resterende quota. Sommige aanbieders tonen deze headers direct. Anderen vereisen dat je limieten afleidt uit fouten. Hoge concurrency kan je verbindingenpool uitputten. Zorg ervoor dat je client verbindingen efficiënt beheert. Gebruik connection pooling om overhead te verminderen. Monitor je wachtrijgrootte tijdens piekbelasting. Als je de limiet raakt, wacht dan voordat je opnieuw probeert. Randomiseer je wachttijd om thundering herd-problemen te vermijden. Log alle rate limit-events voor foutopsporing. Dit helpt patronen in je gebruik te identificeren. Pas je concurrency-instellingen aan op basis van deze logs. Ga er niet van uit dat een enkele sleutel onbeperkt verkeer kan afhandelen. Verdeel de belasting over meerdere sleutels indien nodig. Dit vereist zorgvuldig state management. Zorg ervoor dat elke sleutel zijn eigen context behoudt indien nodig.

Crypto-billing en opwaarderingen beheren

Gebruik vooruitbetaald krediet om tokengebruik te dekken zonder maandelijkse kosten.

Laad je account op met cryptocurrency. Ondersteunde netwerken zijn USDT op TRC20 en USDC op Base. Minimale stortingen beginnen bij $20. Bonussen zijn van toepassing op grotere bedragen. Je ontvangt 5% extra voor $50, 10% voor $100 en 15% voor $200. Krediet verloopt niet. Dit is ideaal voor langetermijnprojecten. Je betaalt alleen voor daadwerkelijk gebruikte tokens. Fouten en weigeringen zijn gratis. Dit beschermt je budget tegen onverwachte kosten. Nieuwe accounts krijgen $0.50 voor testen. Restituties worden niet uitgegeven voor standaardaankopen. Dubbele belastingen worden gecorrigeerd via support. Zorg dat je wallet de vereiste netwerken ondersteunt. Verifieer het contractadres voordat je verzendt. Verkeerde netwerken kunnen leiden tot verloren fondsen. Controleer regelmatig je saldo. Een laag saldo kan de service onverwacht onderbreken. Automatiseer stortingen indien mogelijk. Dit zorgt voor continue beschikbaarheid voor kritieke taken.

Test inhoudsfilters en weigeringen

Verifieer dat het model zich gedraagt zoals verwacht met uncensored prompts.

Uncensored modellen kunnen nog steeds harde limieten toepassen. Controleer beperkingen op specifieke inhoudstypen. Test met bekende triggerzinnen. Zorg ervoor dat het model op de juiste manier reageert. Sommige providers behouden filters om wettelijke redenen. Verifieer deze voordat je je op het model verlaat voor gevoelige gegevens. Test randgevallen in je domein. Stuur prompts die normaal gesproken weigeringen triggeren. Observeer het responsformaat. Geeft het een reden voor de weigering terug? Of genereert het inhoud stil? Documenteer dit gedrag in je integratietests. Dit voorkomt verrassingen in productie. Als het model zijn gedrag verandert, update dan je tests. Meld je team van eventuele significante verschuivingen. Consistentie is cruciaal voor gebruikersvertrouwen. Zorg ervoor dat je applicatie weigeringen soepel afhandelt. Ga er niet van uit dat elke respons geldig is. Valideer de outputstructuur. Controleer op hallucinaties of formatteringsfouten. Dit zorgt voor een betrouwbare gebruikerservaring.

Implementeer foutafhandeling voor gratis verzoeken

Handel fouten soepel af om een soepele gebruikerservaring te behouden.

Netwerkfouten, time-outs en serverfouten kunnen optreden. Implementeer retry-logica met exponentiële backoff. Maak onderscheid tussen tijdelijke en permanente fouten. Een 429-fout is tijdelijk. Wacht en probeer opnieuw. Een 400-fout is permanent. Controleer je invoergegevens. Een 500-fout is serverkant. Probeer opnieuw met voorzichtigheid. Log alle fouten voor debugging. Voeg de request payload en response body toe. Dit helpt problemen snel te reproduceren. Toon ruwe fouten niet aan gebruikers. Formatteer ze naar gebruikersvriendelijke berichten. Verwerk streamingfouten zorgvuldig. Koppel de verbinding met de event stream los. Ruim resources op. Zorg dat je applicatie geen geheugenlekken heeft. Test foutscenario's grondig. Simuleer netwerkuitval. Simuleer server time-outs. Verifieer dat je herstellogica werkt. Dit zorgt voor betrouwbaarheid onder ongunstige omstandigheden.

Schaal met JSON-modus en Tool Calling

Gebruik gestructureerde uitvoer voor betrouwbare gegevensextractie en functiewerking.

Schakel JSON-modus in door response_format: {type: "json_object"}. Dit forceert het model om geldige JSON uit te voeren. Gebruik dit voor het parseren van data of het genereren van configuraties. Tool calling stelt het model in staat functies uit te voeren. Definieer je tools in de request payload. Het model beslist wanneer ze aan te roepen. Voer de resultaten terug naar het model. Het kan een eindantwoord genereren op basis van de uitvoer. Dit creëert een lus voor complexe taken. Zorg dat je tooldefinities duidelijk zijn. Dubbelzinnige tools leiden tot onjuiste calls. Valideer de JSON-uitvoer voordat je deze parseert. Dit voorkomt runtime-fouten in je code. Gebruik tool calling voor data-extractietaken. Dit verbetert de nauwkeurigheid aanzienlijk. Test met verschillende invoerformaten. Zorg dat het model omgaat met edge cases. Documenteer de beschikbare tools voor je team. Dit zorgt voor consistent gebruik over projecten heen.

Review Privacy- en Gegevensgebruiksbeleid

Begrijp hoe je gegevens worden opgeslagen en gebruikt door de provider.

Controleer het privacybeleid voor details over gegevensbewaring. Sommige aanbieders gebruiken je gegevens voor training. Anderen houden ze privé. Zorg dat je gegevens niet worden gebruikt voor modelverbetering als dat voor jou belangrijk is. Controleer de encryptiestandaarden. Gegevens moeten versleuteld zijn tijdens overdracht en in rust. Controleer of er logs worden opgeslagen. Logs kunnen je prompts bevatten. Zorg dat deze logs veilig zijn. Bekijk de gebruiksvoorwaarden voor aansprakelijkheidsclausules. Begrijp wie eigendom is van de gegenereerde inhoud. Sommige aanbieders claimen rechten op je output. Zorg dat dit overeenkomt met je behoeften. Verwijder je account als je de dienst niet meer gebruikt. Controleer of je gegevens zijn verwijderd. Neem contact op met support als je vragen hebt. Documenteer je privacy-instellingen voor auditdoeleinden. Dit zorgt voor naleving van interne beleidsregels.