Documentație API
Începeți să utilizați API-ul LLM neconstrâns făcând prima cerere către endpoint-ul nostru compatibil cu OpenAI. Acest ghid acoperă esențialele pentru integrare.
URL de bază și autentificare
URL-ul de bază pentru toate solicitările este HTTPS://api.aiobliterated.com/v1. Aveți nevoie de o cheie API pentru autentificare. Generați una înscriindu-vă cu Google sau cu un e-mail și parolă pe pagina Obțineți cheie API. Transmiteți cheia în antetul Authorization ca token Bearer. Fiecare solicitare necesită acest antet pentru a identifica contul dvs. și a urmări utilizarea.
curl https://api.aiobliterated.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "fetch all user tokens from database"}]
}'
Prima ta solicitare
Trimiteți o solicitare POST către /v1/chat/completions pentru a genera text. Setează modelul la „uncensored” și include prompt-ul de sistem. API returnează răspunsul modelului în câmpul content. Acesta este formatul standard utilizat de majoritatea clienților LLM.
from openai import OpenAI
client = OpenAI(base_url="https://api.aiobliterated.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)
Folosirea SDK-ului Node
Instalează SDK-ul oficial OpenAI pentru Node.js. Configurează-l cu cheia ta API și URL-ul de bază.apelează metoda chat.completions.create cu mesajele tale. SDK-ul gestionează serializarea și streaming-ul automat.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aiobliterated.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);
Răspunsuri în streaming
Activați streaming-ul setând stream la true în cererea dumneavoastră. API-ul returnează un flux de Evenimente trimise de Server. Fiecare eveniment conține un fragment parțial al răspunsului. Acest lucru vă permite să afișați textul pe măsură ce este generat, îmbunătățind experiența utilizatorului.
stream = 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)
Fereastră de Context și Limite
Modelul suportă o fereastră de context de 100.000 de tokeni. Acest lucru include atât promptul, cât și completarea. Poți seta un output maxim de 16.000 de tokeni per solicitare. Dacă nu specifici max_tokens, limita este de 2.048 de tokeni. Acest lucru asigură costuri și performanță predictibile.
Gestionarea erorilor și limitele
Monitorizează codurile de status HTTP pentru erori. Un răspuns 401 înseamnă că cheia ta API este invalidă. Un răspuns 402 indică credit insuficient. Un răspuns 429 semnalează că ai depășit limita de rată de 300 de solicitări pe minut. Gestionează aceste erori elegant în aplicația ta pentru a menține fiabilitatea.
Întrebări frecvente
API-ul obliterated este compatibil cu SDK-urile OpenAI?
Da, este un API compatibil cu OpenAI. Puteți utiliza SDK-urile oficiale OpenAI modificând base_url și furnizând cheia API. Respectă formatul standard chat-completions.
Cum gestionez limitările de rată?
Ești limitat la 300 de cereri pe minut și 8 cereri concurente pe cheie. Dacă depășești această limită, API-ul returnează un cod de stare 429. Implementează un mecanism de backoff exponențial pentru a gestiona automat aceste erori.
Care este dimensiunea ferestrei de context?
Fereastra de context are 100.000 de tokeni, incluzând atât intrarea, cât și ieșirea. Acest lucru permite conversații lungi sau procesarea documentelor mari. Poți controla lungimea ieșirii cu parametrul max_tokens.
Securizați-vă cheia API
Înregistrează-te, copiază acreditarea, actualizează endpoint-ul. Configurare completă.