Hermes Agent और Codex सब्सक्रिप्शन: OAuth सेटअप, कोटा और API

Hermes Agent का एकीकरण डेवलपर्स को OAuth Device Code फ्लो के माध्यम से कंज्यूमर ChatGPT या Codex सब्सक्रिप्शन का उपयोग करके OpenAI मॉडल पर अनुरोध रूट करने में सक्षम बनाता है। यह तरीका स्थिर API कुंजी की आवश्यकता को समाप्त करता है, लेकिन तकनीकी और वित्तीय अस्पष्टताएं पैदा करता है। सफलतापूर्वक पूरा हुआ प्रमाणीकरण केवल खाता क्रेडेंशियल्स की तकनीकी वैधता की पुष्टि करता है—यह बाद के अनुरोधों के लिए अंतर्निहित बिलिंग तंत्र को परिभाषित या गारंटीकृत नहीं करता है।

दायरे और सीमाएं: पुष्ट तथ्य, दस्तावेज़ीकरण अंतराल और सत्यापन

Hermes Agent के साथ Codex खातों का उपयोग करते समय, सिस्टम इंटरैक्शन तीन अलग-अलग श्रेणियों में विभाजित होते हैं:

श्रेणी	दस्तावेज़ीकरण स्थिति	तकनीकी कार्यान्वयन और नियंत्रण का दायरा
पुष्ट	आधिकारिक रूप से प्रलेखित	Device Code फ्लो के माध्यम से प्रमाणीकरण। ~/.hermes/auth.json में स्थानीय टोकन स्टोरेज। ~/.codex/auth.json से क्रेडेंशियल आयात (स्वतंत्र Codex CLI इंस्टॉलेशन की आवश्यकता के बिना)। निरस्त टोकन का स्वचालित क्वारंटीन।
अदस्तावेज़ीकृत	आधिकारिक तौर पर अप्रकाशित	समर्थित सब्सक्रिप्शन प्लान और कोटा खपत नियम। आधिकारिक दस्तावेज़ समर्थित टियर या कटौती के नियमों को निर्दिष्ट नहीं करते हैं।
सत्यापन आवश्यक	उपयोगकर्ता की जिम्मेदारी	एजेंट चलाने से पहले और बाद में प्रदाता डैशबोर्ड मेट्रिक्स का मिलान करना, संभावित टेलीमेट्री विलंब को ध्यान में रखना, और सब्सक्रिप्शन बिलिंग को स्वतंत्र API कुंजियों से अलग रखना।

Nous Research का दस्तावेज़ीकरण केवल नेटवर्क हैंडशेक प्रोटोकॉल और सत्र नवीनीकरण तंत्र को कवर करता है। आधिकारिक सामग्री यह स्पष्ट नहीं करती कि कौन से सब्सक्रिप्शन प्लान उपयुक्त हैं या उपयोग कोटा कैसे काटा जाता है; इसलिए प्रोडक्शन कार्यों को निष्पादित करने से पहले डेवलपर्स को अपने प्रदाता डैशबोर्ड में खाता मेट्रिक्स को स्वतंत्र रूप से सत्यापित करना होगा। कोई भी दावा जो यह बताता है कि एजेंट के माध्यम से Codex मॉडल का उपयोग “मुफ्त”, “असीमित”, या बिना किसी प्रतिबंध के बेस पैकेज में शामिल है, तकनीकी रूप से निराधार है।

कॉन्फ़िगरेशन प्रक्रिया और सत्र प्रबंधन

Hermes आर्किटेक्चर लगातार वातावरण सेटअप को रनटाइम मॉडल स्विचिंग से सख्ती से अलग करता है:

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

टर्मिनल में प्रारंभिक प्रदाता सेटअप मेनू से ChatGPT or Codex Subscription चुनकर शुरू किया जाता है:

hermes model

इस विकल्प को चुनने पर कंसोल एक बार इस्तेमाल होने वाला सत्यापन URL और एक अद्वितीय अल्फ़ान्यूमेरिक डिवाइस कोड प्रदर्शित करता है। ब्राउज़र में यह लिंक खोलें, अपने OpenAI खाते में साइन इन करें और कनेक्शन को अधिकृत करें। पुष्टि होने के बाद, Hermes प्राप्त एक्सेस और रिफ्रेश टोकन को स्थानीय रूप से ~/.hermes/auth.json में सहेजता है। यदि मशीन में पहले से ही Codex CLI से सक्रिय क्रेडेंशियल मौजूद हैं, तो एजेंट स्वचालित रूप से उन्हें ~/.codex/auth.json से आयात कर लेता है, जिससे अलग से Codex CLI पैकेज इंस्टॉल करने की आवश्यकता नहीं होती है।

प्रमाणीकरण त्रुटि प्रबंधन और टोकन क्वारंटीन

यदि प्राधिकरण सर्वर कोई घातक प्रमाणीकरण त्रुटि लौटाता है (जैसे कि HTTP 4xx प्रतिक्रिया, invalid_grant स्थिति, या उपयोगकर्ता द्वारा अनुमतियों को रद्द करना), तो Hermes टर्मिनल लॉग में बार-बार संदेश आने से रोकने के लिए पुनः प्रयास बंद कर देता है। अमान्य रिफ्रेश टोकन को तुरंत स्थानीय क्वारंटीन स्थिति में ले जाया जाता है। बाद के प्रयासों में, सिस्टम उपयोगकर्ता को फिर से लॉगिन करने के लिए एक टाइप किया हुआ सूचना संदेश दिखाता है।

