Hermes api Documentatie: Quickstart

Installatie en setup

De hermes API werkt met elke client die het OpenAI-formaat spreekt. Je hebt een basis-URL en een API-sleutel nodig. Maak een account aan via Google of e-mail op de pagina 'API-sleutel ophalen'. Het systeem toont je sleutel onmiddellijk. Er is geen telefoonnummer nodig. Je ontvangt $0,50 proefkrediet voor zeven dagen. Laad later alleen op met crypto.

• Basis-URL: HTTPS://api.apihermes.cc/v1
• Auth header: Authorization: Bearer YOUR_API_KEY
• Model-ID: uncensored

Installeer je favoriete SDK en stel de basis-URL in. Het eindpunt verwacht standaardparameters voor chatcompleties. Houd je sleutel veilig. Een sleutel vervangt de vorige als je een nieuwe genereert.

Basis Chat Completion Request

Een basisverzoek verzendt berichten en ontvangt een tekstantwoord. De model-ID is ongecensureerd. Het verwerkt wettige volwassen inhoud zonder weigering. Je betaalt per gebruikt token. Fouten en weigeringen kosten niets. Het contextvenster houdt in totaal 100.000 tokens vast.

Structureer je request met een system-message en user-message. De API retourneert een completion. Je kunt max_tokens instellen om de uitvoerlengte te bepalen. De standaard limiet voor uitvoer is 2.048 tokens. Je kunt dit verhogen naar 16.000 tokens per verzoek. Streaming werkt via SSE. Function calling is beschikbaar. JSON-modus wordt ondersteund.

Copycurl https://api.apihermes.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a GET request for the user endpoint"}]
  }'

De request body is beperkt tot 8 MB. Snelheidslimieten zijn 300 verzoeken per minuut. Concurrentie is acht verzoeken tegelijk. Retry-logica behandelt serveroverbelasting op een soepele manier.

Streaming-responsen met SSE

Streaming levert tokens zodra ze worden gegenereerd. De server verzendt Server-Sent Events. Elk chunk bevat gedeeltelijke tekst. Het laatste chunk bevat statistieken over tokenverbruik. Deze aanpak vermindert de waargenomen latentie voor lange responsen. Het is ideaal voor chatinterfaces. Je moet de stream correct verwerken. Verbindingen kunnen worden verbroken. De API garandeert geen leveringsvolgorde buiten de stream zelf.

Stel de stream-parameter in op true. Parseer de gegevensregels. Plak de inhoud. Controleer de finish_reason voor voltooiing. Het model uncensored werkt met elke OpenAI-compatible SDK. Configureer de client om SSE af te handelen. Houd het tokenaantal bij. De basis-URL blijft hetzelfde. Authenticatie is identiek. Er is geen extra setup nodig.

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)

Fouten verschijnen in de stream. Verwerk ze door de verbinding te sluiten. Het vooruitbetaalde tegoed wordt alleen afgeschreven voor voltooide tokens. Dit bespaart geld bij onderbrekingen. U betaalt nooit voor gedeeltelijke onzinoutput. Het systeem is transparant.

Function Calling en Tools gebruiken

Function calling stelt het model in staat code of tools uit te voeren. Definieer tools in de request body. Het model retourneert een toolaanroep. U voert de tool uit. U stuurt het resultaat terug. Het model genereert een definitief antwoord. Dit maakt complexe workflows mogelijk. Het is niet slechts een chatwrapper. De API ondersteunt tools en tool_choice. Gebruik dit voor agents of automatisering.

Structureer de tools-array. Voeg name, description en parameters toe. Het model beslist wanneer een tool moet worden aangeroepen. Je moet de argumenten parseren. Voer de functie uit. Stuur de output terug naar de conversatie. Het model gaat door. Deze cyclus herhaalt zich tot het eindantwoord. Het contextvenster houdt alle tool-interacties bij. Houd bij hoeveel tokens er worden verbruikt. Kosten lopen op door tool-outputs. Monitor het gebruik in de laatste chunk.

Copyfrom openai import OpenAI

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

Het uncensored-model verwerkt diverse toolschema's. Het weigert niet op basis van inhoud. Gebruik dit voor roleplay of technische taken. De API is betrouwbaar. Fouten zijn minimaal. Het prepaid-systeem zorgt voor eerlijkheid. Jij bepaalt de flow. De base URL is consistent. Authenticatie is eenvoudig.

JSON-modus en parameters

De JSON-modus forceert het model om geldige JSON uit te voeren. Stel response_format in op json_object. Dit is handig voor gestructureerde data. Het model vermijdt markdown-omhulsels. Het retourneert ruwe JSON. Gebruik dit voor parsing. Het verbetert de betrouwbaarheid. Het contextvenster geldt nog steeds. Je betaalt voor tokens. Het uncensored model respecteert het formaat. Het weigert niet op basis van content.

Parameters omvatten temperatuur, top_p, stop, seed, presence_penalty en frequency_penalty. Temperatuur regelt willekeurigheid. Top_p regelt diversiteit. Stop-reeksen stoppen de generatie. Seed zorgt voor reproduceerbaarheid. Aanwezigheids- en frequentiestrafpen passen tokengebruik aan. Stel deze in om de uitvoer te verfijnen. De API ondersteunt alle standaardparameters. Gebruik ze om de respons af te stellen. De basis-URL blijft hetzelfde. Authenticatie is identiek.

Copyimport OpenAI from "openai";

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

Fouten worden afgehandeld via HTTP-statuscodes. 401 betekent een ongeldige sleutel. 402 betekent geen tegoed. 429 betekent een limiet voor het aantal verzoeken. Verwerk deze in je code. Het voorbetaalde tegoed wordt alleen afgeschreven voor voltooide tokens. Dit zorgt voor eerlijkheid. Je betaalt nooit voor gedeeltelijke uitvoer. Het systeem is transparant. Het uncensored-model is betrouwbaar. Gebruik het voor elke wettige taak.

Fouthantering en Rate Limits

De API retourneert standaard HTTP-statuscodes. 401 geeft een ongeldige API-sleutel aan. 402 geeft onvoldoende vooruitbetaald krediet aan. 429 geeft een rate limit aan. De limiet is 300 verzoeken per minuut. Gelijktijdigheid is acht verzoeken tegelijk. Request bodies zijn beperkt tot 8 MB. Afhandelen van deze fouten op een soepele manier. Probeer opnieuw met exponentiële backoff. Het uncensored model weigert wettelijke content niet. Fouten zijn gratis. Je betaalt niet voor mislukte verzoeken. Het vooruitbetaalde krediet is veilig. Het verloopt nooit. Gebruik de Support pagina voor dubbele ladingen. Alleen crypto. USDT of USDC. Bonussen zijn van toepassing.