Documentație API

URL de bază și autentificare

Punctul final API se află la https://api.openrouteraiapi.com/v1. Transmite cheia ta API în Authorization header ca un token bearer. Acest header este singura modificare necesară pentru a redirecționa traficul de la furnizorul tău actual către modelul nostru fără cenzură.

Autentificarea este strictă. Dacă cheia lipsește sau este invalidă, serverul returnează imediat o eroare 401. Poți genera o cheie instantaneu prin Google sau email din panou. Păstrează cheia în siguranță, deoarece oferă acces la creditul tău preplătit.

Endpoint Completări Chat

Trimiteți solicitări POST la /v1/chat/completions cu un array de mesaje. Identificatorul modelului este uncensored. Acest model unic gestionează toate nevoile tale de generare text fără logică complexă de rutare.

Iată o solicitare standard folosind cURL pentru a verifica conectivitatea și formatul răspunsului.

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

Răspunsul include textul generat în choices[0].message.content câmp. Poți analiza acest lucru direct în fluxul tău de lucru al aplicației.

Integrare SDK Python

Folosește clientul oficial OpenAI Python pentru a te conecta fără efort. Setează base_url și api_key variabile pentru a indica către infrastructura noastră. Această abordare minimizează modificările de cod atunci când comuți furnizori.

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)

Clientul gestionează serializarea și reîncercările automat. Primești un obiect de complet care conține textul și statisticile de utilizare a tokenilor. Această metodă este ideală pentru serviciile backend și scripturi.

Utilizare SDK Node.js

Inițializați clientul OpenAI Node.js cu URL-ul tău personalizat de bază. Acest lucru permite aplicațiilor JavaScript să interacționeze cu modelul uncensored folosind metode familiare. SDK-ul gestionează eficient solicitările HTTP.

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

Apel chat.completions.create() cu mesajele dvs. Obiectul de răspuns oferă acces la conținutul generat și la datele de utilizare. Această integrare funcționează bine pentru servere web și funcții edge.

Răspunsuri în streaming

Activați streaming-ul setând stream: true în cererea ta. Serverul returnează Evenimente trimise de server (SSE) pentru livrarea tokenilor în timp real. Această funcție reduce latența percepută pentru utilizatorii finali.

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)

Fiecare fragment conține conținut parțial. Fragmentul final include statistici complete de utilizare a token-urilor. Gestionează aceste evenimente în clientul tău pentru a actualiza interfața utilizatorului incremental.

Limitări, Erori și Fereastră de Context

Fereastra de context suportă 100.000 de tokeni pentru input și output combinate. Fiecare solicitare poate genera până la 16.000 de tokeni, sau 2.048 dacă max_tokens este nedefinit. Limitele de rată permit 300 de solicitări pe minut pe cheie.

Erorile sunt coduri HTTP standard. Un 401 indică o cheie invalidă. Un 402 înseamnă că creditul tău preplătit este epuizat. Un 429 semnalează că ai depășit limita de rată. Solicităările care eșuează nu consumă credit. Erorile sunt gratuite.