Dokumentace API Hermes: Rychlý start

Instalace a nastavení

API hermes funguje s jakýmikoli klienty, kteří rozumí formátu OpenAI. Potřebujete základní URL a API klíč. Vytvořte účet přes Google nebo e-mail na stránce Získat API klíč. Systém vám klíč okamžitě zobrazí. Není vyžadováno telefonní číslo. Obdržíte zkušební kredit $0.50 na 7 dní. Později doplňte pouze kryptoměnami.

• Základní URL: HTTPS://api.apihermes.cc/v1
• Hlavička Auth: Authorization: Bearer YOUR_API_KEY
• ID modelu: uncensored

Nainstalujte preferované SDK a nastavte základní URL. Endpoint očekává standardní parametry pro chatové dokončení. Uchovávejte svůj klíč v bezpečí. Jeden klíč nahrazuje předchozí, pokud vygenerujete nový.

Požadavek na základní dokončení chatu

Základní požadavek odesílá zprávy a přijímá textovou odpověď. ID modelu je uncensored. Zvládá legální obsah pro dospělé bez odmítání. Platíte za spotřebované tokeny. Chyby a odmítnutí nic nestojí. Kontextové okno pojme celkem 100 000 tokenů.

Strukturujte svůj požadavek se zprávou system a zprávou user. API vrátí dokončení (completion). Můžete nastavit max_tokens pro ovládání délky výstupu. Výchozí limit výstupu je 2,048 tokenů. Tento limit můžete zvýšit na 16,000 tokenů na žádost. Streamování funguje přes SSE. Volání funkcí je k dispozici. Režim JSON je podporován.

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

Tělo žádosti je omezeno na 8 MB. Limity rychlosti jsou 300 požadavků za minutu. Konkurze je osm požadavků najednou. Logika opakování gracefulně zvládá přetížení serveru.

Streamované odpovědi s SSE

Streamování dodává tokeny, jak jsou generovány. Server odesílá Server-Sent Events. Každý blok obsahuje částečný text. Poslední blok zahrnuje statistiky využití tokenů. Tento přístup snižuje vnímanou latenci u dlouhých odpovědí. Je ideální pro rozhraní chatu. Musíte stream správně zpracovat. Může dojít k odpojení. API nezaručuje pořadí doručení mimo samotný stream.

Nastavte parametr stream na true. Parsovejte datové řádky. Spojte obsah. Zkontrolujte finish_reason pro dokončení. Model uncensored funguje s libovolnou SDK kompatibilní s OpenAI. Nakonfigurujte klienta pro zpracování SSE. Sledujte počet tokenů. Základní URL zůstává stejné. Autentizace je identická. Nepotřebujete další nastavení.

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)

Chyby se objevují ve streamu. Řešte je uzavřením připojení. Předplacený kredit se odečítá pouze za dokončené tokeny. To šetří peníze při přerušení. Nikdy neplatíte za částečný nesmyslný výstup. Systém je transparentní.

Použití Function Calling a nástrojů

Volání funkcí umožňuje modelu provádět kód nebo nástroje. Definujte nástroje v těle požadavku. Model vrátí volání nástroje. Vy nástroj provedete. Výsledek pošlete zpět. Model vygeneruje finální odpověď. To umožňuje složité pracovní postupy. Není to jen obal pro chat. API podporuje nástroje a tool_choice. Použijte to pro agenty nebo automatizaci.

Strukturujte pole tools. Zahrňte název, popis a parametry. Model rozhodne, kdy nástroj zavolat. Vy musíte parsovat argumenty. Proveďte funkci. Předajte výstup do konverzace. Model pokračuje. Tento cyklus se opakuje, dokud nedojde k finální odpovědi. Okno kontextu sleduje všechny interakce s nástroji. Sledujte využití tokenů. Náklady se s výstupy nástrojů navyšují. Sledujte využití ve finálním chunku.

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)

Uncenzurovaný model zvládá různé schémata nástrojů. Neodmítá na základě obsahu. Použijte jej pro roleplay nebo technické úkoly. API je spolehlivé. Chyby jsou eliminovány. Systém předplacení zajišťuje férovost. Vy ovládáte tok. Základní URL je konzistentní. Autentizace je jednoduchá.

Režim JSON a parametry

Režim JSON vynucuje, aby model výstupoval platný JSON. Nastavte response_format na json_object. To je užitečné pro strukturovaná data. Model se vyhýbá obalům markdownu. Vrací syrový JSON. Použijte to pro parsování. Zlepšuje spolehlivost. Okno kontextu stále platí. Platíte za tokeny. Uncensored model respektuje formát. Neodmítá na základě obsahu.

Parametry zahrnují teplotu, top_p, stop, seed, presence_penalty a frequency_penalty. Teplota řídí náhodnost. Top_p řídí rozmanitost. Sekvence stop zastavují generování. Seed zajišťuje reprodukovatelnost. Přítomnost a penalizace frekvence upravují využití tokenů. Nastavte je pro vylepšení výstupu. API podporuje všechny standardní parametry. Použijte je pro ladění odpovědi. Základní URL zůstává stejné. Autentizace je identická.

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

Chyby jsou řešeny pomocí stavových kódů HTTP. 401 znamená neplatný klíč. 402 znamená nedostatek kreditu. 429 znamená překročení limitu. Ošetřete je ve svém kódu. Předplacený kredit se odečítá pouze za dokončené tokeny. To zajišťuje férovost. Nikdy neplatíte za částečný výstup. Systém je transparentní. Model bez omezení je spolehlivý. Použijte jej pro jakoukoli zákonnou úlohu.

Zpracování chyb a limity rychlosti

API vrací standardní HTTP stavové kódy. 401 indikuje neplatný API klíč. 402 indikuje nedostatečný předplacený kredit. 429 indikuje limit rychlosti. Limit je 300 požadavků za minutu. Konkurence je osm požadavků najednou. Těla požadavků jsou omezena na 8 MB. Zpracovávejte tyto chyby elegantně. Opakujte s exponenciálním backoffem. Uncensored model neodepírá legální obsah. Chyby jsou zdarma. Neplatíte za neúspěšné požadavky. Předplacený kredit je bezpečný. Nikdy nevyprší. Pro dvojí účtování použijte stránku Podpora. Pouze krypto. USDT nebo USDC. Bonusy se uplatní.