Hermes api Documentation: Γρήγορη Έναρξη

Εγκατάσταση και Ρύθμιση

Το API hermes λειτουργεί με οποιοδήποτε client που μιλάει τη μορφή OpenAI. Χρειάζεστε μια βάση URL και ένα API key. Δημιουργήστε λογαριασμό μέσω Google ή email στη σελίδα Get API key. Το σύστημα σας δείχνει το κλειδί σας αμέσως. Δεν απαιτείται αριθμός τηλεφώνου. Λαμβάνετε $0.50 trial credit για 7 days. Αποθετώστε αργότερα μόνο με crypto.

• Base URL: HTTPS://api.apihermes.cc/v1
• Κεφαλίδα Auth: Authorization: Bearer YOUR_API_KEY
• ID Μοντέλου: uncensored

Εγκαταστήστε το προτιμώμενο SDK και ορίστε τη βάση URL. Το endpoint αναμένει τυπικές παραμέτρους chat completion. Διατηρήστε το κλειδί σας ασφαλές. Ένα κλειδί αντικαθιστά το προηγούμενο αν δημιουργήσετε ένα νέο.

Βασικό Αίτημα Συμπλήρωσης Συνομιλίας

Ένα βασικό request στέλνει μηνύματα και λαμβάνει μια απάντηση κειμένου. Το model id είναι uncensored. Διαχειρίζεται νόμιμο περιεχόμενο ενηλίκων χωρίς απόρριψη. Πληρώνετε ανά token που χρησιμοποιείται. Τα σφάλματα και οι απορρίψεις δεν κοστίζουν τίποτα. Το context window χωράει 100.000 tokens συνολικά.

Δομήστε το αίτημά σας με ένα μήνυμα συστήματος και ένα μήνυμα χρήστη. Το API επιστρέφει μια συμπλήρωση. Μπορείτε να ορίσετε το max_tokens για να ελέγξετε το μήκος της εξόδου. Το προεπιλεγμένο όριο εξόδου είναι 2,048 tokens. Μπορείτε να το αυξήσετε στα 16,000 tokens ανά αίτημα. Η ροή δεδομένων (streaming) λειτουργεί μέσω SSE. Η κλήση συναρτήσεων είναι διαθέσιμη. Υποστηρίζεται η λειτουργία JSON.

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

Το σώμα της αίτησης περιορίζεται σε 8 MB. Τα όρια ταχύτητας είναι 300 αιτήσεις ανά λεπτό. Η ταυτόχρονη χρήση είναι οκτώ αιτήσεις ταυτόχρονα. Η λογική επανάληψης διαχειρίζεται ομαλά την υπερφόρτωση του διακομιστή.

Streaming Αποκρίσεις με SSE

Η ροή παραδίδει tokens καθώς παράγονται. Ο διακομιστής στέλνει Server-Sent Events. Κάθε κομμάτι περιέχει μερικό κείμενο. Το τελικό κομμάτι περιλαμβάν στατιστικά χρήσης tokens. Αυτή η προσέγγιση μειώνει την αντιλαμβανόμενη καθυστέρηση για μεγάλες απαντήσεις. Είναι ιδανική για διεπαφές συνομιλίας. Πρέπει να χειριστείτε τη ροή σωστά. Μπορούν να συμβούν αποσυνδέσεις. Η API δεν εγγυάται τη σειρά παράδοσης πέρα από τη ροή ίδια.

Ορίστε την παράμετρο stream σε true. Διαβάστε τις γραμμές δεδομένων. Συνδέστε το περιεχόμενο. Ελέγξτε το finish_reason για ολοκλήρωση. Το μοντέλο uncensored λειτουργεί με οποιοδήποτε SDK συμβατό με OpenAI. Ρυθμίστε τον πελάτη για να χειρίζεται SSE. Παρακολουθήστε τον αριθμό tokens. Το base URL παραμένει το ίδιο. Η πιστοποίηση είναι ίδια. Δεν χρειάζεται επιπλέον ρύθμιση.

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)

Τα σφάλματα εμφανίζονται στο stream. Διαχειριστείτε τα κλείνοντας τη σύνδεση. Το προκαταβλεπόμενο πιστωτικό αφαιρείται μόνο για ολοκληρωμένα tokens. Αυτό γλιτώνει χρήματα κατά τις διακοπές. Δεν πληρώνετε ποτέ για μερική άχρηστη έξοδο. Το σύστημα είναι διαφανές.

Χρησιμοποιώντας Function Calling και Tools

Το function calling επιτρέπει στο μοντέλο να εκτελεί κώδικα ή εργαλεία. Ορίστε εργαλεία στο σώμα της αίτησης. Το μοντέλο επιστρέφει μια κλήση εργαλείου. Εκτελείτε το εργαλείο. Στέλνετε το αποτέλεσμα πίσω. Το μοντέλο δημιουργεί μια τελική απάντηση. Αυτό επιτρέπει σύνθετες ροές εργασιών. Δεν είναι απλώς ένα wrapper chat. Το API υποστηρίζει εργαλεία και tool_choice. Χρησιμοποιήστε αυτό για πράκτορες ή αυτοματοποίηση.

