Hermes API: wissel je client in drie regels

Installeer de OpenAI SDK

Omdat onze endpoint OpenAI-compatibel is, kun je de officiële SDK's gebruiken die je al kent. Zo kun je overschakelen van andere leveranciers zonder je applicatielogica te herschrijven. We ondersteunen het standaard openai-pakket voor Python- en Node.js-omgevingen.

Zorg ervoor dat je een recente versie van de SDK gebruikt om compatibiliteit met streaming en function calling te garanderen. De clientbibliotheek verwerkt de JSON-serialisatie en HTTP-transport automatisch, zodat je je kunt concentreren op modelparameters in plaats van netwerkdetails.

Configureer Base URL & Sleutel

Authenticatie verloopt via een Bearer-token in de Authorization-header. Je verkrijgt je sleutel door je te registreren met een e-mailadres en wachtwoord op ons dashboard. Voor de proefversie is geen creditcard nodig en je kunt je sleutel op elk moment opnieuw genereren om de toegang te intrekken.

Stel de base URL in op onze speciale endpoint. Dit zorgt ervoor dat alle verzoeken naar onze infrastructuur voor het ongecensureerde model gaan in plaats van de standaard OpenAI-cloud. Je kunt je API-sleutel vinden op de pagina 'API-sleutel ophalen' direct na het aanmaken van je account.

Stuur je eerste verzoek

Stuur een standaard chat-completieverzoek om de verbinding te testen. De model-ID is altijd uncensored. Dit model is afgestemd op het geven van antwoorden zonder inhoudelijke weigeringen voor volwassen gebruik, wat het ideaal maakt voor creatief schrijven, roleplay of onderzoek zonder beperkingen.

• Gebruik POST /v1/chat/completions voor tekstgeneratie.
• Het contextvenster ondersteunt tot 100.000 tokens voor prompt plus completion.
• Verzoeken worden gefactureerd op basis van het aantal input- en outputtokens.

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

Schakel streaming (SSE) in

Voor een betere gebruikerservaring kun je streaming inschakelen om tokens te ontvangen zodra ze gegenereerd zijn. Dit vermindert de waargenomen latentie, vooral bij langere antwoorden. De server retourneert Server-Sent Events (SSE) die je client in realtime kan verwerken.

Stel de parameter stream in op true in je request body. De SDK levert chunks op zodra ze aankomen. Dit is vooral nuttig voor chatinterfaces waar je tekst incrementeel wilt weergeven in plaats van te wachten tot het hele antwoord klaar is.

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)

Gebruik tool/function calling

Onze API ondersteunt function calling, waardoor het model gestructureerde JSON kan uitvoeren voor de uitvoering van externe tools. Definieer je functies in de parameter tools, en het model retourneert tool_calls in het antwoord indien passend.

Deze functie werkt precies zoals gedocumenteerd in de OpenAI-specificatie. Je kunt de functienaam en argumenten parseren, je backend-logica uitvoeren en de resultaten terugvoeren in het gesprek. Het is volledig compatibel met standaard OpenAI SDK tool-calling workflows.

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

Controleer beschikbare modellen

Stel een verzoek in bij het models-endpoint om de verbinding te controleren en beschikbare opties te bekijken. Op dit moment bieden we één enkel dedicated model aan: uncensored. Deze eenvoud voorkomt de complexiteit van modelrouting of generieke infrastructuur, wat zorgt voor voorspelbaar gedrag.

Je kunt dit endpoint ook gebruiken om authenticatieproblemen te debuggen. Als het verzoek mislukt, controleer dan de geldigheid van je API-sleutel en de netwerkconnectiviteit. Het antwoord geeft de modeldetails weer, inclusief de grootte van het contextvenster en tokenlimieten.

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)

Verwerk rate limits en fouten

Onze API handhaaft een limiet van 300 verzoeken per minuut per sleutel. Als je deze overschrijdt, ontvang je een 429-fout. We ondersteunen ook een limiet van 8 MB voor de request body bij complexe prompts of grote contextvensters.

Veelvoorkomende fouten zijn 401 (ongeldige sleutel) en 402 (onvoldoende tegoed). Prepaid tegoed vervalt nooit, dus je kunt opwaarderen wanneer het jou uitkomt. Korting op tegoed wordt automatisch toegepast bij grotere aankopen: +5% vanaf $50 en +10% vanaf $100.