API Quickstart

URL de bază și autentificare

Începeți prin a direcționa clientul către URL-ul de bază și prin transmiterea cheii în antet. Utilizăm schema standard Authorization, astfel încât orice SDK OpenAI sau client compatibil să funcționeze imediat. Nu trebuie să gestionați fluxuri complexe OAuth sau să așteptați aprobarea. Înregistrați-vă doar cu Google sau email, copiați cheia și sunteți gata. Endpoint-ul este https://api.aiohnezensur.com/v1 și acceptă Authorization: Bearer YOUR_API_KEY header pe fiecare solicitare.

Trimiterea primei cereri

Fă un apel simplu de completare chat pentru a testa modelul uncensored. Această cerere trimite un prompt și primește un răspuns text, fără gardurile corporative obișnuite. Poți folosi orice instrument care suportă protocolul OpenAI, dar un apel direct curl arată exact ce se întâmplă în spate. Înlocuiește YOUR_API_KEY cu cheia dvs. reală din panoul de control.

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

Răspunsul include statistici de utilizare a tokenilor și textul generat. Dacă primești un răspuns, integrarea ta funcționează corect. Poți continua acum să construiești interacțiuni mai complexe sau să treci la clienți programatici.

Integrare SDK Python

Folosește pachetul oficial Python OpenAI pentru a interacționa cu API-ul nostru fără probleme. Setează URL-ul de bază către endpoint-ul nostru și furnizează cheia ta ca token API. Acest lucru îți permite să exploatezi codebase-urile existente fără a rescrie logica HTTP. ID-ul modelului este uncensored, care declanșează modelul nostru specific de limbaj mare, optimizat pentru ieșiri nelimitate.

Copyfrom openai import OpenAI

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

Acest snippet demonstrează un schimb de mesaje de bază. Puteți ajusta array-ul de mesaje pentru a include prompturi de sistem sau istoricul conversației. SDK-ul se ocupă de serializare și parsarea erorilor pentru dvs.

Integrare SDK Node

Integrează API în aplicațiile tale JavaScript sau TypeScript folosind SDK-ul Node. Configurează URL-ul de bază și cheia API exact ca în exemplul Python. Această abordare funcționează bine pentru randarea server-side sau microserviciile backend. SDK-ul abstrage stratul de rețea, permițându-ți să te concentrezi pe logica promptului.

Copyimport OpenAI from "openai";

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

Execută acest cod pentru a vedea modelul răspunzând la inputul tău. Poți itera rapid modificând conținutul promptului. Structura răspunsului se potrivește cu formatul standard OpenAI, asigurând compatibilitatea cu alte instrumente din stack-ul tău.

Răspunsuri în streaming

Activați streaming-ul pentru a primi tokeni pe măsură ce sunt generați, reducând latența percepută. Acest lucru este crucial pentru interfețele utilizator care afișează text în timp real. Setează stream parametrul la true în cererea ta. API-ul trimite o serie de Evenimente trimise de server (SSE) în loc de un singur obiect JSON. Fiecare fragment conține un delta parțial al răspunsului.

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)

Concatează aceste diferențe pe partea client pentru a reconstrui mesajul complet. Această metodă pare instantanee pentru utilizator, chiar și pentru ieșiri lungi. Ultima bucată conține utilizarea totală a tokenilor, permițând facturarea precisă.

Limite de rată și constrângeri

Înțelegeți limitele tehnice pentru a preveni eșecurile solicitărilor în producție. Aveți voie la 300 de solicitări pe minut per cheie și puteți avea 8 solicitări concurente. Corpul solicitării nu trebuie să depășească 8 MB. Dacă depășiți aceste limite, API-ul returnează codul de status 429. Ar trebui să implementați o backoff exponențială în clientul dumneavoastră pentru a gestiona aceste vârfuri cu grijă. Fereastra de context are 100.000 de tokeni în total, cu o ieșire maximă de 16.000 de tokeni per solicitare. Erorile și refuzurile nu consumă credit, așa că puteți reîncerca în siguranță. Erorile de autentificare returnează 401, iar fondurile insuficiente returnează 402.