Ghid de integrare: API Chat Completions

URL de bază și autentificare

API-ul abliterated funcționează ca un înlocuitor drop-in pentru endpoint-urile standard OpenAI. Trimiteți solicitări către https://api.aiabliterated.cc/v1 și autentifică folosind un token Bearer în Authorization header. Această configurare funcționează cu orice client care suportă protocolul OpenAI.

• URL de bază: https://api.aiabliterated.cc/v1
• Header Auth: Authorization: Bearer YOUR_API_KEY
• ID Model: uncensored

Autentificarea este strictă. Dacă trimiți o cheie invalidă, sistemul returnează imediat o eroare 401.

Punctul final /v1/chat/completions

Trimiteți datele promptului către /v1/chat/completions endpoint pentru a primi răspunsuri text. Sistemul așteaptă un payload JSON care conține identificatorul modelului și istoricul mesajelor tale. Aceasta este o interfață doar pentru text; nu te aștepta la generarea de imagini sau audio.

Modelul procesează intrarea și ieșirea într-o fereastră de context de 100.000 de tokeni. Dacă nu specifici o limită, sistemul generează implicit 2.048 de tokeni per solicitare. Poți ajusta această valoare până la un maxim absolut de 16.000 de tokeni.

Copyfrom openai import OpenAI

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

Răspunsuri în streaming și consumul de tokeni

Activați streaming-ul setând stream: true în payload-ul solicitării. API-ul returnează un flux de Evenimente trimise de server (SSE) cu tokeni parțiali. Acest lucru reduce semnificativ latența percepută pentru aplicațiile interactive.

Datele de consum de tokenuri nu sunt trimise cu fiecare fragment. În schimb, ultimul fragment al fluxului conține statisticile complete de consum pentru acea solicitare. Acest design menține fluxul ușor, oferind în același timp date precise de facturare. Erorile în timpul streaming-ului sunt gestionate prin închiderea conexiunii cu un obiect JSON de eroare.

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)

Apelarea funcțiilor și modul JSON

Modelul ablivered suportă ieșiri structurate prin response_format parametru. Setează acest la {"type": "json_object"} pentru a forca conformitatea strictă JSON. Acest lucru este esențial pentru o integrare fiabilă cu sistemele backend.

Apelarea funcțiilor este, de asemenea, disponibilă. Definește instrumente în solicitarea ta, iar modelul va produce JSON valid care se potrivește cu schema ta. Sistemul nu validează definițiile instrumentelor tale, așa că asigură-te că schemele sunt corecte înainte de a trimite solicitări. Această capacitate permite arhitecturi complexe de agenți fără straturi externe de analiză.

Copyimport OpenAI from "openai";

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

Parametri: Temperatură, Top-P, Seed

Controlează aleatorietatea ieșirilor tale folosind parametrii standard de eșantionare. Modelul temperature valoare ajustează creativitatea, în timp ce top_p limitează eșantionarea nucleului. Folosește seed pentru ieșiri deterministe când ai nevoie de rezultate reproductibile pentru depanare.

Alți parametri disponibili includ stop secvențe, presence_penalty, și frequency_penalty. Acestea permit un control fin al repetării tokenilor și al aderării la subiect. Modelul uncensored răspunde bine la setări de temperatură scăzută pentru generarea de cod și la temperaturi ridicate pentru scrierea creativă.

Limite de rată și constrângeri

API impune limite stricte pentru a asigura stabilitatea pentru toți utilizatorii. Sunteți limitat la 300 de cereri pe minut pe cheie. Cererile concurente sunt limitate la 8 simultan. Fiecare corp de cerere nu trebuie să depășească 8 MB.

Dacă depășiți aceste limite, sistemul returnează o eroare 429 Too Many Requests. Facturarea se bazează pe utilizarea reală a tokenilor. Erorile și refuzurile nu consumă creditul preplătit. Puteți gestiona cheia direct din panou dacă trebuie să rotati acreditările din cauza acestor constrângeri.

cURL

Copycurl https://api.aiabliterated.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 500 word technical document"}]
  }'