Documentație API

Quickstart: Prima solicitare

Trimite primul tău mesaj către modelul uncensored imediat. Folosește endpoint-ul standard chat-completions pentru a genera text. Modelul răspunde la prompturi în limbaj natural fără refuzuri de conținut pentru uz adult legal. Această configurare funcționează cu orice client compatibil OpenAI.

Începeți prin a instala SDK-ul pentru limbajul preferat. Apoi configurați cheia API. Exemplul următor arată o solicitare curl de bază pentru a testa conectivitatea.

Puteți ajusta parametri precum temperature pentru a controla aleatorietatea. Răspunsul returnează textul generat direct. Acest flux simplu vă permite să verificați funcționarea API-ului înainte de a construi logica complexă.

Copycurl https://api.apiaicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current API rate limit status?"}]
  }'

URL de bază și autentificare

Conectează-te folosind URL-ul de bază dedicat pentru acest API. Înlocuiește endpoint-ul implicit cu adresa serverului nostru găzduit. Acest lucru asigură că cererile tale ajung direct la modelul uncensored. Autentificarea se bazează pe o singură cheie API per cont.

Generează-ți cheia prin panoul de control. Transmite-o în antetul Authorization ca token Bearer. Această metodă este compatibilă cu SDK-urile standard OpenAI. Poți schimba furnizorii modificând doar URL-ul de bază și cheia.

Mențineți cheia în siguranță. Aceasta oferă acces complet la creditul preplătit. Chea înlocuiește orice cheie activă anterioară imediat după generare.

Puncte finale: Chat Completions

Interacțiune cu modelul prin endpoint-ul chat completions. Acesta este singurul endpoint de generare de text disponibil. Acceptă mesaje și returnează text generat. Nu sunt suportate embeddings, imagini sau audio.

Trimiteți o cerere POST către ruta chat. Includeți mesajele de sistem și utilizator în body. Modelul procesează contextul și generează un răspuns. Puteți utiliza modul JSON pentru output structurat.

Se suportă funcționarea prin apeluri de funcții. Definiți instrumentele și lăsați modelul să decidă când să le utilizeze. Această flexibilitate permite fluxuri de lucru complexe pentru agenți. Răspunsul include conținutul generat și utilizarea tokenilor.

Copyfrom openai import OpenAI

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

Parametri: Temperatură, Top P și Stop

Controlează stilul de ieșire folosind parametrii standard. Ajustează temperatura pentru a modifica creativitatea. Valorile mai mici fac răspunsurile mai deterministe. Valorile mai mari introduc mai multă varietate.

Folosește top P pentru a filtra cuvintele puțin probabile. Acest lucru ajută la menținerea coerenței în timp ce permite creativitatea. Setează secvențele de oprire pentru a încheia generarea la markeri specifici. Acest lucru este util pentru controlul structurii dialogului.

Parametrul seed permite rezultate reproductibile. Folosește-l când depanezi prompturile tale. Acești parametri îți oferă un control precis asupra comportamentului modelului. Ajustează-i pentru a se potrivi nevoilor aplicației tale.

Copyimport OpenAI from "openai";

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

Streaming și Utilizarea Tokenilor

Primește răspunsuri în timp real folosind server-sent events. Streaming-ul reduce latența percepută pentru utilizatori. API-ul trimite tokeni pe măsură ce sunt generați. Acest lucru creează o experiență de citire mai fluidă.

Utilizarea tokenilor este raportată în ultimul fragment. Acest lucru îți permite să urmărești costurile cu precizie. Facturarea se bazează pe tokenii consumați efectiv. Erorile și refuzurile nu generează taxe.

Implementați un handler de flux pentru a procesa datele. Actualizați interfața utilizatorului pe măsură ce ajung tokenii. Această abordare este ideală pentru interfețele de chat. Modelul suportă fluxul pentru toate tipurile de solicitări.

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)

Limite de rată și constrângeri

Înțelegeți limitele pentru a evita întreruperile serviciului. Puteți face 300 de solicitări pe minut per cheie. Solicitățile concurente sunt limitate la opt simultan. Corpul solicitării nu trebuie să depășească 8 MB.

Gestionați erorile cu grijă. Un status 401 înseamnă că cheia ta este nevalidă. Un status 402 indică credit insuficient. Un status 429 semnalează că ai atins limita de rată.

Fereastra de context suportă un total de 100.000 de tokeni. Acesta include atât promptul, cât și completarea. Rezultatul maxim este de 16.000 de tokeni per solicitare. Setează max_tokens pentru a controla lungimea rezultatului. Erorile sunt gratuite, astfel încât logica de reîncercare este sigură.