Documentație API: Ghid de începere rapidă

URL de bază și autentificare

API-ul Heretic AI este complet compatibil cu OpenAI. Interacționezi cu acesta indicând clientul tău către URL-ul nostru de bază: https://api.hereticai.cc/v1. Autentificarea se bazează pe o singură cheie API per cont, generată instantaneu la înregistrare prin Google sau email. Transmiteți această cheie în Authorization header ca un token Bearer. Identificatorul modelului este simplu uncensored. Acest model unic gestionează toate cererile tale fără complexitatea rutării. Erorile precum 401 indică o cheie invalidă, în timp ce 402 înseamnă că ai nevoie de mai mult credit crypto preplătit.

Copycurl https://api.hereticai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "generate twenty test cases"}]
  }'

Endpoint Completări Chat

Trimite cereri de generare text folosind POST /v1/chat/completions endpoint. API-ul așteaptă un array standard de mesaje care conține istoricul conversației sau promptul tău. Returnează text generat în choices array. Aceasta este o API pur utilitară: text intră, text iese. Plătești doar pentru tokenii consumați. Creditele preplătite nu expiră niciodată, iar refuzurile sau erorile nu costă tokeni. Această abordare elimină blocările de abonament și nivelurile gratuite imprevizibile.

Copyfrom openai import OpenAI

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

Activați streaming-ul tokenilor setând stream: true în cererea dumneavoastră. API-ul returnează Evenimente trimise de server (SSE) pentru fiecare token generat. Acest lucru vă permite să afișați ieșirea progresiv, ceea ce este crucial pentru aplicațiile sensibile la latență. Statisticile de utilizare a tokenilor apar în fragmentul final al fluxului. Această funcție funcționează perfect cu SDK-urile standard OpenAI care gestionează automat SSE. Oferă feedback imediat fără a aștepta completarea completă.

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 instrumentele

API-ul acceptă apelarea de funcții cu tools și tool_choice parametri. Definiți schemele instrumentelor în solicitare, iar modelul va returna apeluri de funcții structurate atunci când este potrivit. Acest lucru permite fluxuri de lucru complexe în care LLM decide ce acțiune să întreprindă următoare. Puteți forța utilizarea unor instrumente specifice sau lăsa modelul să aleagă liber. Această capabilitate este esențială pentru construirea de aplicații agențice care interacționează cu sisteme externe sau baze de date.

Mod JSON

Asigurați-vă ieșiri deterministe setând response_format pentru {"type": "json_object"}. Modelul va restricționa răspunsul la JSON valid, ceea ce este vital pentru analizarea programatică. Acest lucru reduce nevoia de remedieri cu expresii cu caractere regulare post-procesare. Garantează că ieșirea poate fi consumată direct de codul tău. Acest lucru este deosebit de util pentru extragerea structurată a datelor sau generarea de configurații.

Parametri și limite

Controlează generarea cu parametri standard precum temperature, top_p, și seed. Fereastra de context este de 100.000 de tokeni pentru prompt plus completarea. Ieșirea maximă este de 16.000 de tokeni per solicitare, sau 2.048 dacă max_tokens este nedefinit. Limitele de rată sunt de 300 de solicitări pe minut și 8 solicitări concurente pe cheie. Corpul solicitării trebuie să rămână sub 8 MB. Aceste limite asigură o utilizare stabilă în volum mare pentru dezvoltatori.

Node.js

Copyimport OpenAI from "openai";

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