API Documentatie

Basis-URL en authenticatie

Het API-eindpunt bevindt zich op https://api.openrouteraiapi.com/v1. Voer je API-sleutel in de Authorization header als Bearer-token. Deze header is de enige wijziging die nodig is om het verkeer van je huidige provider naar ons ongefilterde model te leiden.

Authenticatie is streng. Als de sleutel ontbreekt of ongeldig is, retourneert de server direct een 401-fout. Je kunt direct een sleutel genereren via Google of e-mail op het dashboard. Bewaar de sleutel veilig, omdat deze toegang geeft tot je voorgebetaalde tegoed.

Chat Completions Endpoint

Verstuur POST-verzoeken aan /v1/chat/completions met een messages-array. De model identifier is uncensored. Dit enkele model verwerkt al je tekstgeneratiebehoeften zonder complexe routeringslogica.

Hier is een standaardverzoek met cURL om de verbinding en responsindeling te verifiëren.

Copycurl https://api.openrouteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
  }'

De respons bevat de gegenereerde tekst in de choices[0].message.content veld. U kunt dit direct parseren in uw applicatiewerkstroom.

Python SDK Integratie

Gebruik de officiële OpenAI Python-client om moeiteloos verbinding te maken. Stel de base_url en api_key variabelen om naar onze infrastructuur te wijzen. Deze aanpak minimaliseert codeaanpassingen bij het wisselen van providers.

Copyfrom openai import OpenAI

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

De client verwerkt serialisatie en retries automatisch. Je ontvangt een completion-object met de tekst en token-gebruiksstatistieken. Deze methode is ideaal voor backend-services en scripts.

Node.js SDK-gebruik

Initialiseer de OpenAI Node.js-client met je aangepaste basis-URL. Hiermee kunnen JavaScript-applicaties met het uncensored-model communiceren met behulp van bekende methoden. De SDK behandelt de HTTP-verzoeken efficiënt.

Copyimport OpenAI from "openai";

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

Oproep chat.completions.create() met je berichten. Het responsobject biedt toegang tot de gegenereerde inhoud en gebruiksgegevens. Deze integratie werkt goed voor webservers en edge functions.

Streaming-responsen

Activeer streaming door stream: true in je verzoek. De server retourneert Server-Sent Events (SSE) voor real-time tokenlevering. Deze functie vermindert de waargenomen latentie voor eindgebruikers.

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)

Elk chunk bevat gedeeltelijke inhoud. Het laatste chunk bevat de volledige tokengebruikstatistieken. Verwerk deze gebeurtenissen in je client om de UI incrementeel bij te werken.

Limieten, fouten en contextvenster

Het contextvenster ondersteunt 100.000 tokens voor gecombineerde input en output. Elk verzoek kan maximaal 16.000 tokens uitvoeren, of 2.048 als max_tokens is niet ingesteld. Snelheidslimieten staan 300 verzoeken per minuut per sleutel toe.

Fouten zijn standaard HTTP-codes. Een 401 geeft een ongeldige sleutel aan. Een 402 betekent dat je voorbetaalde tegoed op is. Een 429 geeft aan dat je de limiet voor het aantal verzoeken hebt overschreden. Mislukte verzoeken verbruiken geen tegoed. Fouten zijn gratis.