API-dokumentation

Bas URL och autentisering

API-slutpunkten finns på https://api.openrouteraiapi.com/v1. Skicka din API-nyckel i Authorization header som ett bearer-token. Denna header är den enda ändringen som behövs för att omdirigera trafik från din nuvarande leverantör till vår obegränsade modell.

Autentiseringen är strikt. Om nyckeln saknas eller är ogiltig returnerar servern ett 401-fel omedelbart. Du kan generera en nyckel omedelbart via Google eller e-post på dashboardet. Förvara nyckeln säker, eftersom den ger åtkomst till ditt förbetala kreditbelopp.

Slutpunkt för chattkomplettering

Skicka POST-begäranden till /v1/chat/completions med en meddelandematris. Modellidentifieraren är uncensored. Denna enda modell hanterar alla dina textgenereringsbehov utan komplex routningslogik.

Här är en standardbegäran med cURL för att verifiera anslutning och svarformat.

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 inkluderar den genererade texten i choices[0].message.content fält. Du kan analysera detta direkt i ditt applikationsarbetsflöde.

Python SDK-integration

Använd den officiella OpenAI Python-klienten för att ansluta sömlöst. Ställ in base_url och api_key variabler för att peka mot vår infrastruktur. Denna metod minimerar kodändringar vid byte av leverantör.

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 hanterar serier och försök automatiskt. Du får ett kompletteringsobjekt som innehåller text och tokenanvändningsstatistik. Denna metod är idealisk för backend-tjänster och skript.

Node.js SDK-användning

Initiera OpenAI Node.js-klienten med din anpassade bas-URL. Detta gör att JavaScript-applikationer kan interagera med den osensurerade modellen med bekanta metoder. SDK:et hanterar HTTP-förfrågningar 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);

Anrop chat.completions.create() med dina meddelanden. Svarsobjektet ger tillgång till det genererade innehållet och användningsdata. Denna integration fungerar bra för webbservern och kantfunktioner.

Strömningsresponser

Aktivera strömning genom att ställa in stream: true i ditt begäran. Servern returnerar Server-Sent Events (SSE) för realtids tokenleverans. Denna funktion minskar den upplevda latensen för slutanvändare.

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)

Varje chunk innehåller delvis innehåll. Den sista chunken innehåller komplett tokenanvändningsstatistik. Hantera dessa händelser i din klient för att uppdatera UI:t inkrementellt.

Gränser, fel och kontextfönster

Kontextrutan stöder 100 000 tokens för kombinerad inmatning och utmatning. Varje begäran kan skriva ut upp till 16 000 tokens, eller 2 048 om max_tokens är inställt. Hastighetsbegränsningarna tillåter 300 begäranden per minut per nyckel.

Fel är standardiserade HTTP-koder. En 401 indikerar en ogiltig nyckel. En 402 betyder att ditt förbetalda kredit är slut. En 429 signalerar att du har överskridit hastighetsbegränsningen. Förfrågningar som misslyckas konsumerar inte kredit. Fel är gratis.