Hermes API-dokumentation: Snabbstart

Installation och uppsättning

Hermes API fungerar med vilken klient som helst som stöder OpenAI-formatet. Du behöver en bas-URL och en API-nyckel. Skapa ett konto via Google eller e-post på sidan "Hämta API-nyckel". Systemet visar din nyckel omedelbart. Inget telefonnummer krävs. Du får $0.50 provkredit i sju dagar. Ladda upp senare med endast krypto.

• Bas URL: HTTPS://api.apihermes.cc/v1
• Auth-huvud: Authorization: Bearer YOUR_API_KEY
• Modell-ID: uncensored

Installera din föredragna SDK och ställ in bas-URL:n. Slutpunkten förväntar sig standardparametrar för chattkomplettering. Behåll din nyckel säker. En nyckel ersätter den tidigare om du genererar en ny.

Grundläggande chattkompletteringsbegäran

En grundläggande förfrågan skickar meddelanden och tar emot ett textbaserat svar. Modell-ID:et är obegränsat. Det hanterar lagligt vuxeninnehåll utan avvisning. Du betalar per använd token. Fel och avvisningar kostar inget. Kontextfönstret rymmer 100 000 token totalt.

Strukturera din begäran med ett systemmeddelande och ett användarmeddelande. API:et returnerar en komplettering. Du kan ställa in max_tokens för att kontrollera utdatalängden. Standardutdatalimiten är 2 048 token. Du kan höja detta till 16 000 token per begäran. Streaming fungerar via SSE. Functon calling är tillgängligt. JSON-läge stöds.

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

Förfrågningskroppen är begränsad till 8 MB. Hastighetsbegränsningarna är 300 förfrågningar per minut. Konkurrensen är åtta förfrågningar samtidigt. Försökslogik hanterar serveröverbelastning smidigt.

Strömningsresponser med SSE

Strömning levererar tokens när de genereras. Servern skickar Server-Sent Events. Varje bit innehåller delvis text. Den sista biten innehåller tokenanvändningsstatistik. Denna metod minskar upplevd latens för långa svar. Den är idealisk för chattgränssnitt. Du måste hantera strömmen korrekt. Avbrott kan förekomma. API:et garanterar inte leveransordning bortom strömmen i sig.

Ställ in stream-parametern till true. Parsninga datalinjerna. Konkatenera innehållet. Kontrollera finish_reason för slutförande. Modellen uncensored fungerar med alla OpenAI-kompatibla SDK:er. Konfigurera klienten för att hantera SSE. Övervaka tokenantalet. Bas-URL:en förblir densamma. Autentiseringen är identisk. Ingen extra installation krävs.

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)

Fel visas i strömmen. Hantera dem genom att stänga anslutningen. Förbetald kredit dras endast för slutförda tokens. Detta sparar pengar vid avbrott. Du betalar aldrig för delvis skräputdata. Systemet är transparent.

Att använda Function Calling och Verktyg

Funktionsanrop gör att modellen kan exekvera kod eller verktyg. Definiera verktyg i begärans kropp. Modellen returnerar ett verktygsanrop. Du exekverar verktyget. Du skickar tillbaka resultatet. Modellen genererar ett slutgiltigt svar. Detta möjliggör komplexa arbetsflöden. Det är inte bara en chattomslag. API:t stöder verktyg och tool_choice. Använd detta för agenter eller automatisering.

Strukturera tools-arrayen. Inkludera namn, beskrivning och parametrar. Modellen bestämmer när ett verktyg ska anropas. Du måste parsera argumenten. Exekvera funktionen. Skicka utdata till konversationen. Modellen fortsätter. Denna cykel upprepas tills det slutliga svaret. Kontextfönstret spårar alla verktygsinteraktioner. Håll koll på tokenanvändning. Kostnaderna ökar med verktygsutdata. Övervika användningen i den sista chunken.

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 icke-censurerade modellen hanterar mångsidiga verktygsscheman. Den vägrar inte baserat på innehåll. Använd detta för rollspel eller tekniska uppgifter. API:et är pålitligt. Fel är fria. Förskottsbetalsystemet säkerställer rättvisa. Du styr flödet. Bas-URL:en är konsekvent. Autentiseringen är enkel.

JSON-läge och parametrar

JSON-läget tvingar modellen att returnera giltig JSON. Ställ response_format till json_object. Detta är användbart för strukturerad data. Modellen undviker markdown-omslutningar. Den returnerar rå JSON. Använd detta för parsing. Det förbättrar tillförlitligheten. Kontextrutan gäller fortfarande. Du betalar för tokens. Den obegränsade modellen respekterar formatet. Den vägrar inte baserat på innehåll.

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

Fel hanteras via HTTP-statuskoder. 401 betyder ogiltig nyckel. 402 betyder inget kredit. 429 betyder hastighetsbegränsning. Hantera dessa i din kod. Det förbetalda kreditet dras endast för fullbordade tokens. Detta säkerställer rättvisa. Du betalar aldrig för delvis utdata. Systemet är transparent. Den obegränsade modellen är tillförlitlig. Använd den för alla lagliga uppgifter.

Felfhantering och hastighetsbegränsningar

API:et returnerar standard HTTP-statuskoder. 401 indikerar en ogiltig API-nyckel. 402 indikerar otillräcklig förbetald kredit. 429 indikerar ett rate limit. Gränsen är 300 begäranden per minut. Samtidighet är åtta begäranden samtidigt. Begäranskroppar är begränsade till 8 MB. Hantera dessa fel på ett smidigt sätt. Försök igen med exponentiell backoff. Den obegränsade modellen vägrar inte lagligt innehåll. Fel är kostnadsfria. Du betalar inte för misslyckade begäranden. Den förbetalda krediten är säker. Den löper aldrig ut. Använd Support-sidan för dubbla debiteringar. Endast krypto. USDT eller USDC. Bonusar gäller.