Documentație API OpenRouter

Începe rapid: Conectare cu Python

Începe prin a instala SDK-ul oficial și să-l direcționezi către URL-ul nostru de bază.

API-ul nostru se comportă ca interfața standard OpenAI, dar rutează către un singur model uncensored. Această abordare elimină complexitatea proxy-ului, păstrând în același timp portabilitatea codului.

• Instalează biblioteca prin pip.
• Configurați cheia API în mediu.
• Definește URL-ul de bază pentru punctul nostru de terminare.

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)

Înlocuiți cheia placeholder cu acreditările dumneavoastră. Puteți trimite prompturi simple sau date structurate complexe.

Autentificare și Chei

Generează o cheie pe panoul de control și transmite-o în headerul Authorization.

Fiecare cont suportă o singură cheie activă simultan. Când creezi o cheie nouă, cea veche încetează să mai funcționeze imediat. Acest lucru simplifică gestionarea securității fără a necesita o logică complexă de rotire.

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

Solicitarea de mai sus utilizează schema Bearer. Asigură-te că cheia ta începe cu sk- și nu conține spații albe suplimentare.

Endpoint Completări Chat

Trimite mesaje la /v1/chat/completions endpoint folosind standard JSON.

Modelul acceptă user și assistant roluri. Poți configura temperatura, top-p și secvențele de oprire pentru a controla stilul de ieșire. Răspunsurile returnează utilizarea tokenilor în ultimul fragment dacă streaming-ul este activat.

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

Setează max_tokens pentru a controla lungimea outputului. Dacă este omis, valoarea implicită este de 2.048 de tokeni. Modelul suportă până la 16.000 de tokeni per solicitare.

Răspunsuri în streaming

Activați streaming-ul setând stream: true în corpul cererii tale.

Detaliile de consum de tokenuri apar doar în ultimul fragment al fluxului. Acest lucru permite actualizări ale interfeței utilizator în timp real, păstrând datele de facturare precise. Erorile în timpul streaming-ului raportează încă consumul pentru tokenurile facturate.

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)

Gestionați răspunsurile parțiale cu grijă. Fluxul se închide normal când modelul finalizează generarea sau atinge limita de context.

Apelarea funcțiilor & Mod JSON

Utilizare response_format: {type: "json_object"} pentru ieșiri JSON stricte.

Definește instrumente în tools array și setează tool_choice pentru a impune apelurile de funcții. Modelul returnează date structurate, potrivite pentru procesarea programatică. Acest lucru funcționează în mod fiabil cu ponderile noastre uncensored.

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

Combină apelarea de funcții cu streaming pentru experiențe interactive. Validează ieșirea JSON înainte de a o trece la logica aplicației tale.

Limite și Cote

Monitorați-vă utilizarea în raport cu limitele per-cheie pentru a evita întreruperile.

Fiecare cheie permite 300 de cereri pe minut și 8 cereri concurente. Limita dimensiunii corpului cererii este de 8 MB. Dacă depășiți aceste limite, API-ul returnează codul de stare 429. Erorile de autentificare returnează 401, iar creditul insuficient returnează 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"}]
  }'

Fereastra de context este de 100.000 de tokeni în total. Erorile nu consumă credit. Refuzurile pentru încălcări minore de conținut rămân, de asemenea, gratuite.