Începe rapid: API-ul Chat Completions

Precondiții și URL de bază

API-ul nostru este compatibil cu interfața standard de completări chat OpenAI. Aveți nevoie doar de un URL de bază și o cheie API pentru a începe trimiterea de cereri. URL-ul de bază este HTTPS://api.howmuchisanapikey.com/v1. Acest singur endpoint gestionează toate generările de text fără a necesita gestionarea mai multor URL-uri de servicii sau configurații de proxy.

Autentificarea este simplă. Trebuie să incluzi un antet Authorization cu schema Bearer urmată de cheia ta unică. Fiecare cerere către endpoint-ul de completări chat necesită acest antet pentru a-ți valida contul și a urmări utilizarea tokenilor în raport cu soldul tău preplătit.

Autentificare și anteturi

Includeți antetul Authorization în fiecare solicitare pentru a vă verifica identitatea. Formatul antetului este Authorization: Bearer YOUR_API_KEY. Dacă cheia este invalidă sau expirată, API-ul returnează imediat o eroare 401. Acest lucru asigură că doar conturile autorizate pot consuma creditul preplătit.

Nu trebuie să pasezi antete suplimentare pentru generarea de text de bază. Totuși, dacă utilizezi funcții specifice precum modul JSON sau apelarea de funcții, trebuie să setezi antetul Content-Type la application/json. Acest lucru îi spune serverului cum să analizeze corect corpul cererii tale.

Trimiterea primei tale completări de chat

Trimiteți o cerere POST către /v1/chat/completions cu istoricul de mesaje și identificatorul modelului. ID-ul modelului este "uncensored". Acest model este finetunat să răspundă fără refuzuri pentru conținut adult legal, ficțiune sau subiecte controversate. Nu filtrează în funcție de normele politice sau sociale standard.

Iată un exemplu basic curl pentru a începe:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

Răspunsul va conține textul generat în array-ul de opțiuni. Puteți să-l analizați direct în logica aplicației dumneavoastră. Fiecare solicitare consumă tokeni de intrare pentru promptul dumneavoastră și tokeni de ieșire pentru răspunsul modelului.

Utilizarea tokenilor și răspunsuri în flux

Folosiți Server-Sent Events (SSE) pentru a primi tokenii pe măsură ce sunt generați. Acest lucru reduce latența percepută pentru ieșirile lungi. Setează parametrul stream la true în corpul cererii. Serverul va trimite mai multe chunk-uri, fiecare conținând un delta parțial al răspunsului.

Ultimul fragment include datele de utilizare. Acest obiect conține totalul tokenilor de intrare și de ieșire consumați de solicitare. Poți utiliza aceste date pentru a actualiza soldul local al creditului sau pentru a-ți monitoriza cheltuielile în timp real. Streaming-ul este ideal pentru interfețele de chat unde utilizatorii așteaptă feedback instant.

Function calling și modul JSON

API-ul suportă output-uri structurate prin modul JSON și apelarea de funcții. Setează response_format la {"type": "json_object"} pentru a forca modelul să returneze JSON valid. Acest lucru este util pentru extragerea de date sau generarea de configurații structurate fără erori de analiză.

Pentru function calling, furnizează un array tools în solicitarea ta. Modelul va răspunde cu tool_calls dacă determină că este nevoie de o funcție. Poți apoi executa funcția și trimite rezultatul înapoi la model. Acest lucru permite fluxuri de lucru complexe, multi-pas, fără logică de parsing externă.

Gestionarea limitelor și a erorilor

Sunteți limitat la 300 de cereri pe minut per cheie și 8 cereri concurente. Dacă depășiți aceste limite, veți primi o eroare 429 Too Many Requests. Corpul răspunsului va include detalii retry-after. Ajustați limitarea în client pentru a evita reîncercările inutile.

Dacă creditul preplătit este epuizat, API-ul returnează o eroare 402 Payment Required. Puteți reîncărca prin criptomonede în orice moment. Erorile și refuzurile sunt gratuite, așa că plătiți doar pentru generarea de tokeni reușită. Fereastra de context este de 100,000 de tokeni pentru prompt și completare combinate.

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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)