SDK-compatibiliteit en instelling van de basis-URL
Verbind je bestaande clientcode door deze naar ons speciale eindpunt te wijzen. Dit openai compatibele API accepteert standaard headers en SDK-configuraties zonder codeaanpassingen. Je hoeft alleen de basis-URL te updaten en je API-sleutel uit het dashboard te verstrekken.
https://api.openrouterratelimits.com/v1 is het enige invoerpunt voor alle verzoeken. Authenticatie gebruikt de standaard Bearer-tokenmethode die in de meeste moderne LLM-bibliotheken wordt gebruikt. Geef je sleutel op in de Authorization header om je identiteit te verifiëren. Deze setup werkt met elke client die een OpenAI-achtige interface verwacht, waardoor migratie direct mogelijk is voor teams die klaar zijn met vendor lock-in.
- Basis-URL:
https://api.openrouterratelimits.com/v1 - Auth Header:
Authorization: Bearer YOUR_API_KEY - Model-ID:
uncensored
Streamingresponsen met SSE
Activeer streaming door stream: true in je request payload. De API retourneert Server-Sent Events (SSE) voor real-time tokenlevering. Elke chunk bevat de gegenereerde tekst totdat de laatste chunk verbruiksstatistieken bevat. Deze aanpak houdt je UI responsief, zelfs voor lange contextvensters.
Streaming is ideaal voor chatinterfaces of roleplay-scenario's waarbij latentie belangrijk is. Je hoeft niet te wachten tot de volledige voltooiing om tekst weer te geven. Het laatste chunk bevat altijd de tokenaantallen voor accurate facturering. Fouten tijdens streaming retourneren nog steeds juiste HTTP-statuscodes voor directe afhandeling.
Function calling en JSON-modus
Gebruik gestructureerde uitvoer voor betrouwbare gegevensextractie of toolintegratie. Schakel response_format met {"type": "json_object"} om JSON-conformiteit af te dwingen. Deze modus is essentieel voor het parseren van complexe geneste structuren zonder extra opschonklogica. Function calling werkt naast standaard tekstgeneratie voor dynamische agent-workflows.
Definieer je tools in de tools array en specificeren tool_choice voor strikte afdwinging. Het model retourneert functieaanroepen in het standaard OpenAI-formaat. Deze functie ondersteunt zowel enkele als meerdere toolaanroepen binnen één beurt. Gebruik dit voor het bouwen van agents die betrouwbaar communiceren met externe API's of databases.
Tokens en parameters beheren
Reguleer het generatiegedrag met standaardparameters zoals temperature, top_p, en stop. Het contextvenster ondersteunt maximaal 100.000 tokens voor prompt en completion gecombineerd. Dit stelt je in staat uitgebreide historische context of grote documentverwerking in één verzoek te verwerken.
Instellen max_tokens om de uitvoerlengte te beperken, met een standaard van 2.048 als dit wordt weggelaten. Het model verwerkt presence_penalty en frequency_penalty voor stijlcontrole. Tokengebruik wordt gefactureerd op basis van daadwerkelijke input- en outputtellingen. Fouten verbruiken geen tokens, wat zorgt voor eerlijke facturatie bij mislukte requests.
Rate limits per sleutel begrijpen
Elke API-sleutel ondersteunt 300 verzoeken per minuut met een gelijktijdigheidslimiet van 8 gelijktijdige verzoeken. Deze limiet geldt per sleutel, dus het aanmaken van meerdere sleutels schaalt je doorvoer lineair. De maximale grootte van de request body is 8 MB, wat past binnen het contextvenster voor de meeste use cases.
Rate limits resetten continu op basis van een sliding window. Als je de limiet overschrijdt, retourneert de API een 429 fout. Upgrade je prepaid credit om prioriteitstoegang te behouden. In tegenstelling tot gedeelde tiers, lijden onze dedicated servers niet onder 'neighbor noise'. Houd je gebruiksdashboard bij om binnen deze grenzen te blijven voor consistente prestaties.
Problemen oplossen met veelvoorkomende fouten
Verwerk fouten door de HTTP-statuscode en response body te controleren. Een 401-fout geeft een ongeldige of ontbrekende API-sleutel aan. Genereer je sleutel opnieuw via het dashboard als authenticatie mislukt. Een 402-fout betekent dat je vooruitbetaalde tegoed op is; vul aan via crypto om de dienst te hervatten.
Een 429-fout geeft aan dat u de rate limits heeft overschreden. Verlaag uw verzoekfrequentie of verdeel de workload over meerdere sleutels. De API rekent geen tokens voor deze fouten, dus u verliest geen tegoed voor retries. Zorg dat uw clientbibliotheek retries afhandelt met exponentiële backoff voor robuustheid.
cURL
curl https://api.openrouterratelimits.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Process one million logs"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterratelimits.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterratelimits.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Streaming
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)