AI गेटवे वर्चुअल की (Virtual Key)

वर्चुअल की (Virtual Key) AI गेटवे द्वारा जारी क्रेडेंशियल है, जिसका उपयोग गेटवे प्रॉक्सी एंडपॉइंट तक पहुँचने के लिए किया जाता है। आप ऐप्स और AI टूल्स को वर्चुअल की देते हैं, जबकि असली विक्रेता API Key केवल गेटवे की ओर ही सुरक्षित रहती है। इससे असली कीज़ इधर-उधर बिखरने से बचती हैं और हर वर्चुअल की के लिए अलग-अलग अनुमतियाँ, रेट लिमिट, रोटेशन और निरस्तीकरण संभव होता है। यह दस्तावेज़ वर्चुअल की के पूरे जीवनचक्र प्रबंधन को समझाता है।

वर्चुअल की का उपयोग क्यों करें

• असली की की सुरक्षा — ऐप्स और टूल्स केवल वर्चुअल की से संपर्क करते हैं, विक्रेता की असली Key बाहर नहीं जाती।
• उपयोग के अनुसार अनुमतियाँ बाँटें — अलग-अलग प्रोजेक्ट / टूल्स के लिए अलग वर्चुअल की बनाएँ और हर एक के लिए उपलब्ध मॉडल, चैनल और रेट अलग-अलग सीमित करें।
• कभी भी वापस लें — कोई की लीक हो जाए या उसकी आवश्यकता न रहे, तो सीधे निरस्त या रोटेट करें; दूसरी कीज़ पर कोई असर नहीं पड़ता।

पूर्वापेक्षाएँ

• ServBay खाते में लॉग इन होना चाहिए।
• चैनल पृष्ठ पर कम से कम एक उपयोगी चैनल जोड़ा हो।

वर्चुअल की बनाएँ

AI गेटवे → कीज़ (Keys) पृष्ठ पर जाएँ और बनाएँ (Create) पर क्लिक करें:

• नाम — इस की के उपयोग की पहचान के लिए (जैसे claude-code, my-app-dev)।
• विवरण (वैकल्पिक) — अतिरिक्त जानकारी।
• समाप्ति समय — कभी समाप्त न होने वाला या निर्दिष्ट तिथि चुन सकते हैं।
• अनुमत चैनल (वैकल्पिक) — टैग के ज़रिए इस की को केवल निर्दिष्ट चैनलों तक रूट करने की सीमा; खाली छोड़ने पर कोई सीमा नहीं।
• अनुमत मॉडल (वैकल्पिक) — इस की से केवल निर्दिष्ट मॉडल कॉल करने की सीमा; खाली छोड़ने पर कोई सीमा नहीं।
• रेट लिमिट (वैकल्पिक):
  • RPM / TPM — प्रति मिनट अनुरोध / टोकन की अधिकतम सीमा।
  • RPD / TPD — प्रति दिन अनुरोध / टोकन की अधिकतम सीमा।

स्पष्ट टेक्स्ट कभी भी वापस लिया जा सकता है

की सफलतापूर्वक बन जाने के बाद, गेटवे स्पष्ट टेक्स्ट की दिखाता है (जैसे servbay-sk-xxxxxxxx...)। गेटवे स्पष्ट टेक्स्ट को स्थानीय रूप से सहेजता है, इसलिए बाद में भी की विवरण में इसे वापस पाया जा सकता है; केवल शुरुआती समय में हैश तरीके से बनाई गई ऐतिहासिक कीज़ का कोई पुनर्प्राप्त करने योग्य स्पष्ट टेक्स्ट नहीं होता (वापस माँगने पर 409 लौटता है)। अगर की लीक होने का संदेह हो, तो सीधे "रोटेट" करें।

की सूची

की सूची प्रत्येक वर्चुअल की के लिए दिखाती है:

• प्रीफ़िक्स — जैसे servbay-sk-abcd..., पहचान के लिए।
• स्थिति — सक्रिय (active), निरस्त (revoked), समाप्त (expired)।
• बनाने का समय / अंतिम उपयोग का समय।
• अनुमति टैग — अनुमत मॉडल / चैनल, रेट लिमिट।

कीज़ का प्रबंधन

