Quickstart voor OpenRouter-gebruikers

Installatie & Instellen

Onze API is volledig compatibel met standaard OpenAI SDK's. Om van OpenRouter over te schakelen hoef je slechts twee configuratiewaarden aan te passen: de base_url en de api_key. Wijs je client naar https://api.openrouterapi.cc/v1 en gebruik de gegenereerde sleutel op ons dashboard. Er zijn geen aangepaste headers of complexe routinglogica nodig. De model-ID om te verzoeken is uncensored.

Zorg dat je SDK-versie de parameter base_url ondersteunt. Als je een ruwe HTTP-client gebruikt, pas dan eenvoudig de doel-URL aan. Deze setup zorgt ervoor dat je bestaande clientcode zonder aanpassingen werkt, mits je alleen verzoeken voor tekstgeneratie verstuurt.

Authenticatie

Authenticatie wordt afgehandeld via de standaard Authorization header. Geef je API-sleutel door als een Bearer token. Als de sleutel ongeldig of verlopen is, retourneert de API een 401-fout. In tegenstelling tot sommige providers rekenen we geen kosten voor mislukte verzoeken; fouten en weigeringen zijn gratis, dus je kunt authenticatie testen zonder tegoed te verbruiken.

Elk account ondersteunt één actieve sleutel tegelijk. Het genereren van een nieuwe sleutel maakt de vorige direct ongeldig. Bewaar je sleutel veilig en draai hem om als je vermoedt dat deze is gelekt. De sleutel wordt direct na het aanmaken weergegeven, dus kopieer hem voordat je de pagina verlaat.

Basis Chat Completion

De kernfunctionaliteit is het POST /v1/chat/completions endpoint. Stuur je prompt als een lijst met berichten en ontvang een tekstantwoord. Het model is afgestemd om te antwoorden zonder inhoudelijke weigeringen voor wettelijk volwassen gebruik, wat het geschikt maakt voor creatieve, controversiële of security-onderzoeksonderwerpen.

Stel het veld model in op uncensored. Je kunt het gedrag sturen met parameters zoals temperature, top_p en stop. De API ondersteunt JSON-modus via response_format en function calling via tools. Alle verzoeken worden asynchroon verwerkt en je ontvangt de volledige voltooiing zodra het model klaar is.

Streaming Responses

Schakel streaming in door stream: true in je verzoek in te stellen. De API retourneert Server-Sent Events (SSE) met gedeeltelijke antwoorden. Je ontvangt tekstchunks naarmate ze worden gegenereerd, waardoor realtime weergave in je applicatie mogelijk is.

Informatie over tokengebruik wordt verstrekt in het laatste fragment van de streaming. Dit stelt je in staat om de kosten nauwkeurig te volgen zonder elke individuele token te parseren. Streaming is ideaal voor chatinterfaces waar latentie belangrijk is. Zorg dat je client SSE correct afhandelt en de verbinding sluit wanneer de stream eindigt.

Function Calling

De API ondersteunt function calling via de parameter tools. Definieer je functies in de tools array en stel tool_choice in op auto of een specifieke functienaam. Het model retourneert gestructureerde JSON-argumenten als een functie wordt geactiveerd.

Deze functie is nuttig voor het integreren van de LLM met externe API's of databases. Zorg ervoor dat je functiedefinities accuraat zijn, omdat het model hierop vertrouwt om geldige argumenten te genereren. De API voert de functies niet uit; jij moet de uitvoeringslogica in je applicatiecode afhandelen.

JSON Modus

Voor gestructureerde uitvoerresultaten gebruik je response_format: {"type": "json_object"}. Dit forceert het model om geldige JSON terug te geven, wat essentieel is voor het parseren van gegevens in downstream applicaties. JSON-modus is vaak betrouwbaarder dan function calling voor eenvoudige taken voor gegevensextractie.

Zorg dat je prompts het model duidelijk instrueren om JSON terug te geven. Ongeldige JSON-antwoorden kunnen optreden als de prompt ambigu is. JSON-modus wordt ondersteund in zowel standaard- als streamingmodi. Gebruik het wanneer je voorspelbare, machine-leesbare uitvoerresultaten nodig hebt.

Limieten, Fouten en Context

Het contextvenster is 100.000 tokens voor prompt en antwoord samen. Maximaal 32.000 tokens uitvoer per verzoek (2.048 als max_tokens niet is ingesteld). Rate limits zijn 300 verzoeken per minuut en 8 gelijktijdige verzoeken per sleutel. Request bodies zijn beperkt tot 8 MB.

Fouten retourneren standaard HTTP-codes: 401 voor ongeldige sleutels, 402 voor onvoldoende tegoed en 429 voor rate limits.tegoed is prepaid, dus een 402-fout betekent dat je moet opwaarderen. Fouten en weigeringen zijn gratis, dus je kunt het zonder kosten opnieuw proberen. De harde inhoudslimiet blokkeert seksuele inhoud met minderjarigen.

cURL

Copycurl https://api.openrouterapi.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openrouterapi.cc/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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openrouterapi.cc/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

Copystream = 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)