OpenRouter api-dokumentation

Hurtigstart: Forbind med Python

Start med at installere det officielle SDK og pege det mod vores base URL.

Vores API opfører sig som det standard OpenAI interface, men ruter til en enkelt uncensored model. Denne tilgang eliminerer proxy-kompleksitet og bevarer samtidig din kodes bærbarhed.

• Installer biblioteket via pip.
• Indstil din API-nøgle i miljøet.
• Definer base-URL'en til vores endpoint.

Copyfrom openai import OpenAI

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

Erstat pladsholdernøglen med dine egne oplysninger. Du kan sende enkle prompts eller komplekse strukturerede data.

Autentificering og nøgler

Generér en nøgle på dashboardet og send den i Authorization-headeren.

Hver konto understøtter én aktiv nøgle ad gangen. Når du opretter en ny nøgle, holder den gamle op med at virke med det samme. Dette forenkler sikkerhedsstyringen uden at kræve kompleks rotationslogik.

Copycurl https://api.apiopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 dependencies for a Go web server"}]
  }'

Forespørgslen ovenfor bruger Bearer-skemaet. Sørg for, at din nøgle starter med sk- and contains no extra whitespace.

Chat Completions Endpoint

Send beskeder til /v1/chat/completions endpoint ved hjælp af standard JSON.

Modellen accepterer user og assistant roller. Du kan konfigurere temperature, top-p og stop-sekvenser til at kontrollere output-stil. Svar returnerer token-forbrug i det sidste chunk, hvis streaming er aktiveret.

Copyimport OpenAI from "openai";

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

Indstil max_tokens til at kontrollere outputlængden. Hvis udeladt, er standardværdien 2,048 tokens. Modellen understøtter op til 16,000 tokens pr. anmodning.

Streaming-svar

Aktivér streaming ved at indstille stream: true i din anmodningskrop.

Tokenforbrugsdetaljer vises kun i den sidste chunk af streamet. Dette giver realtids-UI-opdateringer samtidig med, at præcis faktureringsdata bevares. Fejl under streaming rapporterer stadig forbrug for opkrævede tokens.

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)

Håndter delvise svar pænt. Streamet lukker normalt, når modellen er færdig med genereringen, eller rammer kontekstgrænsen.

Function Calling & JSON Mode

Brug response_format: {type: "json_object"} for strenge JSON-outputs.

Definer værktøjer i tools array og indstil tool_choice til at håndhæve funktionskald. Modellen returnerer strukturerede data, der er velegnede til programmatisk behandling. Dette fungerer pålideligt med vores uncensored-vægte.

Copycurl https://api.apiopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 dependencies for a Go web server"}]
  }'

Kombinér funktionkald med streaming til interaktive oplevelser. Valider JSON-outputtet, før du sender det til din applikationslogik.

Limits and Quotas

Overvåg dit forbrug mod nøglebaserede grænser for at undgå afbrydelser.

Hver nøgle giver 300 requests i minuttet og 8 samtidige requests. Grænsen for request body-størrelse er 8 MB. Hvis du overskrider disse grænser, returnerer API'en en 429 statuskode. Autentifikationsfejl returnerer 401, og manglende kredit returnerer 402.

Copycurl https://api.apiopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 dependencies for a Go web server"}]
  }'

Kontekstvinduet er på 100.000 tokens i alt. Fejl forbruger ikke kredit. Afslag for mindre indholdsovertrædelser er også gratis.