Documentație API Compatibil cu OpenAI

Precondiții: SDK și URL de bază

Începe prin a instala biblioteca preferată și să o orientezi către endpoint-ul nostru. Acest base_url este https://api.apicompatible.com/v1. Documentația API compatibilă OpenAI confirmă că bibliotecile standard funcționează imediat. Nu ai nevoie de un router sau de o configurare complexă de gateway. Schimbă URL-ul și cheia, apoi rulează codul tău existent.

Autentificare: Formatul antetului și al cheii

Trimiteți cheia în Authorization header. Folosește formatul Bearer your_api_key. API-ul nostru folosește structura standard de cheie API compatibilă cu OpenAI. Cheile sunt generate instant prin autentificarea cu Google sau email. Păstrează-ți cheia în siguranță, deoarece oferă acces la creditul tău preplătit.

Endpoint Completări Chat

Trimiteți solicitări la /v1/chat/completions. Specifică modelul ca uncensored. API returnează răspunsuri text direct. Folosește următoarea comandă curl pentru a verifica conectivitatea:

Copycurl https://api.apicompatible.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List available models"}]
  }'

Această abordare compatibilă cu SDK-ul OpenAI asigură generarea de text fără restricții. Modelul gestionează prompturi complexe fără refuzuri inutile pentru conținutul licit.

Răspunsuri în streaming cu SSE

Activați streaming-ul setând stream: true. Răspunsurile sosesc prin Server-Sent Events (SSE). Detaliile privind utilizarea tokenilor apar în ultimul fragment. Această documentație API compatibilă cu OpenAI suportă protocoalele standard de streaming. Folosește acest lucru pentru experiențe utilizator în timp real:

Copyfrom openai import OpenAI

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

Streaming-ul reduce semnificativ latența percepută. Funcționează perfect cu librăriile standard de pe partea de client.

Parametri: Temperatură, Top-P și Instrumente

Controlează generarea cu parametri standard. Setează temperature pentru aleatorietate sau top_p pentru eșantionarea nucleu. Activați tools pentru apelarea funcțiilor. Modul JSON este disponibil prin response_format. The uncensored modelul respectă eficient aceste constrângeri:

Copyimport OpenAI from "openai";

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

Acești parametri permit un control fin al stilului de output. Poți impune structuri JSON stricte pentru cazuri de utilizare programatică.

Limitări: Limitări de rată și dimensiune a corpului

Fiecare cheie permite 300 de cereri pe minut. Cererile concurente sunt limitate la 8 per cheie. Dimensiunea maximă a corpului cererii este de 8 MB. Fereastra de context suportă 100,000 de tokeni în total. Gestionați erorile 401 verificând cheia dumneavoastră. Rezolvați erorile 402 încărcând creditul. Gestionați erorile 429 implementând logica de backoff.

Streaming

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)