Documentație API Hermes: Începere rapidă

Instalare și configurare

API-ul hermes funcționează cu orice client care suportă formatul OpenAI. Ai nevoie de un URL de bază și de o cheie API. Creează un cont prin Google sau email pe pagina Get API key. Sistemul îți afișează cheia imediat. Nu este necesar un număr de telefon. Primești un credit de încercare de $0.50 timp de 7 zile. Completează contul ulterior doar cu criptomonede.

• URL de bază: HTTPS://api.apihermes.cc/v1
• Header Auth: Authorization: Bearer YOUR_API_KEY
• ID Model: uncensored

Instalează SDK-ul tău preferat și setează URL-ul de bază. Endpoint-ul așteaptă parametri standard de completare chat. Păstrează-ți cheia în siguranță. O singură cheie înlocuiește cea anterioară dacă generezi una nouă.

Cerere de completare chat de bază

O solicitare de bază trimite mesaje și primește un răspuns text. ID-ul modelului este uncensored. Gestionează conținutul adult legal fără refuz. Plătești pe tokenii utilizați. Erorile și refuzurile nu costă nimic. Fereastra de context reține 100.000 de tokeni în total.

Structurează cererea cu un mesaj de system și un mesaj user. API-ul returnează un completion. Poți seta max_tokens pentru a controla lungimea outputului. Limita implicită de output este de 2.048 de tokeni. Poți crește această limită la 16.000 de tokeni per cerere. Streaming-ul funcționează prin SSE. Apelarea de funcții este disponibilă. Modul JSON este suportat.

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

Corpul solicitării este limitat la 8 MB. Limitele de rată sunt de 300 de solicitări pe minut. Concurența este de opt solicitări simultan. Logica de reîncercare gestionează elegant supraîncărcarea serverului.

Răspunsuri în streaming cu SSE

Streaming livrează tokenii pe măsură ce sunt generați. Serverul trimite Server-Sent Events. Fiecare fragment conține text parțial. Fragmentul final include statistici de utilizare a tokenilor. Această abordare reduce latența percepută pentru răspunsurile lungi. Este ideal pentru interfețele de chat. Trebuie să gestionezi fluxul corect. Pot apărea deconectări. API-ul nu garantează ordinea livrării dincolo de fluxul însuși.

Setează parametrul stream la true. Analizează liniile de date. Concatenează conținutul. Verifică finish_reason pentru finalizare. Modelul uncensored funcționează cu orice SDK compatibil OpenAI. Configurează clientul pentru a gestiona SSE. Monitorizează numărul de tokenuri. URL-ul de bază rămâne același. Autentificarea este identică. Nu este necesară o configurare suplimentară.

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)

Erorile apar în flux. Gestionează-le închizând conexiunea. Creditul preplătit se deduce doar pentru tokenii completați. Acest lucru economisește bani în timpul întreruperilor. Nu plătești niciodată pentru ieșiri parțiale de tip garbage. Sistemul este transparent.

Utilizând Function Calling și Tool-uri

Apelarea funcțiilor permite modelului să execute cod sau instrumente. Definiți instrumente în corpul cererii. Modelul returnează un apel de instrument. Executați instrumentul. Trimiteți rezultatul înapoi. Modelul generează un răspuns final. Acest lucru permite fluxuri de lucru complexe. Nu este doar un wrapper de chat. API-ul suportă instrumente și tool_choice. Utilizați acest lucru pentru agenți sau automatizare.

Structurează array-ul de tooluri. Include numele, descrierea și parametrii. Modelul decide când să apeleze un tool. Trebuie să analizezi argumentele. Execută funcția. Trimite outputul în conversație. Modelul continuă. Acest ciclu se repetă până la răspunsul final. Fereastra de context urmărește toate interacțiunile cu toolurile. Ține evidența utilizării de tokeni. Costurile se acumulează cu outputurile toolurilor. Monitorizează utilizarea în chunk-ul final.

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)

Modelul fără cenzură gestionează diverse scheme de instrumente. Nu refuză în funcție de conținut. Utilizează acest lucru pentru jocuri de rol sau sarcini tehnice. API-ul este fiabil. Fără erori. Sistemul preplătit asigură corectitudinea. Tu controlezi fluxul. URL-ul de bază este constant. Autentificarea este simplă.

Mod JSON și Parametri

Modul JSON forțează modelul să genereze JSON valid. Setează response_format la json_object. Acest lucru este util pentru datele structurate. Modelul evită wrapper-ele markdown. Returnează JSON brut. Folosește acest lucru pentru analiză. Îmbunătățește fiabilitatea. Fereastra de context se aplică totuși. Plătești pentru tokeni. Modelul uncensored respectă formatul. Nu refuză pe baza conținutului.

Parametrii includ temperatura, top_p, stop, seed, presence_penalty și frequency_penalty. Temperatura controlează aleatorietatea. Top_p controlează diversitatea. Secvențele de oprire opresc generarea. Seed asigură reproducibilitatea. Penalizările de prezență și frecvență ajustează utilizarea tokenilor. Setează aceste valori pentru a rafina ieșirea. API-ul suportă toți parametrii standard. Folosește-i pentru a regla răspunsul. URL-ul de bază rămâne același. Autentificarea este identică.

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

Erorile sunt gestionate prin coduri de stare HTTP. 401 înseamnă cheie invalidă. 402 înseamnă fără credit. 429 înseamnă limită de rată. Gestionează-le în codul tău. Creditul preplătit se deduce doar pentru tokenii completați. Acest lucru asigură corectitudinea. Nu plătești niciodată pentru un output parțial. Sistemul este transparent. Modelul uncensored este fiabil. Folosește-l pentru orice sarcină legală.

Gestionarea erorilor și limitele de rată

API returnează coduri standard de stare HTTP. 401 indică o cheie API nevalidă. 402 indică credit preplătit insuficient. 429 indică o limită de rată. Limita este de 300 de solicitări pe minut. Concurența este de opt solicitări simultan. Corpurile de solicitare sunt limitate la 8 MB. Gestionați aceste erori cu blândețe. Reîncercați cu backoff exponențial. Modelul uncensored nu refuză conținutul legal. Erorile sunt gratuite. Nu plătiți pentru solicitările eșuate. Creditul preplătit este securizat. Nu expiră niciodată. Utilizați pagina de Support pentru duble charge-uri. Doar cripto. USDT sau USDC. Bonusurile se aplică.