API-Referenz

Basis-URL und Authentifizierung

Verwenden Sie die dedizierte Basis-URL für alle Anfragen. Ihr API-Schlüssel authentifiziert über den Authorization header.

• Base URL: https://api.hereticuncensored.com/v1
• Modell-ID: uncensored

Rufen Sie Ihren Schlüssel aus dem Dashboard ab. Er ist sofort nach der Erstellung gültig.

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

Erste Anfrage

Sende eine einfache Chat-Vervollständigung, um die Konnektivität zu überprüfen. Das Modell antwortet ohne Standard-Inhaltsfilter für legale erwachsene Nutzung.

• Festlegen model zu uncensored.
• Schließen Sie Ihre messages array.

Prüfen Sie die Antwort auf choices enthält Ihren generierten Text.

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

Initialisieren Sie den Client mit der Basis-URL und dem Schlüssel. Dies gewährleistet die Kompatibilität mit Standard OpenAI-Bibliotheken.

• Installieren Sie die offizielle openai Paket.
• Bestehen baseURL und apiKey während der Initialisierung.

Anruf chat.completions.create() mit Ihrem Prompt. Die Antwortstruktur entspricht dem Standard-API-Format.

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

Echtzeit-Token-Bereitstellung aktivieren, indem Sie stream zu true. Dies reduziert die wahrgenommene Latenz für lange Ausgaben.

• Lauschen auf delta Chunks.
• Kombinieren Sie Deltas, um die vollständige Antwort zu rekonstruieren.

Die Token-Nutzungsmetadaten erscheinen im finalen Chunk. Dies ist ideal für Chat-Oberflächen, die sofortiges Feedback erfordern.

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)

Ratenbegrenzungen und Kontext

Die API unterstützt ein Kontextfenster von 100.000 Token. Sie können bis zu 300 Anfragen pro Minute pro Schlüssel senden.

• Max. gleichzeitige Anfragen: 8
• Maximale Ausgabe-Tokens: 16.000 (Standard 2.048)

Das Überschreiten der Grenzen löst einen 429-Fehler aus. Verwalten Sie die Parallelität, um einen gleichbleibenden Durchsatz für Workloads mit hohem Volumen aufrechtzuerhalten.

Fehlerbehandlung und Codes

Behandle Fehler korrekt, um die Stabilität der Anwendung aufrechtzuerhalten. Häufige Codes sind 401 für ungültige Schlüssel und 402 für unzureichendes Guthaben.

• 429 zeigt Erschöpfung des Ratenlimits an.
• 400 signalisiert fehlerhafte Anfragekörper.

Rückerstattungen werden für verbrauchte Tokens nicht ausgestellt. Überprüfen Sie regelmäßig Ihr Guthaben, um Dienstunterbrechungen zu vermeiden.