Documentazione API Hermes: Avvio rapido

Installazione e configurazione

L'API hermes funziona con qualsiasi client che supporti il formato OpenAI. Hai bisogno di un URL di base e di una chiave API. Crea un account tramite Google o email nella pagina Ottieni chiave API. Il sistema mostra la tua chiave immediatamente. Non è richiesto il numero di telefono. Ricevi un credito di prova di $0.50 per sette giorni. Aggiungi fondi in seguito solo con criptovalute.

• URL Base: HTTPS://api.apihermes.cc/v1
• Header Auth: Authorization: Bearer YOUR_API_KEY
• ID modello: uncensored

Installa il tuo SDK preferito e imposta l'URL di base. L'endpoint si aspetta parametri standard di completamento della chat. Mantieni la tua chiave sicura. Una chiave sostituisce la precedente se ne generi una nuova.

Richiesta Completamento Chat Base

Una richiesta di base invia messaggi e riceve una risposta testuale. L'ID del modello è uncensored. Gestisce i contenuti adulti legali senza rifiuti. Paghi per ogni token utilizzato. Errori e rifiuti non costano nulla. La finestra di contesto contiene 100.000 token in totale.

Struttura la tua richiesta con un messaggio system e un messaggio user. L'API restituisce un completamento. Puoi impostare max_tokens per controllare la lunghezza dell'output. Il limite di output predefinito è di 2.048 token. Puoi aumentarlo a 16.000 token per richiesta. Lo streaming funziona tramite SSE. Il richiamo di funzioni è disponibile. La modalità JSON è supportata.

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

Il corpo della richiesta è limitato a 8 MB. I limiti di velocità sono di 300 richieste al minuto. La concorrenza è di otto richieste simultanee. La logica di retry gestisce in modo elegante il sovraccarico del server.

Risposte in streaming con SSE

Lo streaming consegna i token man mano che vengono generati. Il server invia Server-Sent Events. Ogni chunk contiene testo parziale. L'ultimo chunk include le statistiche sull'utilizzo dei token. Questo approccio riduce la latenza percepita per le risposte lunghe. È ideale per le interfacce chat. Devi gestire lo stream correttamente. Potrebbero verificarsi disconnessioni. L'API non garantisce l'ordine di consegna oltre lo stream stesso.

Imposta il parametro stream su true. Analizza le righe dei dati. Concatena il contenuto. Controlla finish_reason per il completamento. Il modello uncensored funziona con qualsiasi SDK compatibile con OpenAI. Configura il client per gestire SSE. Monitora il conteggio dei token. L'URL di base rimane lo stesso. L'autenticazione è identica. Non è necessaria alcuna configurazione aggiuntiva.

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)

Gli errori appaiono nello stream. Gestiscili chiudendo la connessione. Il credito prepagato viene detratto solo per i token completati. Questo fa risparmiare denaro durante le interruzioni. Non paghi mai per output parziali e inutili. Il sistema è trasparente.

Utilizzando Function Calling e Tools

Il function calling consente al modello di eseguire codice o strumenti. Definisci gli strumenti nel corpo della richiesta. Il modello restituisce una chiamata allo strumento. Esegui lo strumento. Invii il risultato indietro. Il modello genera una risposta finale. Questo abilita flussi di lavoro complessi. Non è solo un wrapper per chat. L'API supporta strumenti e tool_choice. Usalo per agent o automazione.

Struttura l'array degli strumenti. Include nome, descrizione e parametri. Il modello decide quando chiamare uno strumento. Devi analizzare gli argomenti. Esegui la funzione. Passa l'output alla conversazione. Il modello continua. Questo ciclo si ripete fino alla risposta finale. La finestra di contesto tiene traccia di tutte le interazioni con gli strumenti. Tieni traccia dell'utilizzo dei token. I costi aumentano con gli output degli strumenti. Monitora l'utilizzo nell'ultimo 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)

Il modello senza filtri gestisce schemi di strumenti diversificati. Non rifiuta in base al contenuto. Utilizzalo per roleplay o attività tecniche. L'API è affidabile. Gli errori sono assenti. Il sistema prepagato garantisce equità. Controlli il flusso. L'URL di base è coerente. L'autenticazione è semplice.

Modalità JSON e parametri

La modalità JSON forza il modello a produrre un JSON valido. Imposta response_format su json_object. Questo è utile per i dati strutturati. Il modello evita i wrapper markdown. Restituisce JSON grezzo. Usalo per l'analisi. Migliora l'affidabilità. La finestra di contesto si applica ancora. Paghi per i token. Il modello uncensored rispetta il formato. Non rifiuta in base al contenuto.

I parametri includono temperatura, top_p, stop, seed, presence_penalty e frequency_penalty. La temperatura controlla la casualità. Top_p controlla la diversità. Le sequenze di stop fermano la generazione. Il seed garantisce la riproducibilità. Le penalità di presenza e frequenza regolano l'utilizzo dei token. Impostali per affinare l'output. L'API supporta tutti i parametri standard. Usali per regolare la risposta. L'URL di base rimane lo stesso. L'autenticazione è identica.

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

Gli errori vengono gestiti tramite codici di stato HTTP. 401 indica una chiave non valida. 402 indica credito insufficiente. 429 indica superamento del limite di frequenza. Gestisci questi casi nel tuo codice. Il credito prepagato viene detratto solo per i token completati. Questo garantisce equità. Non paghi mai per output parziali. Il sistema è trasparente. Il modello uncensored è affidabile. Usalo per qualsiasi attività lecita.

Gestione degli errori e limiti di velocità

L'API restituisce codici di stato HTTP standard. 401 indica una chiave API non valida. 402 indica credito prepagato insufficiente. 429 indica un limite di frequenza. Il limite è di 300 richieste al minuto. La concorrenza è di otto richieste alla volta. I corpi delle richieste sono limitati a 8 MB. Gestisci questi errori in modo elegante. Riprova con backoff esponenziale. Il modello uncensored non rifiuta contenuti legali. Gli errori sono gratuiti. Non paghi per le richieste fallite. Il credito prepagato è sicuro. Non scade mai. Usa la pagina Supporto per addebiti doppi. Solo cripto. USDT o USDC. I bonus si applicano.