met behulp van de verkeerde base_url
Het gebruik van de standaard OpenAI base URL zorgt ervoor dat je verzoeken falen of naar een ander model worden gerouteerd. Onze API vereist dat je de base_url naar https://api.whatisopenrouterai.com/v1. Deze enkele regel configuratie zorgt ervoor dat je SDK verbindt met onze servers in plaats van de globale OpenAI-infrastructuur.
Veel ontwikkelaars kopiëren-plakken hun bestaande code zonder deze variabele bij te werken. Als je de standaard-URL laat staan, krijg je ofwel een 404-fout of raak je een model dat niet uncensored is. Controleer altijd de verbinding door de /v1/models endpoint. Je zou daar onze specifieke model-ID moeten zien staan. Dit bevestigt dat de routing correct is voordat je je eerste voltooiingsverzoek verstuurt.
vergeten de model id in te stellen
Zelfs met de juiste basis-URL resulteert het weglaten van de model-ID in een standaard of ouder model. Je moet expliciet de model parameter naar "uncensored" bij elke aanvraag. Dit vertelt onze routeringslaag om het specifieke open-weight model te serveren dat is afgestemd op onbeperkte inhoud.
Zonder deze expliciete instructie kun je een ander model ontvangen met andere alignment-regels. Sommige modellen weigeren standaard wettelijke volwassen onderwerpen. Door het forceren van de uncensored ID, garandeert u het verwachte gedrag. Controleer uw code op eventuele hardcoded modelnamen die uw SDK-standaarden kunnen overschrijven.
tokenlimieten en fouten negeren
Het overschrijden van het contextvenster van 100.000 tokens of de outputlimiet van 16.000 tokens veroorzaakt onmiddellijke verzoekfouten. Onze API handhaaft een maximale output van 16.000 tokens per verzoek. Als je niet instelt max_tokens, de standaardwaarde is slechts 2.048 tokens. Dit is vaak te kort voor complexe redeneertaken.
Fouten en weigeringen verbruiken je vooruitbetaalde tegoed niet. Mal gevormde verzoeken die rate limits raken of de lichaamsgrootte overschrijden (8 MB) tellen echter wel mee voor je quota. Monitor je response headers voor tokengebruik. Pas je prompt engineering aan om binnen het contextvenster te blijven. Dit voorkostbare hertries en zorgt voor een soepele gegevensstroom.
misverstand over prepaid-billing
Je accountsaldo is gekoppeld aan vooruitbetaald krediet, niet aan een maandabonnement. We rekenen $0.15 per 1M inputtokens en $0.50 per 1M outputtokens. Fouten zijn gratis, maar succesvolle voltooiingen verbruiken krediet. Je moet via crypto opwaarderen om de servicebeschikbaarheid te behouden.
We accepteren USDT (TRC20) of USDC (Base) voor stortingen. Minimale stortingen beginnen bij $20. Bonussen zijn van toepassing bij hogere tiers: +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Credit vervalt nooit. Zorg dat je balans positief is voordat je grote batches uitvoert. Controleer het dashboard om je huidige balans en recente transacties te verifiëren.
streaming verwarren met standaardresponsen
Streaming via SSE verandert hoe je de responsstream parseert. Standaardresponsen retourneren een enkel JSON-object. Streaming retourneert meerdere chunks. Je moet het laatste chunk verwerken om nauwkeurige tokenverbruiksstatistieken te krijgen.
Onze streamingimplementatie bevat tokengebruik in het laatste chunk. Als u de stream vroegtijdig stopt, kunt u deze gegevens missen. Zorg ervoor dat uw clientbibliotheek SSE correct ondersteunt. Dit is cruciaal voor realtime-toepassingen waarin u tokens weergeeft terwijl ze worden gegenereerd. Verkeerd geconfigureerde streaming kan leiden tot onvolledige tekst of gebroken UI-statussen.
fouten in tool_choice-configuratie
Onjuist tool_choice instellingen kunnen ervoor zorgen dat function calling niet werkt zoals bedoeld. Je kunt een specifieke tool forceren of het model de keuze laten. Foute configuratie resulteert er vaak in dat het model beschikbare functies negeert.
Gebruik tool_choice om te bepalen of het model tools automatisch aanroept. Stel het in op "auto" voor flexibiliteit of geef een tool-ID op voor strikt gedrag. Zorg dat je functiedefinities overeenkomen met het verwachte schema. Dit voorkomt runtime-fouten wanneer het model probeert een niet-bestaande functie aan te roepen. Test je tooldefinities grondig voordat je naar productie gaat.
ontbrekende json_object-modus
Zonder response_format: {"type": "json_object"}, het model kan markdown of platte tekst uitvoeren. Dit breekt parsers die strikte JSON verwachten. Schakel JSON-modus in voor consistente, parsebare output.
Deze functie is essentieel voor integratie met downstream-systemen die gestructureerde gegevens vereisen. Het vermindert de overhead voor nabewerking aanzienlijk. Valideer het uitvoerschema altijd in je clientcode. Dit zorgt voor robuustheid tegen af en toe voorkomende hallucinaties van het model. Gebruik deze modus bij het extraheren van entiteiten of het genereren van configuratiebestanden.
tarieflimietverassingen
Onze API staat 300 verzoeken per minuut per sleutel toe. Het overschrijden van deze limiet resulteert in een 429 Too Many Errors respons. Gelijktijdige verzoeken zijn beperkt tot 8 per sleutel. Plan uw gelijktijdigheidsinstellingen dienovereenkomstig.
Als u meerdere processen uitvoert, zorg er dan voor dat ze dezelfde sleutel delen of genereer aparte sleutels. Elke account ondersteunt één actieve sleutel. Een nieuwe sleutel vervangt de oude. Monitor uw rate limit headers in het antwoord. Implementeer exponentiële backoff in uw retry-logica. Dit voorkomt cascaderende fouten tijdens periodes van hoog verkeer.
vertragingen bij crypto-opwaarderingen
Cryptotransacties kunnen tijd nodig hebben om te bevestigen op de blockchain. Je krediet verschijnt mogelijk niet direct na het verzenden van geld. Gebruik het juiste netwerk: TRC20 voor USDT of Base voor USDC. Verzenden naar het verkeerde netwerk leidt tot verlies van geld.
Opwaarderingen variëren van $20 tot $500. Zorg ervoor dat je het exacte bedrag verzendt of rekening houdt met netwerktransactiekosten. Controleer de transactiekopie op de blockchain-explorer. Als krediet vertraagd is, neem dan contact op met de support met de transactie-ID. Ga er niet vanuit dat de betaling direct is mislukt. Geduld tijdens netwerkcongestie is essentieel voor soepele operaties.
