API-Schnellstart & Integration

Basis-URL und Authentifizierung

Das Heretic-Projekt bietet einen einzelnen, gehosteten Endpunkt für Textgenerierung. Verwenden https://api.hereticproject.com/v1 als Ihre Basis-URL. Die Authentifizierung erfolgt über ein Bearer-Token, das über den Authorization header. Erstellen Sie Ihren Schlüssel, indem Sie sich über Google oder E-Mail im Dashboard anmelden. Das System gibt einen aktiven Schlüssel pro Konto aus; das Generieren eines neuen Schlüssels macht den vorherigen sofort ungültig.

Sie zahlen nur für verbrauchte Tokens. Fehler und Ablehnungen belasten Ihr Prepaid-Guthaben nicht. Ein neues Konto erhält $0,50 Testguthaben, das sieben Tage gültig ist. Sie laden mit USDT (TRC20) oder USDC (Base) in Höhe von $20 bis $500 auf.

Der Endpunkt /v1/chat/completions

Senden Sie Nachrichten an den standardmäßigen Chat-Completions-Endpunkt. Die Modell-ID ist uncensored. Es akzeptiert eine Liste von Nachrichtenobjekten mit Rollen wie system, user, oder assistant. Das Modell lehnt rechtmäßige erwachsene, fiktive oder kontroverse Themen nicht ab. Es ist ein Open-Weight-Modell, das auf direkte Antworten abgestimmt ist.

Anfragen geben ein JSON-Objekt zurück, das den generierten Text enthält. Das Kontextfenster unterstützt insgesamt 100.000 Tokens für Prompt und Completion. Die Ausgabe ist auf 16.000 Tokens pro Anfrage begrenzt, es sei denn, Sie geben einen niedrigeren max_tokens Wert.

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

Verwenden Sie die offizielle OpenAI-Python-Bibliothek mit einer benutzerdefinierten Basis-URL. Legen Sie api_key Ihrem API-String konfigurieren. Konfigurieren base_url auf den Heretic Project Server zeigen. Dies ermöglicht Ihnen die Verwendung vertrauter Methoden wie chat.completions.create() ohne Ihre bestehende Code-Struktur signifikant zu ändern.

Installieren Sie die Bibliothek über pip. Übergeben Sie Ihre Anmeldedaten direkt bei der Client-Initialisierung. Die Bibliothek übernimmt automatisch die Serialisierung. Dieser Ansatz funktioniert sowohl für synchrone als auch für asynchrone Arbeitsabläufe. Stellen Sie sicher, dass Sie potenzielle Netzwerkfehler angemessen behandeln.

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

Das Node.js SDK funktioniert identisch wie die Python-Version. Initialisieren Sie den Client mit Ihrem API-Schlüssel und der korrekten Basis-URL. Sie können Completion-Anfragen mit denselben Methodensignaturen senden. Dies gewährleistet Konsistenz in verschiedenen Bereichen Ihrer Stack-Architektur.

Verwalten Sie Antworten asynchron. Das SDK streamt Daten, wenn Sie die Streaming-Methode verwenden. Andernfalls gibt es die vollständige JSON-Antwort zurück. Diese Flexibilität unterstützt sowohl Batch-Verarbeitung als auch Echtzeit-Schnittstellen. Bewahren Sie Ihren API-Schlüssel sicher in Umgebungsvariablen auf.

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-Antworten (SSE)

Aktivieren Sie Streaming, indem Sie stream: true in Ihrer Anfrage. Der Server sendet Server-Sent Events (SSE). Jeder Chunk enthält teilweise Textaktualisierungen. Dies reduziert die wahrgenommene Latenz für Endbenutzer. Token-Nutzungsdaten erscheinen im letzten Chunk des Streams.

Verarbeiten Sie jedes Delta-Objekt, um die vollständige Antwort zu akkumulieren. Beenden Sie das Lauschen, wenn der Stream endet oder ein Fehler auftritt. Diese Methode ist ideal für Chat-Schnittstellen. Sie ermöglicht es Benutzern, Gedanken in Echtzeit entstehen zu sehen. Der Overhead ist im Vergleich zu vollständigen Antworten minimal.

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)

Limits, Fehler und Kontext

Respektieren Sie die Rate-Limits, um Serviceunterbrechungen zu vermeiden. Sie dürfen 300 Anfragen pro Minute pro Schlüssel senden. Die Parallelität ist auf 8 gleichzeitige Anfragen begrenzt. Der Anfragekörper darf 8 MB nicht überschreiten. Das Überschreiten dieser Limits führt zu einem 429-Statuscode. Warten Sie kurz, bevor Sie es erneut versuchen.

Authentifizierungsfehler geben einen 401-Fehler zurück. Dies geschieht, wenn der Schlüssel ungültig oder abgelaufen ist. Ein 402-Fehler zeigt unzureichendes vorausbezahltes Guthaben an. Rückerstattungsfehler werden über die Support-Seite behandelt. Guthaben verfällt nie. Das Modell lehnt Inhalte ab, die Minderjährige betreffen. Alle anderen rechtmäßigen Inhalte werden akzeptiert.