Documentație API

Autentificare și URL de bază

API necesită o singură cheie API pentru autentificare. Primești această cheie imediat după înscriere cu Google sau o adresă de e-mail. Transmiteți-o în Authorization header ca un token Bearer. URL-ul de bază este https://api.topuncensored.com/v1. Această URL funcționează cu orice SDK sau bibliotecă client compatibilă OpenAI.

• Folosește antetul: Authorization: Bearer YOUR_API_KEY
• Configurați URL-ul de bază al clientului la endpoint-ul furnizat.

Această configurare asigură că poți înlocui bibliotecile fără a-ți modifica logica de bază.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Endpoint Completări Chat

Trimite prompturi text către /v1/chat/completions endpoint. ID-ul modelului este uncensored. Acest endpoint gestionează formatarea standard de chat cu mesaje. Returnează răspunsuri text direct. Nu există straturi suplimentare sau wrapper-e. Controlați fereastra de context de 100.000 de tokeni. Solicitățiile sub 8 MB funcționează în mod fiabil. Folosiți acest lucru pentru generarea directă de text.

Structurează cererea cu un prompt de system și un mesaj user. Modelul răspunde fără a filtra conținutul legal pentru adulți. Erori precum cheile lipsă returnează 401. Ai rămas fără credit? Primești o eroare 402. Acestea sunt semnale clare.

Răspunsuri în streaming

Activați streaming-ul setând stream: true. Primești fragmente de text pe măsură ce sunt generate. Acest lucru reduce latența percepută pentru ieșiri lungi. Fragmentul final include date de utilizare a tokenilor. Folosește acest lucru pentru afișări în timp real sau randare progresivă. Este eficient pentru aplicațiile cu volum mare.

Analizați fiecare fragment pentru a vă construi răspunsul final. Această metodă gestionează eficient outputurile mari. API-ul suportă Server-Sent Events standard. Aceasta este abordarea recomandată pentru aplicațiile interactive.

Copyfrom openai import OpenAI

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

Apelarea de Instrumente și Modul JSON

Utilizează apelarea de funcții pentru interacțiuni structurate. Definește instrumentele în cererea ta. Modelul returnează argumente structurate. Setează response_format pentru {"type": "json_object"} pentru ieșire JSON strictă. Acest lucru asigură formate de date predictibile. Combinați aceste funcții pentru integrări robuste. Obțineți un control precis asupra structurii ieșirii.

Apelarea de instrumente funcționează cu schema standard OpenAI. Modul JSON forțează un JSON valid. Folosește aceste caracteristici pentru integrări API sau extragerea de date. Această flexibilitate suportă fluxuri de lucru complexe.

Copyimport OpenAI from "openai";

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

Parametri și limite

Ajustați temperature, top_p, și stop secvențe. Setează max_tokens că 16.000. Implicit este 2.048 dacă este omis. Controlați repetarea cu presence_penalty și frequency_penalty. Folosiți seed pentru ieșiri deterministe. Acești parametri rafinează calitatea generării. Ai control total asupra stilului de ieșire.

Limitările de rată sunt de 300 de cereri pe minut. Cererile concurente sunt limitate la 8. Aceste limite asigură o performanță stabilă. Monitorizați utilizarea prin panou. Ajustați parametrii pentru a optimiza în funcție de cazul dvs. de utilizare specific.

Erori și Fereastra de Context

Gestionați erorile cu grijă. 401 înseamnă cheie invalidă. 402 indică credit insuficient. 429 semnalează limite de rată. Fereastra contextului este de 100.000 de tokeni în total. Outputul maxim este de 16.000 de tokeni. Gestionează-ți tokenii cu înțelepciune. Erorile nu consumă credit. Acest lucru economisește bani în timpul depanării. Folosește ultimul fragment pentru statistici de utilizare.

Urmărește utilizarea tokenilor. Evită depășirea limitelor de rată. Reîncearcă cu backoff exponențial. Acest lucru asigură o funcționare fiabilă. API este conceput pentru robustețe. Gestionează erorile ca parte a fluxului normal.

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)