Hermes api दस्तावेज़ीकरण: क्विकस्टार्ट

इंस्टॉलेशन और सेटअप

हेर्मिस एपीई किसी भी क्लाइंट के साथ काम करता है जो ओपनएआई फॉर्मेट बोलता है। आपको एक बेस यूआरएल और एक एपीआई कुंजी की आवश्यकता है। 'Get API key' पेज पर Google या ईमेल के माध्यम से एक खाता बनाएं। सिस्टम आपको तुरंत आपकी कुंजी दिखाता है। फोन नंबर की आवश्यकता नहीं है। आपको सात दिनों के लिए $0.50 ट्रायल क्रेडिट मिलता है। बाद में केवल क्रिप्टो के साथ टॉप अप करें।

• बेस URL: HTTPS://api.apihermes.cc/v1
• Auth हेडर: Authorization: Bearer YOUR_API_KEY
• मॉडल ID: uncensored

अपनी पसंदीदा SDK इंस्टॉल करें और बेस यूआरएल सेट करें। एंडपॉइंट मानक चैट कंप्लीशन पैरामीटर की उम्मीद करता है। अपनी key को सुरक्षित रखें। यदि आप एक नई key जनरेट करते हैं, तो एक key पिछली key की जगह ले लेती है।

बेस चैट कंप्लीशन रिक्वेस्ट

एक बुनियादी अनुरोध संदेश भेजता है और एक टेक्स्ट प्रतिक्रिया प्राप्त करता है। मॉडल आईडी अनसेंसर्ड है। यह कानूनी वयस्क सामग्री को अस्वीकृति के बिना संभालता है। आप उपयोग किए गए टोकन के लिए भुगतान करते हैं। त्रुटियां और अस्वीकृतियां मुफ्त होती हैं। संदर्भ विंडो कुल मिलाकर 100,000 टोकन धारण करती है।

अपने अनुरोध को एक सिस्टम संदेश और उपयोगकर्ता संदेश के साथ संरचित करें। API एक पूर्णता लौटाता है। आप max_tokens को सेट करके आउटपुट लंबाई को नियंत्रित कर सकते हैं। डिफ़ॉल्ट आउटपुट सीमा 2,048 टोकन है। आप इसे प्रति अनुरोध 16,000 टोकन तक बढ़ा सकते हैं। 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 अनुरोध हैं। संवहन एक बार में आठ अनुरोध है। रीट्राई लॉजिक सर्वर ओवरलोड को सहजता से संभालता है।

SSE के साथ स्ट्रीमिंग रिस्पॉन्सेस

स्ट्रीमिंग टोकन को जनरेट होते ही भेजता है। सर्वर सर्वर-सेंट इवेंट्स भेजता है। प्रत्येक चंक आंशिक पाठ शामिल करता है। अंतिम चंक में टोकन उपयोग सांख्यिकी शामिल होती है। यह दृष्टिकोण लंबी प्रतिक्रियाओं के लिए अनुभवी विलंबता को कम करता है। यह चैट इंटरफेस के लिए आदर्श है। आपको स्ट्रीम को सही ढंग से संभालना होगा। डिस्कनेक्ट हो सकते हैं। API स्ट्रीम के beyond डिलीवरी ऑर्डर की गारंटी नहीं देता।

stream पैरामीटर को true सेट करें। डेटा लाइनों को पार्स करें। सामग्री को जोड़ें। पूर्णता के लिए finish_reason की जांच करें। uncensored मॉडल किसी भी OpenAI-compatible SDK के साथ काम करता है। ग्राहक को SSE हैंडल करने के लिए कॉन्फ़िगर करें। टोकन गिनती की निगरानी करें। बेस यूआरएल वही रहता है। प्रमाणीकरण समान है। अतिरिक्त सेटअप की आवश्यकता नहीं है।

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)

त्रुटियां स्ट्रीम में दिखाई देती हैं। उन्हें कनेक्शन बंद करके हैंडल करें। पूर्व-भुगतान क्रेडिट केवल पूर्ण टोकनों के लिए कटौती करता है। यह विच्छेद के दौरान पैसे बचाता है। आप कभी भी आंशिक गार्बेज आउटपुट के लिए भुगतान नहीं करते हैं। सिस्टम पारदर्शी है।

Function Calling और टूल्स का उपयोग

फंक्शन कॉलिंग मॉडल को कोड या टूल्स निष्पादित करने की अनुमति देता है। अनुरोध बॉडी में टूल्स परिभाषित करें। मॉडल एक टूल कॉल लौटाता है। आप टूल निष्पादित करते हैं। आप परिणाम वापस भेजते हैं। मॉडल एक अंतिम प्रतिक्रिया जनरेट करता है। यह जटिल वर्कफ़्लो को सक्षम बनाता है। यह केवल एक चैट वेपर नहीं है। API टूल्स और टूल_चॉइस को सपोर्ट करता है। एजेंट्स या ऑटोमेशन के लिए इसका उपयोग करें।