की सूची में, प्रत्येक की के लिए निम्न कार्य किए जा सकते हैं:

कार्रवाई	विवरण	प्रभाव
संपादित करें (Edit)	नाम, विवरण, अनुमत मॉडल / चैनल, रेट लिमिट बदलें	तुरंत लागू होता है, की स्वयं नहीं बदलती
रोटेट करें (Renew)	स्पष्ट टेक्स्ट फिर से बनाएँ, पुराना स्पष्ट टेक्स्ट तुरंत अमान्य हो जाता है, नया स्पष्ट टेक्स्ट कभी भी वापस पाया जा सकता है	इस की का उपयोग करने वाले सभी ऐप्स और टूल्स को अपडेट करना होगा
निरस्त करें (Revoke)	की को तुरंत निष्क्रिय करें, लेकिन ऑडिट रिकॉर्ड रखें	पुनर्प्राप्त नहीं; इस की वाले अनुरोध अस्वीकार किए जाएँगे
हटाएँ (Delete)	की को पूरी तरह हटाएँ	पुनर्प्राप्त नहीं

रोटेट बनाम निरस्त

• रोटेट (Renew): की स्वयं बनी रहती है, केवल नया स्पष्ट टेक्स्ट मिलता है—यह उन स्थितियों के लिए उपयुक्त है जहाँ की लीक होने का संदेह हो, पर उसी की कॉन्फ़िगरेशन का उपयोग जारी रखना हो; उपयोगकर्ताओं को साथ-साथ अपडेट करना याद रखें।
• निरस्त (Revoke): की को स्थायी रूप से अमान्य करें पर रिकॉर्ड रखें, ताकि ऑडिट आसान हो—यह तब उपयुक्त है जब पुष्टि हो कि किसी की की अब आवश्यकता नहीं है। रोटेट और निरस्त दोनों के लिए दूसरी बार पुष्टि आवश्यक होगी।

वन-क्लिक टेकओवर से संबंध

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

अक्सर पूछे जाने वाले प्रश्न (FAQ)

• प्रश्न: मैं स्पष्ट टेक्स्ट की कॉपी करना भूल गया, क्या करूँ?
  • उत्तर: की विवरण में स्पष्ट टेक्स्ट वापस पाया जा सकता है; केवल शुरुआती समय में हैश तरीके से बनाई गई ऐतिहासिक कीज़ वापस नहीं पाई जा सकतीं, ऐसी स्थिति में "रोटेट" करें।
• प्रश्न: निरस्त करने और हटाने में क्या अंतर है?
  • उत्तर: निरस्त करने पर की रिकॉर्ड बना रहता है (ऑडिट के लिए आसान), जबकि हटाने पर वह पूरी तरह मिट जाता है। दोनों ही की को तुरंत अमान्य कर देते हैं।
• प्रश्न: "अनुमत मॉडल" सीमित करने के बाद, ऐप किसी अन्य मॉडल का अनुरोध करे तो क्या होगा?
  • उत्तर: गेटवे उस की की अनुमति से बाहर के मॉडल अनुरोधों को अस्वीकार कर देगा। सुनिश्चित करें कि ऐप द्वारा उपयोग किए जाने वाले मॉडल अनुमत सूची में हैं, या प्रतिबंध हटा दें।
• प्रश्न: रेट लिमिट ट्रिगर होने पर क्या होगा?
  • उत्तर: RPM/TPM/RPD/TPD से अधिक अनुरोधों को गेटवे द्वारा सीमित कर दिया जाएगा। वास्तविक उपयोग को आंकड़े पेज पर देखकर ऊपरी सीमा समायोजित कर सकते हैं।

सारांश

वर्चुअल कीज़ आपको न्यूनतम अनुमतियों और रद्द करने योग्य तरीके से ऐप्स और टूल्स तक AI क्षमताएँ उपलब्ध कराने देती हैं। अनुमत मॉडल / चैनल प्रतिबंधों और रेट लिमिट के साथ, आप हर उपयोग परिदृश्य के लिए क्रेडेंशियल अनुकूलित कर सकते हैं और आवश्यकता पड़ने पर कभी भी रोटेट या निरस्त कर सकते हैं, बिना असली विक्रेता API Key को छूए।