Hermes API: Wechsle deinen Client in drei Zeilen

Installiere das OpenAI SDK

Da unser Endpunkt OpenAI-kompatibel ist, kannst du die offiziellen SDKs verwenden, die du bereits kennst. Dieser Ansatz ermöglicht es dir, den Anbieter zu wechseln, ohne deine Anwendungslogik neu schreiben zu müssen. Wir unterstützen das Standardpaket openai für Python- und Node.js-Umgebungen.

Stelle sicher, dass du eine aktuelle Version des SDK verwendest, um die Kompatibilität mit Streaming- und Function-Calling-Funktionen zu gewährleisten. Die Client-Bibliothek übernimmt die JSON-Serialisierung und den HTTP-Transport automatisch, sodass du dich auf die Modellparameter konzentrieren kannst, anstatt auf Netzwerkdetails.

Konfiguriere Base URL & Schlüssel

Die Authentifizierung erfolgt über einen Bearer-Token im Authorization-Header. Du erhältst deinen Schlüssel, indem du dich mit E-Mail und Passwort in unserem Dashboard anmeldest. Für die Testphase ist keine Kreditkarte erforderlich, und du kannst deinen Schlüssel jederzeit neu generieren, um den Zugriff zu widerrufen.

Setze die Base URL auf unseren dedizierten Endpunkt. Dies stellt sicher, dass alle Anfragen an unsere Infrastruktur für das unzensierte Modell gesendet werden, anstatt an die Standard-OpenAI-Cloud. Du findest deinen API-Schlüssel auf der Seite „API-Schlüssel erhalten“ direkt nach der Anmeldung.

Sende deine erste Anfrage

Sende eine Standard-Chat-Vervollständigungsanfrage, um die Konnektivität zu testen. Die Modell-ID ist immer uncensored. Dieses Modell ist darauf ausgelegt, ohne Inhaltsablehnungen für legale erwachsene Nutzung zu antworten, was es ideal für kreatives Schreiben, Roleplay oder uneingeschränkte Forschung macht.

• Verwende POST /v1/chat/completions für die Textgenerierung.
• Das Kontextfenster unterstützt bis zu 100.000 Token für Prompt plus Vervollständigung.
• Anfragen werden basierend auf der Anzahl der Input- und Output-Token berechnet.

Copycurl https://api.hermesllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Aktiviere Streaming (SSE)

Für ein besseres Benutzererlebnis aktiviere Streaming, um Token zu erhalten, sobald sie generiert werden. Dies reduziert die wahrgenommene Latenz, insbesondere bei längeren Antworten. Der Server sendet Server-Sent Events (SSE), die dein Client in Echtzeit parsen kann.

Setze den Parameter stream in deinem Anfragekörper auf true. Das SDK liefert Chunks, sobald sie eintreffen. Dies ist besonders nützlich für Chat-Schnittstellen, bei denen du Text inkrementell anzeigen möchtest, anstatt auf das Ende der gesamten Antwort zu warten.

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)

Nutze Tool/Function Calling

Unsere API unterstützt Function Calling, wodurch das Modell strukturiertes JSON für die Ausführung externer Tools ausgeben kann. Definiere deine Funktionen im Parameter tools, und das Modell gibt bei Bedarf tool_calls in der Antwort zurück.

Diese Funktion funktioniert genau wie in der OpenAI-Spezifikation dokumentiert. Du kannst den Funktionsnamen und die Argumente parsen, deine Backend-Logik ausführen und die Ergebnisse zurück in die Konversation einspeisen. Sie ist vollständig kompatibel mit Standard-OpenAI-SDK-Workflows für Function Calling.

Copyimport OpenAI from "openai";

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

Prüfe verfügbare Modelle

Frag den Endpunkt /models ab, um die Konnektivität zu überprüfen und verfügbare Optionen zu sehen. Derzeit bieten wir ein einzelnes dediziertes Modell an: uncensored. Diese Einfachheit vermeidet die Komplexität des Model-Routings oder generischer Infrastruktur und gewährleistet vorhersehbares Verhalten.

Du kannst diesen Endpunkt auch zur Debugging von Authentifizierungsproblemen verwenden. Wenn die Anfrage fehlschlägt, überprüfe die Gültigkeit deines API-Schlüssels und die Netzwerkverbindung. Die Antwort listet die Modell-Details auf, einschließlich der Größe des Kontextfensters und der Token-Limits.

Copyfrom openai import OpenAI

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

Behandle Ratenlimits & Fehler

Unsere API begrenzt die Anzahl auf 300 Anfragen pro Minute und Schlüssel. Wenn du dieses Limit überschreitest, erhältst du einen 429-Fehler. Wir unterstützen zudem eine Anfragekörper-Grenze von 8 MB für komplexe Prompts oder große Kontextfenster.

Häufige Fehler sind 401 (ungültiger Schlüssel) und 402 (unzureichendes Guthaben). Prepaid-Guthaben verfällt nie, sodass du jederzeit aufladen kannst. Guthaben-Boni werden automatisch für größere Käufe angewendet: +5 % ab 50 $ und +10 % ab 100 $.