टूल्स एरे को संरचित करें। नाम, विवरण और पैरामीटर शामिल करें। मॉडल तय करता है कि कब टूल कॉल करना है। आपको तर्कों को पार्स करना होगा। फ़ंक्शन को निष्पादित करें। आउटपुट को संवाद में पास करें। मॉडल जारी रखता है। यह चक्र अंतिम उत्तर तक दोहराया जाता है। संदर्भ विंडो सभी टूल इंटरैक्शन को ट्रैक करती है। टोकन उपयोग पर नज़र रखें। टूल आउटपुट के साथ लागत बढ़ जाती है। अंतिम चंक में उपयोग की निगरानी करें।

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)

अनकैप्ड मॉडल विविध टूल स्कीमा को संभालता है। यह सामग्री के आधार पर अस्वीकार नहीं करता है। रोलप्ले या तकनीकी कार्यों के लिए इसका उपयोग करें। API विश्वसनीय है। त्रुटियां मुक्त हैं। प्रीपेड सिस्टम निष्पक्षता सुनिश्चित करता है। आप प्रवाह को नियंत्रित करते हैं। बेस URL स्थिर है। प्रमाणीकरण सरल है।

JSON मोड और पैरामीटर

JSON मोड मॉडल को वैध JSON आउटपुट करने के लिए मजबूर करता है। response_format को json_object पर सेट करें। यह संरचित डेटा के लिए उपयोगी है। मॉडल मार्कडाउन व्रैपर्स से बचता है। यह रॉ JSON लौटाता है। पार्सिंग के लिए इसका उपयोग करें। यह विश्वसनीयता को बेहतर बनाता है। कंटेक्सट विंडो अभी भी लागू होता है। आप टोकन के लिए भुगतान करते हैं। अनसेंसर्ड मॉडल फॉर्मेट का सम्मान करता है। यह कंटेंट के आधार पर रिफ्यूज नहीं करता है।

पैरामीटर में तापमान, top_p, स्टॉप, सीड, presence_penalty, और frequency_penalty शामिल हैं। तापमान यादृच्छिकता को नियंत्रित करता है। top_p विविधता को नियंत्रित करता है। स्टॉप सीक्वेंस जनरेशन को रोकते हैं। सीड पुनरुत्पादकता सुनिश्चित करता है। उपस्थिति और आवृत्ति पेनल्टी टोकन उपयोग को समायोजित करती हैं। आउटपुट को परिष्कृत करने के लिए इन्हें सेट करें। API सभी मानक पैरामीटर का समर्थन करती है। प्रतिक्रिया को ट्यून करने के लिए उनका उपयोग करें। बेस यूआरएल समान रहता है। प्रमाणीकरण समान है।

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 का अर्थ है रेट लिमिट। इनकी हैंडलिंग अपने कोड में करें। प्रीपेड क्रेडिट केवल पूर्ण टोकन्स के लिए ही कटता है। यह निष्पक्षता सुनिश्चित करता है। आप कभी भी आंशिक आउटपुट के लिए भुगतान नहीं करते। सिस्टम पारदर्शी है। अनसेंसर्ड मॉडल विश्वसनीय है। किसी भी कानूनी कार्य के लिए इसका उपयोग करें।

त्रुटि हैंडलिंग और रेट लिमिट

API मानक HTTP स्टेटस कोड लौटाता है। 401 अमान्य API कुंजी को दर्शाता है। 402 अपर्याप्त प्रीपेड क्रेडिट को दर्शाता है। 429 दर सीमा को दर्शाता है। सीमा 300 अनुरोध प्रति मिनट है। समवर्ताता एक ही समय में आठ अनुरोध है। अनुरोध बॉडी 8 MB तक सीमित है। इन त्रुटियों को सहजता से हैंडल करें। एक्सपोनेंशियल बैकऑफ के साथ पुनः प्रयास करें। uncensored मॉडल कानूनी सामग्री को अस्वीकार नहीं करता है। त्रुटियाँ मुफ्त हैं। आप विफल अनुरोधों के लिए भुगतान नहीं करते हैं। प्रीपेड क्रेडिट सुरक्षित है। यह कभी समाप्त नहीं होता है। डबल चार्ज के लिए Support पेज का उपयोग करें। केवल क्रिप्टो। USDT या USDC। बोनस लागू होते हैं।