API-referentie

Basis-URL en authenticatie

Gebruik de speciale basis-URL voor alle verzoeken. Uw API-sleutel verifieert via de Authorization header.

• Basis-URL: https://api.hereticuncensored.com/v1
• Model-ID: uncensored

Haal je sleutel op vanuit het dashboard. Deze is direct geldig bij aanmaak.

Copycurl https://api.hereticuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five features of the new release."}]
  }'

Eerste verzoek

Stuur een eenvoudige chatcompletion om de connectiviteit te verifiëren. Het model reageert zonder standaard inhoudsfilters voor wettelijk volwassen gebruik.

• Instellen model naar uncensored.
• Voeg je messages array.

Controleer de response op choices met je gegenereerde tekst.

Copyfrom openai import OpenAI

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

Initialiseer de client met je basis-URL en sleutel. Dit zorgt voor compatibiliteit met standaard OpenAI-bibliotheken.

• Installeer de officiële openai pakket.
• Doorsturen baseURL en apiKey tijdens initialisatie.

Oproep chat.completions.create() met je prompt. De responsstructuur spiegelt de standaard API-indeling.

Copyimport OpenAI from "openai";

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

Real-time tokenlevering inschakelen door stream naar true. Dit vermindert de waargenomen latentie voor lange outputs.

• Luister naar delta chunks.
• Combineer deltas om de volledige respons te reconstrueren.

Tokengebruiksmetadata verschijnt in het laatste chunk. Dit is ideaal voor chatinterfaces die directe feedback vereisen.

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)

Rate Limits en context

De API ondersteunt een contextvenster van 100.000 tokens. Je kunt maximaal 300 verzoeken per minuut per sleutel verzenden.

• Max gelijktijdige verzoeken: 8
• Maximale uitvoertokens: 16.000 (standaard 2.048)

Het overschrijden van limieten activeert een 429-fout. Beheer de concurrentie om een consistente doorvoer te behouden voor workloads met hoog volume.

Fouthantering en Codes

Handel fouten soepel af om de stabiliteit van de applicatie te behouden. Veelvoorkomende codes zijn 401 voor ongeldige sleutels en 402 voor onvoldoende credit.

• 429 geeft limietuitputting aan.
• 400 signaleert een verkeerd gevormde request body.

Restituties worden niet uitgegeven voor verbruikte tokens. Controleer regelmatig uw saldo om onderbrekingen van de service te voorkomen.