OpenRouter ai-sleutels: snelstartgids

Basis-URL & Authenticatie

Je API-sleutel authenticeert elk verzoek aan ons eindpunt. Gebruik de basis-URL https://api.openrouteraikeys.com/v1 en geef je sleutel door in de Authorization header. Deze opstelling werkt met elke OpenAI-compatible SDK omdat we hun standaard authenticatiepatroon mirroringen. Je hoeft je clientbibliotheek niet aan te passen, alleen de basis-URL-configuratie.

• Header: Authorization: Bearer YOUR_API_KEY
• Basis-URL: https://api.openrouteraikeys.com/v1

Eerste verzoek

Stuur een standaard chat-completion verzoek om de verbinding en het antwoordformaat te testen. De model-ID is uncensored en het accepteert standaard berichtenarrays. Dit eindpunt retourneert alleen tekst, dus verwacht geen afbeeldings- of audiogegevens in de responspayload.

Copycurl https://api.openrouteraikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this documentation page"}]
  }'

Python SDK Integratie

Initialiseer de client met je sleutel en de aangepaste basis-URL. Dit stelt je in staat de vertrouwde chat.completions.create methode zonder extra logica te omhullen. De bibliotheek verwerkt serialisatie en retry-logica automatisch voor u.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openrouteraikeys.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 SDK-integratie

Configureer de OPENAI_API_KEY en OPENAI_BASE_URL omgevingsvariabelen of geef ze direct door aan de clientconstructor. Dit zorgt ervoor dat alle daaropvolgende aanroepen via ons ongefilterde endpoint worden doorgestuurd. Je kunt dezelfde SDK-versie blijven gebruiken die je al geïnstalleerd hebt.

Copyimport OpenAI from "openai";

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

Activeer streaming door stream: true in je verzoek. De API retourneert Server-Sent Events (SSE) chunks terwijl het model tekst genereert. Tokenverbruiksstatistieken verschijnen in het laatste chunk van de stream, zodat je kosten in realtime kunt bijhouden zonder te wachten op de volledige respons.

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)

Limieten, Fouten & Context

Het contextvenster ondersteunt in totaal 100.000 tokens voor prompt en completion. U bent beperkt tot 300 verzoeken per minuut per sleutel. Een 401-fout betekent dat uw API-sleutel ongeldig of ontbrekend is. Een 402-fout geeft aan dat er onvoldoende vooruitbetaald krediet is. Een 429-fout geeft aan dat u de rate limit heeft overschreden. Weigeringen vanwege het contentbeleid zijn gratis, maar computatiefouten kunnen tokens verbruiken.