API Dokumentation

Base URL og autentificering

API-endepunktet findes på https://api.openrouteraiapi.com/v1. Send din API-nøgle i Authorization header som en bearer-token. Denne header er den eneste ændring, der er nødvendig for at omdirigere trafik fra din nuværende udbyder til vores uncensored-model.

Autentificeringen er streng. Hvis nøglen mangler eller er ugyldig, returnerer serveren straks en 401-fejl. Du kan generere en nøgle øjeblikkeligt via Google eller e-mail på dashboardet. Gem nøglen sikkert, da den giver adgang til din forudbetalte kredit.

Chat Completions Endpoint

Send POST-anmodninger til /v1/chat/completions med en messages-array. Model-identifikatoren er uncensored. Denne enkelt model håndterer alle dine tekstgenereringsbehov uden kompleks routing-logik.

Her er en standardanmodning med cURL til at verificere forbindelsen og svarformatet.

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"}]
  }'

Svaret inkluderer den genererede tekst i choices[0].message.content felt. Du kan fortolke dette direkte i din applikationsarbejdsgang.

Python SDK-integration

Brug den officielle OpenAI Python-klient til at oprette forbindelse problemfrit. Indstil base_url og api_key variabler for at pege på vores infrastruktur. Denne tilgang minimerer kodeændringer ved skift af udbyder.

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)

Klienten håndterer serialisering og forsøg automatisk. Du modtager et completion-objekt, der indeholder teksten og tokenforbrugsstatistikker. Denne metode er ideel til backend-tjenester og scripts.

Node.js SDK-brug

Initialiser OpenAI Node.js-klienten med din custom base-URL. Dette giver JavaScript-applikationer mulighed for at interagere med den uncensored-model ved hjælp af velkendte metoder. SDK'et håndterer HTTP-anmodninger effektivt.

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);

Kald chat.completions.create() med dine beskeder. Svarobjektet giver adgang til det genererede indhold og brugsdata. Denne integration fungerer godt til webservere og edge functions.

Streaming-svar

Aktivér streaming ved at indstille stream: true i din anmodning. Serveren returnerer Server-Sent Events (SSE) til realtids-tokenlevering. Denne funktion reducerer den opfattede forsinkelse for slutbrugere.

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)

Hver chunk indeholder delvist indhold. Den sidste chunk indeholder de fulde token-brugsstatistikker. Håndter disse events i din klient for at opdatere UI'en inkrementelt.

Begrænsninger, fejl og kontekstvindue

Kontekstvinduet understøtter 100.000 tokens til input og output kombineret. Hver anmodning kan outputte op til 16.000 tokens, eller 2.048 hvis max_tokens er ikke indstillet. Hastighedsbegrænsninger tillader 300 anmodninger i minuttet pr. nøgle.

Fejl er standard HTTP-koder. En 401 indikerer en ugyldig nøgle. En 402 betyder, at din forudbetalte kredit er opbrugt. En 429 signalerer, at du har overskredet hastighedsgrænsen. Anmodninger, der fejler, forbruger ikke kredit. Fejl er gratis.