API-snabbstart och integration

Bas URL och autentisering

Heretic Project erbjuder en enda, hostad slutpunkt för textgenerering. Använd https://api.hereticproject.com/v1 som din bas-URL. Autentiseringen bygger på en bearer-token som skickas via Authorization header. Skapa din nyckel genom att logga in med Google eller e-post på kontrollpanelen. Systemet utfärdar en aktiv nyckel per konto; att generera en ny nyckel ogiltigförklarar den tidigare omedelbart.

Du betalar endast för förbrukade tokens. Fel och avslag debiterar inte din förskottskredit. Ett nytt konto får $0.50 i provkredit som gäller i sju dagar. Du laddar upp med USDT (TRC20) eller USDC (Base) i belopp mellan $20 och $500.

Slutpunkten /v1/chat/completions

Skicka meddelanden till standard chattkompletteringsslutpunkten. Modell-ID:t är uncensored. Det accepterar en lista med message-objekt med roller som system, user, eller assistant. Modellen vägrar inte lagligt vuxet, fiktivt eller kontroversiellt innehåll. Det är en öppen vikt-modell justerad för direkta svar.

Förfrågningar returnerar ett JSON-objekt som innehåller den genererade texten. Kontextrutan stöder 100,000 tokens kombinerat för prompt och komplettering. Utmatningen är begränsad till 16,000 tokens per förfrågan om du inte anger en lägre max_tokens värde.

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"}]
  }'

Python SDK-integration

Använd det officiella OpenAI Python-biblioteket med en anpassad bas-URL. Ange api_key till din API-sträng. Konfigurera base_url att peka mot Heretic Project-servern. Detta gör att du kan använda bekanta metoder som chat.completions.create() utan att modifiera din befintliga kodstruktur nämnvärt.

Installera biblioteket via pip. Ange dina uppgifter direkt vid klientinitieringen. Biblioteket hanterar serialisering automatiskt. Detta tillvägagångssätt fungerar för både synkrona och asynkrona arbetsflöden. Se till att hantera potentiella nätverksfel på ett smidigt sätt.

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)

Node SDK-integration

Node.js-SDK:et fungerar identiskt som Python-versionen. Initiera klienten med din API-nyckel och korrekt bas-URL. Du kan skicka slutförandeförfrågningar med samma metodsignaturer. Detta säkerställer konsistens över olika delar av ditt stack.

Hantera svar asynkront. SDK:et strömmar data om du använder strömningsmetoden. Annars returnerar det hela JSON-svaret. Denna flexibilitet stöder både batchbearbetning och gränssnitt i realtid. Håll din API-nyckel säker i miljövariabler.

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);

Strömningsresponser (SSE)

Aktivera strömning genom att ställa in stream: true i ditt begäran. Servern skickar Server-Sent Events (SSE). Varje bit innehåller delvisa textuppdateringar. Detta minskar den upplevda latensen för slutanvändare. Tokenanvändningsdata visas i den sista biten av strömmen.

Bearbeta varje deltaobjekt för att ackumulera hela svaret. Sluta lyssna när strömmen stängs eller ett fel inträffar. Denna metod är idealisk för chattgränssnitt. Den låter användare se tankar formas i realtid. Överhead är minimal jämfört med fullständiga svar.

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)

Gränser, fel och kontext

Respektera hastighetsbegränsningarna för att undvika tjänsteförsämring. Du har tillstånd till 300 begäranden per minut per nyckel. Koncurrenteten är begränsad till 8 samtidiga begäranden. Begärans kropp får inte överstiga 8 MB. Att överskrida dessa gränser returnerar en 429-statuskod. Vänta kort innan du försöker igen.

Autentiseringsfel returnerar ett 401-fel. Detta händer om nyckeln är ogiltig eller utgången. Ett 402-fel indikerar otillräckligt förbetalt kredit. Fel vid felaktig återbetalning hanteras via supportsidan. Kredit löper aldrig ut. Modellen vägrar innehåll som involverar minderåriga. All annan laglig accepteras.