Basis-URL en authenticatie
Onze API is volledig OpenAI-compatibel, wat betekent dat je elke standaard SDK met minimale aanpassingen kunt gebruiken. De basis-URL voor alle verzoeken is https://api.openrouterapi.top/v1. Authenticatie wordt afgehandeld via een Bearer token dat wordt doorgegeven in de Authorization header. Je kunt deze sleutel direct genereren door je aan te melden met Google of een e-mailadres op ons dashboard. Houd je sleutel veilig, omdat deze directe toegang geeft tot je prepaid tegoed.
Eerste verzoek
Test de endpoint met een eenvoudige curl-opdracht. Vervang YOUR_API_KEY door je eigen sleutel. De model-ID is ingesteld op uncensored om standaard inhoudsweigeringen te omzeilen. Dit verzoek stuurt een prompt en wacht op de volledige respons.
curl https://api.openrouterapi.top/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Als de sleutel ongeldig is, ontvang je een 401-fout. Als je prepaid tegoed op is, ontvang je een 402-fout. Deze fouten verbruiken niet je tokenbalans, maar ze tellen wel mee voor je rate limit quota.
Python SDK-integratie
Het gebruik van het officiële openai Python-pakket is eenvoudig. Initialiseer de client met je basis-URL en sleutel. De SDK verwerkt de JSON-serialisatie automatisch. Dit voorbeeld toont een basis chat-completie-verzoek.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterapi.top/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)Zorg ervoor dat je de nieuwste versie van de SDK hebt geïnstalleerd. Het clientobject beheert de verbindingpool, dus je kunt het hergebruiken voor meerdere verzoeken zonder opnieuw te initialiseren.
Node SDK-integratie
Voor JavaScript-omgevingen werkt de Node SDK identiek. Geef de aangepaste basis-URL door tijdens de initialisatie. Deze aanpak stelt je in staat om ongecensureerde generatie naadloos te integreren in bestaande webapps of backenddiensten.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterapi.top/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);De Node SDK ondersteunt zowel promise-gebaseerde als async/await patronen. Foutafhandeling is consistent met andere OpenAI-compatibele diensten.
Streaming-antwoorden
Schakel streaming in door stream: true in je verzoek in te stellen. De API retourneert Server-Sent Events (SSE). Elk fragment bevat gedeeltelijke tekst. Het laatste fragment bevat de tokengebruiksstatistieken voor facturatie.
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)Prepaid tegoed wordt in rekening gebracht op basis van de daadwerkelijk gegenereerde tokens in de finale output. Streaming verandert het prijsmodel niet; je betaalt voor de tokens die succesvol worden geleverd.
Rate limits en contextvenster
Elke API-sleutel is beperkt tot 300 verzoeken per minuut en 8 gelijktijdige verzoeken. De maximale verzoeklichaamgrootte is 8 MB. Het contextvenster ondersteunt maximaal 100.000 tokens in totaal (input plus output). De maximale output per verzoek is 32.000 tokens, of 2.048 als max_tokens niet is ingesteld. Fouten zoals 401 of 402 verbruiken geen tegoed, maar tellen wel mee voor je rate limit. Weigeringen voor specifieke inhoudstypen zijn ook gratis.