Δομήστε τον πίνακα εργαλείων. Συμπεριλάβετε όνομα, περιγραφή και παραμέτρους. Το μοντέλο αποφασίζει πότε να καλέσει ένα εργαλείο. Πρέπει να αναλύσετε τα ορίσματα. Εκτελέστε τη συνάρτηση. Δώστε την έξοδο στη συνομιλία. Το μοντέλο συνεχίζει. Αυτός ο κύκλος επαναλαμβάνεται μέχρι την τελική απάντηση. Το παράθυρο πλαισίου παρακολουθεί όλες τις αλληλεπιδράσεις εργαλείων. Παρακολουθήστε τη χρήση tokens. Τα κόστη αυξάνονται με τις εξόδους των εργαλείων. Παρακολουθήστε τη χρήση στην τελευταία ενότητα.

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)

Το μοντέλο χωρίς λογοκρισία διαχειρίζεται ποικίλα σχήματα εργαλείων. Δεν αρνείται με βάση το περιεχόμενο. Χρησιμοποιήστε το για roleplay ή τεχνικές εργασίες. Το API είναι αξιόπιστο. Τα σφάλματα είναι ελάχιστα. Το σύστημα προπληρωμών διασφαλίζει δικαιοσύνη. Ελέγχετε τη ροή. Το base URL είναι σταθερό. Η πιστοποίηση είναι απλή.

Λειτουργία JSON και Παράμετροι

Η λειτουργία JSON αναγκάζει το μοντέλο να εξάγει έγκυρο JSON. Ρυθμίστε το response_format σε json_object. Αυτό είναι χρήσιμο για δομημένα δεδομένα. Το μοντέλο αποφεύγει τα περιβλήματα markdown. Επιστρέφει ωμό JSON. Χρησιμοποιήστε το για ανάλυση. Βελτιώνει την αξιοπιστία. Το παράθυρο πλαισίου ισχύει ακόμα. Πληρώνετε για tokens. Το μοντέλο uncedException σέβεται τη μορφή. Δεν αρνείται με βάση το περιεχόμενο.

Οι παράμετροι περιλαμβάνουν θερμοκρασία, top_p, stop, seed, presence_penalty και frequency_penalty. Η θερμοκρασία ελέγχει την τυχαιότητα. Το top_p ελέγχει την ποικιλία. Οι ακολουθίες διακοπής σταματούν τη δημιουργία. Το seed διασφαλίζει αναπαραγωγιμότητα. Οι ποινές παρουσίας και συχνότητας προσαρμόζουν τη χρήση tokens. Ορίστε αυτά για να βελτιώσετε το αποτέλεσμα. Το API υποστηρίζει όλες τις τυπικές παραμέτρους. Χρησιμοποιήστε τις για να ρυθμίσετε την απόκριση. Η βασική διεύθυνση URL παραμένει η ίδια. Η πιστοποίηση είναι ίδια.

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

Τα σφάλματα διαχειρίζονται μέσω κωδικών κατάστασης HTTP. Το 401 σημαίνει μη έγκυρο κλειδί. Το 402 σημαίνει έλλειψη πιστωτικού. Το 429 σημαίνει όριο ρυθμού. Διαχειριστείτε τα στον κώδικά σας. Το προκαταβλεπόμενο πιστωτικό αφαιρείται μόνο για ολοκληρωμένα tokens. Αυτό διασφαλίζει δικαιοσύνη. Δεν πληρώνετε ποτέ για μερική έξοδο. Το σύστημα είναι διαφανές. Το μοντέλο uncensored είναι αξιόπιστο. Χρησιμοποιήστε το για οποιαδήποτε νόμιμη εργασία.

Χειρισμός Σφαλμάτων και Όρια Ρυθμού

Η API επιστρέφει τυπικούς κωδικούς κατάστασης HTTP. Το 401 υποδεικνύει μη έγκυρο κλειδί API. Το 402 υποδεικνύει ανεπαρκή προπληρωμένη πιστωτική μονάδα. Το 429 υποδεικνύει όριο ρυθμού. Το όριο είναι 300 αιτήματα ανά λεπτό. Η ταυτόχρονη χρήση είναι οκτώ αιτήσεις ταυτόχρονα. Τα σώματα αιτήσεων περιορίζονται σε 8 MB. Διαχειριστείτε αυτά τα σφάλματα με ομαλό τρόπο. Κάντε επανάληψη με εκθετική υποχώρηση. Το uncensored μοντέλο δεν αρνείται νόμιμο περιεχόμενο. Τα σφάλματα είναι δωρεάν. Δεν πληρώνετε για αποτυχημένες αιτήσεις. Η προπληρωμένη πιστωτική μονάδα είναι ασφαλής. Λήγει ποτέ. Χρησιμοποιήστε τη σελίδα Υποστήριξης για διπλές χρεώσεις. Μόνο κρυπτονομίσματα. USDT ή USDC. Τα μπόνους ισχύουν.