API-documentatie: Snelstartgids

Basis-URL en authenticatie

De Heretic AI API is volledig OpenAI-compatibel. Je communiceert ermee door je client naar onze basis-URL te wijzen: https://api.hereticai.cc/v1. Authenticatie is afhankelijk van één API-sleutel per account, die direct bij aanmelding via Google of e-mail wordt gegenereerd. Geef deze sleutel door in de Authorization header als een Bearer-token. De modelidentificatie is eenvoudigweg uncensored. Dit enkele model verwerkt al je requests zonder routeringscomplexiteit. Fouten zoals 401 duiden op een ongeldige sleutel, terwijl 402 betekent dat je meer vooruitbetaald crypto tegoed nodig hebt.

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

Chat Completions Endpoint

Stuur tekstverzoeken met behulp van de POST /v1/chat/completions endpoint. De API verwacht een standaard messages-array met uw gespreksgeschiedenis of prompt. Het retourneert gegenereerde tekst in de choices array. Dit is een pure utility API: tekst in, tekst uit. Je betaalt alleen voor verbruikte tokens. Voorgekrediteerde kredieten vervallen nooit, en afwijzingen of fouten kosten geen tokens. Deze aanpak elimineert abonnementsvergrendelingen en onvoorspelbare gratis tiers.

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)

Streaming-responsen (SSE)

Activeer realtime tokenstreaming door stream: true in je verzoek. De API retourneert Server-Sent Events (SSE) voor elke gegenereerde token. Dit stelt je in staat om de uitvoer progressief weer te geven, wat cruciaal is voor latentiegevoelige applicaties. Tokenverbruiksstatistieken verschijnen in het laatste chunk van de stream. Deze functie werkt naadloos met standaard OpenAI SDK's die SSE automatisch afhandelen. Het biedt directe feedback zonder te wachten op de volledige voltooiing.

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)

Function Calling en tools

De API ondersteunt function calling met de tools en tool_choice parameters. Definieer je toolschema's in het verzoek, en het model retourneert gestructureerde functieaanroepen wanneer dat gepast is. Dit maakt complexe workflows mogelijk waarbij de LLM beslist welke actie hij als volgende moet ondernemen. Je kunt specifiek toolgebruik afdwingen of het model de vrije keuze geven. Deze mogelijkheid is essentieel voor het bouwen van agentic applicaties die met externe systemen of databases communiceren.

JSON-modus

Zorg ervoor voor deterministische output door response_format naar {"type": "json_object"}. Het model zal zijn respons beperken tot geldige JSON, wat essentieel is voor programmatisch parseren. Dit vermindert de behoefte aan post-processing regex-aanpassingen. Het garandeert dat de uitvoer direct door je code kan worden verbruikt. Dit is bijzonder nuttig voor gestructureerde data-extractie of configuratiegeneratietaken.

Parameters en limieten

Reguleer de generatie met standaardparameters zoals temperature, top_p, en seed. Het contextvenster is 100.000 tokens voor prompt plus completion. Maximaal output is 16.000 tokens per verzoek, of 2.048 als max_tokens is niet ingesteld. Snelheidslimieten zijn 300 verzoeken per minuut en 8 gelijktijdige verzoeken per sleutel. Het aanvraaglichaam moet onder de 8 MB blijven. Deze limieten zorgen voor stabiel gebruik met hoge volumes voor ontwikkelaars.

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