Hermes api Dokumentation: Quickstart

Installation og Opsætning

Hermes API fungerer med enhver klient, der taler OpenAI-formatet. Du har brug for en base URL og en API-nøgle. Opret en konto via Google eller e-mail på siden 'Get API key'. Systemet viser din nøgle med det samme. Intet telefonnummer er påkrævet. Du modtager $0,50 prøvecredit i syv dage. Suppler op senere kun med krypto.

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

Installer din foretrukne SDK og indstil base URL. Endpointet forventer standard chat-completion-parametre. Hold din nøgle sikker. En nøgle erstatter den forrige, hvis du genererer en ny.

Basic Chat Completion Request

Et grundlæggende request sender meddelelser og modtager et tekstbaseret svar. Model-ID'et er ucensureret. Det håndterer lovligt voksenindhold uden afvisning. Du betaler per brugt token. Fejl og afvisninger koster ingenting. Kontekstvinduet rummer 100.000 tokens i alt.

Strukturer din anmodning med en systemmeddelelse og en brugermeddelelse. API'et returnerer en completion. Du kan indstille max_tokens til at kontrollere outputlængden. Den standard outputgrænse er 2.048 tokens. Du kan hæve dette til 16.000 tokens pr. anmodning. Streaming fungerer via SSE. Function calling er tilgængelig. JSON-tilstand understøttes.

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

Forespørgselskroppen er begrænset til 8 MB. Rate limits er 300 forespørgsler i minuttet. Konkurrenceevne er otte forespørgsler ad gangen. Retry-logik håndterer serveroverbelastning pænt.

Streaming-svar med SSE

Streaming leverer tokens, mens de genereres. Serveren sender Server-Sent Events. Hver chunk indeholder delvis tekst. Den sidste chunk indeholder tokenforbrugsstatistikker. Denne tilgang reducerer den opfattede latens for lange svar. Den er ideel til chatgrænseflader. Du skal håndtere streamen korrekt. Afbrud kan opstå. API'et garanterer ikke leveringsrækkefølge ud over streamen selv.

Angiv stream-parameteren til true. Parse datalinjerne. Sammenkæd indholdet. Tjek finish_reason for færdiggørelse. Modellen uncensored fungerer med ethvert OpenAI-kompatibelt SDK. Konfigurer klienten til at håndtere SSE. Overvåg tokenantallet. Base-URL'en forbliver den samme. Auth er identisk. Der er ikke brug for ekstra opsætning.

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)

Fejl vises i streamen. Håndter dem ved at lukke forbindelsen. Den forudbetalte kredit trækkes kun for fuldførte tokens. Dette sparer penge under afbrydelser. Du betaler aldrig for delvis affaldsuddata. Systemet er gennemsigtigt.

Brug af Function Calling og Tools

Function calling giver modellen mulighed for at eksekvere kode eller værktøjer. Definer værktøjer i anmodningskroppen. Modellen returnerer et værktøjskald. Du eksekverer værktøjet. Du sender resultatet tilbage. Modellen genererer et endeligt svar. Dette muliggør komplekse arbejdsgange. Det er ikke bare en chat-wrapper. API'et understøtter værktøjer og tool_choice. Brug dette til agenter eller automatisering.

Strukturer tools-arrayet. Inkluder navn, beskrivelse og parametre. Modellen beslutter, hvornår et tool skal kaldes. Du skal parse argumenterne. Udfør funktionen. Send outputtet til samtalen. Modellen fortsætter. Denne cyklus gentages, indtil det endelige svar er nået. Kontekstvinduet sporer alle tool-interaktioner. Hold styr på token-forbrug. Omkostningerne stiger med tool-output. Overvåg forbruget i det sidste 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)

Den ucensurerede model håndterer forskellige værktøjsskemaer. Den afviser ikke baseret på indhold. Brug dette til rollespil eller tekniske opgaver. API'et er pålideligt. Fejl er fri. Forudbetalingssystemet sikrer fair play. Du styrer flowet. Base-URL'en er konsistent. Autentificeringen er simpel.

JSON-tilstand og parametre

JSON-mode tvinger modellen til at outputte gyldig JSON. Sæt response_format til json_object. Dette er nyttigt til strukturerede data. Modellen undgår markdown-indpakninger. Den returnerer rå JSON. Brug dette til parsing. Det forbedrer pålideligheden. Context-vinduet gælder stadig. Du betaler for tokens. Den uncensored-model respekterer formatet. Den nægter ikke baseret på indhold.

Parameters include temperature, top_p, stop, seed, presence_penalty, and frequency_penalty. Temperature controls randomness. Top_p controls diversity. Stop sequences halt generation. Seed ensures reproducibility. Presence and frequency penalties adjust token usage. Set these to refine the output. The API supports all standard parameters. Use them to tune the response. The base URL remains the same. Auth is identical.

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

Fejl håndteres via HTTP-statuskoder. 401 betyder ugyldig nøgle. 402 betyder ingen kredit. 429 betyder hastighedsbegrænsning. Håndter disse i din kode. Forudbetalt kredit trækkes kun af for fuldførte tokens. Dette sikrer retfærdighed. Du betaler aldrig for delvise output. Systemet er gennemsigtigt. Den uprægede model er pålidelig. Brug den til ethver lovlig opgave.

Fejlhåndtering og hastighedsbegrænsninger

API'en returnerer standard HTTP-statuskoder. 401 indikerer en ugyldig API-nøgle. 402 indikerer utilstrækkelig forudbetalt kredit. 429 indikerer en rate limit. Grænsen er 300 anmodninger i minuttet. Samtidig kørsel er otte anmodninger ad gangen. Anmodningskroppe er begrænset til 8 MB. Håndter disse fejl elegant. Gentag med eksponentiel backoff. Den uncensored-model afviser ikke lovligt indhold. Fejl er gratis. Du betaler ikke for mislykkede anmodninger. Den forudbetalte kredit er sikker. Den udløber aldrig. Brug Support-siden for dobbeltopkrævninger. Kun krypto. USDT eller USDC. Bonusser gælder.