क्वारंटीन स्थिति को रीसेट करने और लॉगिन फ्लो को फिर से पूरा करने के लिए, निम्न कमांड चलाएं:

hermes auth add openai-codex

वैकल्पिक रूप से, hermes model सेटअप विज़ार्ड को फिर से चलाएं और सब्सक्रिप्शन प्रदाता को फिर से चुनें। क्रेडेंशियल्स को सफलतापूर्वक रीफ्रेश करने पर क्वारंटीन स्थिति अपने आप हट जाती है।

समर्पित API बनाम सब्सक्रिप्शन एक्सेस

उपभोक्ता सब्सक्रिप्शन द्वारा समर्थित OAuth कनेक्शन और स्थिर कुंजियों का उपयोग करने वाले सीधे API कनेक्शन पूरी तरह से अलग वित्तीय और बुनियादी ढांचे के वातावरण में काम करते हैं:

1. सब्सक्रिप्शन: सीधे उपभोक्ता ChatGPT खाते से जुड़ा होता है। आधिकारिक दस्तावेज़ समर्थित सब्सक्रिप्शन प्लान को निर्दिष्ट नहीं करते हैं और न ही यह समझाते हैं कि OAuth-संचालित अनुरोध कोटा शेष को कैसे कम करते हैं। एजेंट कार्य शुरू करने से पहले आपको अपने खाते की स्थिति और बिलिंग काउंटरों की जांच करनी चाहिए।
2. API कुंजी: openai-api प्रदाता (~/.hermes/.env में OPENAI_API_KEY) या तीसरे पक्ष के गेटवे का चयन करते समय उपयोग की जाती है। परिचालन खर्च चयनित प्रदाता के मूल्य निर्धारण कार्यक्रम का पालन करते हैं और हमेशा केवल कच्चे टोकन की मात्रा तक सीमित नहीं होते हैं।

यदि एजेंट परिनियोजन के लिए प्रति-अनुरोध विस्तृत बिलिंग पारदर्शिता या वैकल्पिक ओपन-वेट्स मॉडल तक पहुंच की आवश्यकता है, तो सब्सक्रिप्शन रूट को एक समर्पित गेटवे से पूरक या प्रतिस्थापित किया जा सकता है। एक स्वतंत्र आर्किटेक्चर के उदाहरण के रूप में, BetterToken दस्तावेज़ देखें, जो मानक OpenAI-संगत एंडपॉइंट, व्यक्तिगत एक्सेस कुंजी और डैशबोर्ड-स्तरीय उपयोग ट्रैकिंग प्रदान करता है। समर्पित तृतीय-पक्ष API रूटिंग एक अलग चैनल के रूप में काम करती है: यह मौजूदा ChatGPT/Codex सब्सक्रिप्शन को परिवर्तित नहीं करती है, सब्सक्रिप्शन कोटा से कटौती नहीं करती है, और समान मॉडलों की उपलब्धता की गारंटी नहीं देती है।

सत्यापन चेकलिस्ट और समस्या निवारण

चूंकि उपभोक्ता सब्सक्रिप्शन के तहत कोटा कटौती को नियंत्रित करने वाले सटीक तंत्र प्रकाशित नहीं हैं, नियमित उपयोग से पहले एक अनुभवजन्य आधार रेखा स्थापित करने की दृढ़ता से अनुशंसा की जाती है:

1. खाता पैरामीटर: प्रदाता के वेब कंसोल के अंदर अपने सक्रिय सब्सक्रिप्शन टियर और उपलब्ध बैलेंस की जांच करें और उसे नोट करें (समर्थित प्लान की आवश्यकताएं अभी भी अप्रकाशित हैं)।
2. टाइमस्टैम्प और बेसलाइन: अपने परीक्षण के प्रारंभ समय (टाइमस्टैम्प) के साथ प्रारंभिक उपयोग काउंटरों को रिकॉर्ड करें।
3. न्यूनतम प्रॉम्प्ट: एक एजेंट सत्र शुरू करें और बाहरी टूल कॉल के बिना एक संक्षिप्त क्वेरी निष्पादित करें (उदाहरण के लिए: Calculate 256 * 4)।
4. बैलेंस मिलान: उचित प्रतीक्षा के बाद प्रदाता के बिलिंग इंटरफ़ेस की पुनः जांच करें, क्योंकि टेलीमेट्री रिपोर्टिंग में लगने वाला समय अनिर्दिष्ट है। यदि काउंटर तुरंत अपडेट नहीं होता है, तो इसका अर्थ यह नहीं है कि कॉल मुफ्त थी।
5. सुरक्षा स्वच्छता: ~/.hermes/auth.json क्रेडेंशियल्स को कभी भी तीसरे पक्ष के साथ साझा न करें और न ही टोकन अंशों वाले रॉ टर्मिनल सत्र लॉग प्रकाशित करें।

यदि सफल लॉगिन के बाद Hermes HTTP 403 त्रुटि लौटाता है या अपर्याप्त अनुमतियों की रिपोर्ट करता है, तो Codex के लिए इसका सटीक अंतर्निहित कारण दस्तावेज़ों में स्पष्ट नहीं है। त्रुटि संदेश की जांच करें, खाता पात्रता और अनुमतियों के स्तर की पुष्टि करें, चयनित रूट और मॉडल ID सत्यापित करें, और प्रदाता के आधिकारिक दस्तावेज़ या ग्राहक सहायता से संपर्क करें। आवश्यकता पड़ने पर, व्यक्तिगत एक्सेस कुंजी के साथ एक समर्पित API प्रदाता पर स्विच करना एक वैकल्पिक मार्ग प्रदान करता है।