Documentație API & Quickstart

Autentificare & URL de Bază

Începeți prin a genera cheia API pe panoul de control. Folosim antete standard compatibile cu OpenAI, așa că trebuie doar să actualizați base_url și API_KEY variabile. Acest lucru asigură că integrările tale existente cu SDK funcționează fără modificări. Oferim suport pentru autentificare Google sau înregistrare prin email/parolă, iar cheia ta apare imediat după creare.

• URL de bază: https://api.routeropen.cc/v1
• Header Auth: Authorization: Bearer YOUR_API_KEY

Mențineți cheia în siguranță, deoarece controlează creditul preplătit. Fiecare cont permite o singură cheie activă la un moment dat; generarea unei noi înlocuiește pe cea veche imediat.

Prima cerere

Trimite primul tău prompt folosind standard chat/completions endpoint. ID-ul modelului este pur și simplu uncensored. Acesta trimite text în și returnează text în afară, fără filtre de conținut pentru uz adult legal.

Copycurl https://api.routeropen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all files in current directory"}]
  }'

Această cerere demonstrează structura de bază. Poți ajusta parametri precum temperature sau top_p pentru a controla creativitatea. Răspunsul include statistici de utilizare a tokenilor pentru o facturare transparentă.

Integrare SDK Python

Folosește biblioteca oficială Python OpenAI pentru a integra API-ul nostru. Indreaptă clientul către URL-ul nostru de bază și utilizează cheia ta API. Această abordare funcționează perfect cu codebase-urile existente care vizează deja OpenAI.

Copyfrom openai import OpenAI

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

Biblioteca gestionează automat serializarea JSON și streaming-ul. Poți configura logica de reîncercare și timeout-uri după nevoie. Endpoint-ul nostru acceptă parametri standard, făcând migrarea de la alți furnizori trivială.

Integrare SDK Node

Pentru dezvoltatorii JavaScript, SDK-ul Node funcționează cu modificări minime. Setați baseURL către endpoint-ul nostru și furnizează cheia. Acest lucru îți permite să îți păstrezi fluxul de lucru actual de dezvoltare în timp ce accesezi modele uncensored.

Copyimport OpenAI from "openai";

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

Utilizatorii Node pot exploata pattern-urile async/await pentru cod curat. Structura de răspuns se potrivește cu standardele OpenAI, asigurând compatibilitatea cu parserii existenți. Poți schimba modelele sau furnizorii modificând doar două variabile.

Răspunsuri în streaming

Activați streaming-ul setând stream: true în cererea ta. Returnăm Evenimente trimise de server (SSE) pentru livrarea tokenilor în timp real. Acest lucru 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)

Ultimul chunk conține utilizarea totală a tokenilor pentru facturare. Streaming-ul funcționează cu toți parametrii, inclusiv apelarea de funcții. Folosește acest lucru pentru interfețele de chat unde feedback-ul instant este critic. Erorile sunt totuși returnate ca evenimente SSE, așa că poți gestiona eșecurile cu grație.

Limitări, Erori & Context

API-ul nostru impune o fereastră de context de 100,000 de tokeni și o limită de corp de cerere de 8MB. Poți face 300 de cereri pe minut per cheie. Dacă depășești această limită, primești o eroare de limitare a ratei 429. Eșecurile de autentificare returnează 401, iar creditele insuficiente returnează 402.

Erorile nu consumă creditul tău preplătit. Dacă trimiți o cerere malformed, nu ești taxat. Modelul refuză cererile care implică minori, dar permite, în rest, conținut nelimitat. Menține-ți gestionarea erorilor robustă pentru a gestiona eficient limitele de rată.