Documentație API pentru Completări Chat Fără Cenzură

Începe rapid: Conectare în Python sau JavaScript

Conectați-vă la API actualizând URL-ul de bază și setând cheia API. Endpoint-ul acceptă solicitări standard de completare chat și returnează text. Nu trebuie să instalați librării personalizate dacă folosiți SDK-urile oficiale OpenAI, deoarece interfața se potrivește exact cu specificația lor.

Începeți cu o simplă cerere HTTP pentru a verifica conectivitatea. Folosiți comanda curl de mai jos pentru a trimite un prompt de bază la uncensored model. Înlocuiește YOUR_API_KEY cu cheia generată în panoul dvs.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Pentru dezvoltatorii Python, procesul este aproape identic. Inițializează clientul cu cheia ta și URL-ul de bază corect. Acest lucru asigură că toate cererile sunt direcționate către serverele noastre fără cenzură, menținând în același timp compatibilitatea cu instrumentele existente.

Copyfrom openai import OpenAI

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

Utilizatorii JavaScript pot obține același rezultat folosind SDK-ul Node. Setează baseURL proprietate către endpoint-ul nostru. Această abordare vă permite să integrați API-ul în servere web sau servicii backend cu modificări minime de cod.

Copyimport OpenAI from "openai";

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

Autentificare și gestionarea cheii API

Autentificarea se bazează pe o singură cheie API trecută în antet. Transmite această cheie în Authorization header pentru fiecare solicitare. Dacă cheia lipsește sau este invalidă, API-ul returnează imediat o eroare 401. Acest lucru asigură un acces securizat la creditul tău preplătit.

Generează-ți cheia pe panoul de control. Cheia este afișată o singură dată la creare. Stoa-o în siguranță în variabilele de mediu. Nu o partaja public. Fiecare cont suportă o singură cheie activă simultan. Generarea unei noi chei invalidează imediat pe cea veche.

Folosește cheia în solicitările tale așa: Authorization: Bearer YOUR_API_KEY. Acest format standard de antet funcționează cu toate SDK-urile majore. Ține cheia la îndemână pentru iterații rapide în timpul dezvoltării.

Parametri endpoint Completări Chat

Trimiteți solicitări către /v1/chat/completions endpoint. Include array-ul tău de mesaje și setează modelul la uncensored. Poți ajusta parametri precum temperature și top_p pentru a controla creativitatea. Valorile mai mari produc răspunsuri mai variate.

Setează max_tokens limitarea lungimii ieșirii. Valoarea implicită este de 2.048 de tokeni dacă nu este specificată. Modelul suportă o fereastră de context de 100.000 de tokeni pentru prompt plus completare. Acest lucru permite conversații lungi fără trunchiere. Ajustează presence_penalty și frequency_penalty pentru a reduce repetiția în scenarii de role-play.

Folosește stop parametru pentru a opri generarea la anumite fraze. Acest lucru ajută la impunerea structurii dialogului. Acest seed parametrul asigură output-uri reproductibile pentru testare. Aceste instrumente îți oferă un control precis asupra comportamentului modelului.

Date de utilizare și răspunsuri în flux

Activați streaming-ul setând stream: true în cererea ta. API-ul returnează fragmente de text pe măsură ce sunt generate. Acest lucru reduce latența percepută pentru utilizatorii finali. Fiecare fragment include text parțial și metadate.

Datele de utilizare apar în ultimul fragment. Aceasta include numărul de token-uri de intrare și ieșire. Verificați usage câmp în ultimul obiect de răspuns. Acest lucru permite verificarea precisă a facturării fără apeluri API separate. Urmărește consumul de tokeni în timp real.

Gestionează terminarea fluxului cu atenție. Asigură-te că procesezi toate fragmentele înainte de a închide conexiunea. Ultimul fragment conține statistici complete de utilizare. Aceste date sunt esențiale pentru monitorizarea costurilor și performanței în aplicațiile de producție.

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)

Gestionarea erorilor și limitele de rată

API impune o limită de 300 de cereri pe minut per cheie. Cererile concurente sunt limitate la opt per cheie. Corpul cererii nu trebuie să depășească 8 MB. Depășirea acestor limite returnează un cod de eroare 429. Implementați o backoff exponențială pentru a gestiona vârfurile tranzitorii.

Erorile comune includ 401 pentru chei invalide și 402 pentru credit insuficient. Un răspuns 402 indică faptul că soldul preplătit este epuizat. Reîncarcă contul pentru a relua serviciul. Erorile nu consumă tokeni, astfel încât reîncercarea după remedierea problemei este gratuită.

Verificați corpul răspunsului pentru mesaje de eroare detaliate. API-ul returnează un obiect JSON cu un tip de eroare și un mesaj. Utilizați aceste informații pentru a depana problemele rapid. Gestionarea corectă a erorilor asigură o experiență fluidă pentru utilizatorii dvs. în perioadele cu trafic ridicat.

ghid mod JSON și apelarea funcțiilor

Folosește modul JSON setând response_format pentru {"type": "json_object"}. Acest lucru forțează modelul să producă JSON valid. Este ideal pentru extragerea datelor structurate sau răspunsurile API. Asigură-te că prompt-ul descrie clar schema dorită.

Function calling permite modelului să invoce instrumente. Definiți instrumentele în corpul cererii. Modelul returnează apeluri de instrumente atunci când este cazul. Gestionați aceste apeluri în logica aplicației dvs. Acest lucru permite fluxuri de lucru complexe în mai mulți pași.

Combină modul JSON cu apelarea de funcții pentru integrări robuste. Validează ieșirea JSON pe partea de client. Folosește tool_choice parametru pentru a controla momentul invocării funcțiilor. Această flexibilitate suportă arhitecturi de aplicații diverse. Asigură-te că instrumentele tale sunt bine definite pentru o performanță optimă.

Detalii model și limitele ferestrei de context

The uncensored modelul suportă o fereastră de context de 100,000 de tokeni. Aceasta include atât promptul de input, cât și completarea de output. Outputul maxim este de 16,000 de tokeni per solicitare. Acest lucru permite scenarii extensive de roleplay fără întreruperea la jumătatea propoziției.

Modelul este open-weight și ajustat pentru conținut nelimitat. Nu refuză subiecte adulte legale. Nu este GPT, Claude sau niciun alt model de la un alt furnizor. Solicitățile sunt procesate pe serverele noastre dedicate. Acest lucru asigură performanță constantă și latență scăzută.

Monitorizați utilizarea contextului pentru a rămâne în limite. API-ul urmărește utilizarea tokenilor cu precizie. Erorile și refuzurile nu consumă tokeni. Acest model de facturare transparent vă ajută să anticipați costurile. Planificați ferestrele de context pentru a maximiza valoarea.