API-snelstart & integratie

Basis-URL en authenticatie

Het Heretic Project biedt een enkel, gehost eindpunt voor tekstgeneratie. Gebruik https://api.hereticproject.com/v1 als je basis-URL. Authenticatie verloopt via een bearer token dat wordt doorgegeven via de Authorization header. Maak je sleutel aan door in te loggen met Google of e-mail op het dashboard. Het systeem geeft één actieve sleutel per account; het genereren van een nieuwe sleutel maakt de vorige direct ongeldig.

Je betaalt alleen voor verbruikte tokens. Fouten en weigeringen belasten je voorgeladen tegoed niet. Een nieuw account ontvangt $0,50 aan proeftegoed dat zeven dagen geldig is. Je laadt op met USDT (TRC20) of USDC (Base) in bedragen tussen $20 en $500.

Het /v1/chat/completions-eindpunt

Stuur berichten naar het standaard chat-completions eindpunt. De model ID is uncensored. Het accepteert een lijst van message-objecten met rollen zoals system, user, of assistant. Het model weigert geen wettige volwassen, fictieve of controversiële onderwerpen. Het is een open-weight model getuned voor directe antwoorden.

Requests retourneren een JSON-object met de gegenereerde tekst. Het contextvenster ondersteunt 100.000 tokens in totaal voor prompt en completion. De uitvoer is beperkt tot 16.000 tokens per request, tenzij je een lagere max_tokens waarde.

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 Integratie

Gebruik de officiële OpenAI Python-bibliotheek met een aangepaste basis-URL. Stel api_key naar je API-string. Configureer base_url naar de Heretic Project-server wijzen. Dit stelt je in staat bekende methoden zoals chat.completions.create() zonder je bestaande codestructuur aanzienlijk te wijzigen.

Installeer de bibliotheek via pip. Geef uw referenties direct door bij de clientinitialisatie. De bibliotheek behandelt serialisatie automatisch. Deze aanpak werkt voor zowel synchrone als asynchrone workflows. Zorg ervoor dat u potentiële netwerkfouten afhandelt met de nodige zorgvuldigheid.

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-integratie

De Node.js SDK werkt identiek aan de Python-versie. Initialiseer de client met je API-sleutel en de juiste basis-URL. Je kunt completion-verzoeken verzenden met dezelfde methodesignaturen. Dit zorgt voor consistentie tussen verschillende onderdelen van je stack.

Verwerk responsen asynchroon. De SDK streamt gegevens als je de streammethode gebruikt. Anders retourneert het de volledige JSON-respons. Deze flexibiliteit ondersteunt zowel batchverwerking als realtime interfaces. Houd je API-sleutel veilig in omgevingsvariabelen.

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

Streaming-responsen (SSE)

Activeer streaming door stream: true in je verzoek. De server stuurt Server-Sent Events (SSE). Elke chunk bevat gedeeltelijke tekstupdates. Dit vermindert de waargenomen latentie voor eindgebruikers. Gegevens over tokengebruik verschijnen in de laatste chunk van de stream.

Verwerk elk delta-object om het volledige antwoord op te bouwen. Stop met luisteren wanneer de stream sluit of er een fout optreedt. Deze methode is ideaal voor chatinterfaces. Het stelt gebruikers in gedachten te zien ontstaan in realtime. De overhead is minimaal in vergelijking met volledige antwoorden.

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)

Limieten, fouten en context

Houd rekening met de rate limits om onderbrekingen van de service te voorkomen. Je mag 300 verzoeken per minuut per sleutel doen. Het aantal gelijktijdige verzoeken is beperkt tot 8. De request body mag niet groter zijn dan 8 MB. Het overschrijden van deze limieten resulteert in een 429-statuscode. Wacht kort voordat je het opnieuw probeert.

Authenticatiefouten retourneren een 401-fout. Dit gebeurt als de sleutel ongeldig of verlopen is. Een 402-fout geeft onvoldoende vooruitbetaald tegoed aan. Teruggaven van fouten worden afgehandeld via de ondersteuningspagina. Tegoed vervalt nooit. Het model weigert inhoud die minderjarigen betreft. Alle andere wettige inhoud wordt geaccepteerd.