API Quickstart și integrare

URL de bază și autentificare

Proiectul Heretic oferă un singur endpoint găzduit pentru generarea de text. Folosește https://api.hereticproject.com/v1 ca URL-ul tău de bază. Autentificarea se bazează pe un token bearer trecut prin Authorization header. Creează-ți cheia autentificându-te cu Google sau email pe panoul de control. Sistemul emite o singură cheie activă per cont; generarea unei noi chei invalidează imediat pe cea anterioară.

Plătești doar pentru tokenii consumați. Erorile și refuzurile nu îți consumă creditul preplătit. Un cont nou primește $0.50 în credit de probă, valabil timp de 7 zile. Completezi folosind USDT (TRC20) sau USDC (Base) în sume între $20 și $500.

Punctul final /v1/chat/completions

Trimite mesaje la endpoint-ul standard de completări chat. ID-ul modelului este uncensored. It accepts a list of message objects with roles like system, user, sau assistant. Modelul nu refuză subiecte legale pentru adulți, fictive sau controversate. Este un model cu greutate deschisă, optimizat pentru răspunsuri directe.

Cererile returnează un obiect JSON care conține textul generat. Fereastra de context suportă 100,000 de tokeni combinați pentru prompt și completare. Ieșirea este limitată la 16,000 de tokeni per cerere, decât dacă specificați o valoare mai mică max_tokens valoare.

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Integrare SDK Python

Folosește biblioteca oficială Python OpenAI cu un URL de bază personalizat. Setează api_key la șirul tău API. Configurează base_url către punctează la serverul Proiectului Heretic. Acest lucru îți permite să folosești metode familiare precum chat.completions.create() fără a modifica semnificativ structura codului tău existent.

Instalează biblioteca prin pip. Transmite acreditările direct la inițializarea clientului. Biblioteca gestionează automat serializarea. Această abordare funcționează atât pentru fluxurile de lucru sincrone, cât și asincrone. Asigură-te că gestionezi erorile de rețea potențiale în mod elegant.

Copyfrom openai import OpenAI

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

Integrare SDK Node

SDK-ul Node.js funcționează identic cu versiunea Python. Inițializează clientul cu cheia ta API și URL-ul de bază corect. Poți trimite solicitări de completăre folosind aceleași semnături de metodă. Acest lucru asigură consistența între diferitele părți ale stivei tale.

Gestionați răspunsurile în mod asincron. SDK-ul transmite date dacă utilizați metoda de streaming. În caz contrar, returnează întregul răspuns JSON. Această flexibilitate suportă atât procesarea în loturi, cât și interfețele în timp real. Păstrați-vă cheia API în siguranță în variabilele de mediu.

Copyimport OpenAI from "openai";

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

Răspunsuri în streaming (SSE)

Activați streaming-ul setând stream: true în cererea ta. Serverul trimite Evenimente trimise de server (SSE). Fiecare fragment conține actualizări de text parțial. Acest lucru reduce latența percepută pentru utilizatorii finali. Datele privind utilizarea tokenilor apar în fragmentul final al fluxului.

Procesează fiecare obiect delta pentru a acumula răspunsul complet. Oprește ascultarea când fluxul se închide sau apare o eroare. Această metodă este ideală pentru interfețele de chat. Permite utilizatorilor să vadă gândurile formându-se în timp real. Suprasarcina este minimă comparativ cu răspunsurile complete.

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)

Limitări, Erori și Context

Respectați limitele de rată pentru a evita întreruperile serviciului. Aveți voie la 300 de solicitări pe minut per cheie. Concurența este limitată la 8 solicitări simultane. Corpul solicitării nu poate depăși 8 MB. Depășirea acestor limite returnează codul de stare 429. Așteptați puțin înainte de a reîncerca.

Eșecurile de autentificare returnează o eroare 401. Acest lucru se întâmplă dacă cheia este invalidă sau expirată. O eroare 402 indică credit preplata insuficient. Greșelile de rambursare sunt gestionate prin pagina Support. Creditul nu expiră niciodată. Modelul refuză conținutul care implică minori. Tot conținutul legal este acceptat.