De basis-URL begrijpen
De base URL bepaalt waar je client verzoeken naartoe stuurt. Een mismatch hier leidt direct tot verbindingsfouten of onverwachte modelresponsen. Veel ontwikkelaars gaan ervan uit dat de standaard OpenAI-URL universeel werkt, maar ongecensureerde aanbieders gebruiken vaak aparte endpoints om verkeer naar specifieke modelclusters te routeren.
Controleer of uw configuratie verwijst naar https://api.openrouterabliteratedmodels.com/v1 voor onze service. Als je een derde partij aggregator gebruikt, zorg er dan voor dat de basis-URL exact overeenkomt met hun documentatie. Onjuiste URLs leiden vaak tot 404-fouten of antwoorden van standaardmodellen in plaats van de bedoelde ongecensureerde variant.
- Controleer je omgevingsvariabelen voor
BASE_URLofAPI_HOST. - Zorg ervoor dat het pad bevat
/v1voor standaard compatibiliteit. - Test de connectiviteit met een eenvoudig modellijstverzoek voordat je zwaar gebruik maakt.
Snelheidslimieten verwerken
Rate limits beperken hoeveel verzoeken je binnen een bepaalde tijd kunt versturen. Onze API hanteert een limiet van 300 verzoeken per minuut per sleutel. Overschrijding van deze drempel resulteert in HTTP 429-fouten, waardoor verdere verzoeken tijdelijk worden geblokkeerd tot het venster wordt gereset.
Er is een limiet voor gelijktijdige verzoeken van 8 gelijktijdige verzoeken per sleutel. Als je meer dan 8 gelijktijdige verzoeken verzendt, worden de overschotten gewacht of mislukken, afhankelijk van je clientbibliotheek. Monitor de concurrency van je applicatie om te voorkomen dat je tegen deze harde limieten aanloopt. Gebruik strategieën voor exponentiële backoff in je code om 429-fouten soepel af te handelen zonder de server te spammen.
Onthoud dat elke sleutel uniek is voor je account. Sleutels delen over meerdere diensten kan leiden tot het sneller bereiken van deze limieten. Genereer een nieuwe sleutel als je aparte snelheidslimiet-pools nodig hebt voor verschillende delen van je applicatie.
Streaming vs. Niet-streaming responsen
Streaming retourneert gegevens incrementaal terwijl tokens worden gegenereerd, terwijl niet-streamende methoden wachten op de volledige respons. Streaming is essentieel voor real-time gebruikerservaringen, maar vereist zorgvuldige verwerking van Server-Sent Events (SSE).
Bij streaming bevat de laatste chunk de tokengebruiksstatistieken. Als u eerder stopt met verwerken, mist u mogelijk deze gegevens. Zorg ervoor dat uw client het laatste SSE-bericht parseert om het invoer- en uitvoertokenaantal nauwkeurig op te halen. Niet-streamingresponsen zijn eenvoudiger, maar kunnen hoge latentie veroorzaken voor lange outputs.
Kies streaming voor chatinterfaces waar gebruikers tekst zien verschijnen, karakter voor karakter. Gebruik niet-streaming voor batchverwerking of wanneer je de volledige respons nodig hebt voordat je doorgaat. Onze API ondersteunt beide modi via de stream parameter in het requestbody.
JSON-modusfouten
JSON-modus zorgt ervoor dat het model geldige JSON uitvoert, wat kritiek is voor programmele integratie. Fouten hier ontstaan vaak door incorrecte headers of schema-mismatches. De API vereist response_format: {"type": "json_object"} om strikte JSON-uitvoer af te dwingen.
Als u malformed JSON ontvangt, controleer dan uw schema-definitie. Het model kan markdown-codeblokken of verklarende tekst bevatten buiten de JSON-structuur. Gebruik een robuuste parser die markdown fences kan verwijderen of de output kan valideren tegen uw verwachte schema. Vermijd te complexe schema's die het model in verwarring brengen.
Test eerst met eenvoudige structuren. Voeg geleidelijk complexiteit toe om te identificeren waar het model moeite mee heeft. Zorg dat uw temperatuur correct is ingesteld, aangezien hogere temperaturen de willekeurigheid kunnen verhogen en de JSON-geldigheid kunnen verminderen.
Foutieve berekeningen van het aantal tokens
Tokenaantallen bepalen je facturatie en contextvenstergebruik. Foutieve berekeningen kunnen leiden tot onverwachte kosten of afgekapt antwoord. Onze API rekent $0.15 per 1M inputtokens en $0.50 per 1M outputtokens.
Gebruik een betrouwbare tokenizer-bibliotheek die overeenkomt met de tokenisatieschema van het model. Verschillende modellen tokeniseren spaties of leestekens mogelijk anders, wat leidt tot discrepanties tussen je lokale telling en de API-telling. Vertrouw altijd op het tokengebruik dat in de respons wordt geretourneerd voor accurate facturatie.
Houd je contextvenster in de gaten, dit is in totaal 100.000 tokens. Het overschrijden van deze limiet leidt tot fouten. Knip oudere berichten of samenvattingen bij om binnen de grenzen te blijven. Monitor je tokenverbruik in de tijd om je promptstructuur te optimaliseren en kosten te verlagen.
Vertragingen bij crypto-betalingen
Crypto-opwaarderingen via USDT (TRC20) of USDC (Base) worden direct aan onze kant verwerkt. Netwerkcongestie kan echter soms voor kleine vertragingen in de bevestiging zorgen. Zorg dat je het juiste bedrag en netwerk verzendt om verlies te voorkomen.
Opladingen variëren van $20 tot $500 in gehele bedragen. Bonus tegoeden worden automatisch toegepast: +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Verifieer de transactiehash om de betaling te bevestigen. Als het tegoed binnen een paar minuten niet verschijnt, controleer dan de blockchain explorer voor de transactiestatus.
Krediet vervalt nooit, dus er is geen haast om het direct te gebruiken. Fouten zoals dubbele afschrijvingen worden opgelost via de Support-pagina. Bewaar je transactieoverzichten voor eenvoudig raadplegen bij problemen.
Configuratie van model-ID
De model-ID identificeert welke versie van het uncensored-model je gebruikt. Voor onze service is de model-ID uncensored. Een incorrect ID kan leiden tot fouten of onverwacht gedrag.
Zorg ervoor dat je verzoeken model: "uncensored" in de request body. Deze ID verwijst naar ons specifieke open-weight model dat is afgestemd op onbeperkte responsen. Het is geen generieke identifier, maar een specifieke pointer naar onze gehoste instantie.
Controleer de documentatie van je clientbibliotheek voor het instellen van de model-ID. Sommige bibliotheken gebruiken een model veld, terwijl anderen misschien een andere parameter gebruiken. Consistentie in het gebruik van de model-ID in uw applicatie voorkomt verwarring en zorgt ervoor dat u altijd het bedoelde uncensored-model aanroept.
Contextvensteroverschrijdingen
Het contextvenster beperkt het totale aantal tokens dat je in één verzoek kunt versturen. Onze API ondersteunt een venster van 100.000 tokens, inclusief zowel prompt als voltooiing. Het overschrijden van deze limiet resulteert in een fout.
Om context te beheren, implementeer je een sliding window-strategie. Verwijder oudere berichten of vat ze samen om ruimte vrij te maken. Monitor het tokenaantal van je invoer om ervoor te zorgen dat het binnen de limiet van 100,000 tokens blijft. Als je de limiet overschrijdt, wordt het verzoek door de API afgewezen.
Gebruik de max_tokens parameter om de uitvoerlengte te bepalen. De maximale uitvoer per verzoek is 16.000 tokens. Het instellen van deze parameter helpt overmatig tokengebruik te voorkomen en houdt antwoorden binnen hanteerbare grenzen voor je applicatie.
Support- en terugbetalingsbeleid
Credit wordt niet terugbetaald zodra het is verbruikt, maar het verloopt niet. Als je problemen ondervindt met betalingen of de service, neem dan contact op met Support via de daarvoor bestemde pagina. Fouten zoals dubbele charges worden opgelost door het Support-team.
Voor technische problemen, raadpleeg eerst de documentatie. Onze API is overzichtelijk, maar er kunnen randgevallen optreden. Geef je API-sleutel en aanvraagdetails op wanneer je hulp zoekt. Reactietijden variëren, maar we streven ernaar problemen snel op te lossen.
Onthoud dat credit vooraf betaald wordt. Je betaalt voor wat je verbruikt, waarbij fouten en weigeringen gratis zijn. Dit model zorgt voor transparantie in de facturering. Gebruik de Support-pagina voor eventuele onregelmatigheden of vragen over je account.
