ज्ञानकोश अनुभाग ▾

नेविगेशन

▸ यहाँ से शुरू करें भूमिका के अनुसार

श्रेणियाँ

उपकरण 37
शब्दावली 12

उपकरण

प्रबंधन कुंजी — गोनका पर साaएस

क्या आप एक SaaS डेवलपर हैं और अपनी खुद की अवसंरचना के बिना अपने ग्राहकों को AI-अनुमान की पेशकश करना चाहते हैं? प्रबंधन कुंजियाँ पदानुक्रमित API कुंजियों को बनाने की अनुमति देती हैं: एक मास्टर कुंजी व्यक्तिगत सीमाओं और समाप्ति तिथि के साथ कई क्लाइंट कुंजियों का प्रबंधन करती है। हुड के तहत — JoinGonka Gateway और Gonka नेटवर्क।

प्रबंधन कुंजियाँ क्या हैं

प्रबंधन कुंजियाँ Gonka AI Gateway के शीर्ष पर SaaS उत्पाद बनाने के लिए पदानुक्रमित API कुंजियों की एक प्रणाली है।

वास्तुकला दो-स्तरीय है:

  • प्रबंधन कुंजी (gm-) — आपकी मास्टर कुंजी। यह सीधे अनुमान के लिए उपयोग नहीं की जाती है — केवल चाइल्ड कुंजियों को बनाने और प्रबंधित करने के लिए।
  • चाइल्ड कुंजी (gc-) — आपके क्लाइंट के लिए कुंजी। इसका उपयोग अनुमान अनुरोधों के लिए किया जाता है। बिलिंग प्रबंधन कुंजी के मालिक के बैलेंस से डेबिट की जाती है।

यह एक व्हाइट-लेबल मॉडल है: आपके क्लाइंट अपनी gc- कुंजियों के माध्यम से काम करते हैं और Gonka के बारे में नहीं जानते हैं — उनके लिए यह आपकी सेवा है।

यह क्यों जरूरी है

प्रबंधन कुंजियों के बिना आप सभी ग्राहकों को एक ही API कुंजी वितरित करते — खर्चों के नियंत्रण के बिना, अलगाव के बिना, विश्लेषण के बिना। प्रबंधन कुंजियाँ 4 समस्याओं का समाधान करती हैं:

समस्याकैसे हल करती है
खर्च नियंत्रणप्रत्येक बाल कुंजी पर GNK में दैनिक और मासिक सीमा
अस्थायी पहुंचTTL (expires_at) — कुंजी स्वचालित रूप से निष्क्रिय हो जाती है
ग्राहक अलगावप्रत्येक ग्राहक अपनी gc- कुंजी और दर सीमा के साथ
एकीकृत बिलिंगसभी बाल कुंजियाँ आपके शेष राशि से डेबिट होती हैं — एक ही बिल

प्रबंधन कुंजी कैसे बनाएं

चरण 1: gate.joingonka.ai पर रजिस्टर करें और GNK या USDT से अपना बैलेंस टॉप-अप करें।

चरण 2: API के माध्यम से एक प्रबंधन कुंजी बनाएं:

curl -X POST https://gate.joingonka.ai/api/management/keys \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "My SaaS"}'

उत्तर में एक सादी कुंजी (prefix gm-) होती है — इसे सहेजें, यह केवल एक बार दिखाई जाती है

चरण 3: क्लाइंट के लिए एक चाइल्ड कुंजी बनाएं:

curl -X POST https://gate.joingonka.ai/api/management/keys/{gm_key_id}/children \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "Client A", "limit_daily_ngonka": "1000000000", "rate_limit_rpm": 30}'

क्लाइंट A को 1 GNK/दिन और 30 अनुरोध/मिनट की सीमा के साथ gc- कुंजी प्राप्त होती है।

सीमाएं और TTL

प्रत्येक चाइल्ड की तीन प्रकार की सीमाओं का समर्थन करती है:

  • दैनिक सीमा (limit_daily_ngonka) — UTC-दिन के लिए अधिकतम खर्च। मध्यरात्रि UTC पर स्वचालित रूप से रीसेट होता है।
  • मासिक सीमा (limit_monthly_ngonka) — कैलेंडर माह के लिए अधिकतम।
  • TTL (expires_at) — कुंजी की समाप्ति तिथि/समय। इसके बाद कुंजी प्रमाणित होना बंद कर देती है।

दैनिक या मासिक सीमा से अधिक होने पर क्लाइंट को विवरण के साथ HTTP 402 प्राप्त होता है:

{"error": {"type": "child_key_limit", "daily_remaining": "0", "monthly_remaining": "500000000"}}

सभी सीमाएं वैकल्पिक हैं — यदि निर्दिष्ट नहीं हैं, तो कुंजी केवल मालिक के बैलेंस से सीमित होती है।

चाइल्ड कीज़ का प्रबंधन

एपीआई के माध्यम से पूर्ण CRUD:

ऑपरेशनएंडपॉइंटविवरण
बनाएंPOST /api/management/keys/:id/childrenसीमाओं के साथ नई gc- कुंजी
सूचीGET /api/management/keys/:id/childrenउपयोग के साथ सभी चाइल्ड कुंजियाँ
अपडेट करेंPATCH /api/management/keys/:id/children/:childIdसीमाएं, RPM, स्थिति बदलें
हटाएंDELETE /api/management/keys/:id/children/:childIdसॉफ्ट-निष्क्रियकरण

डैशबोर्ड के माध्यम से प्रबंधन भी उपलब्ध है: API कुंजी → प्रबंधन कुंजी अनुभाग।

प्रतिद्वंद्वियों से तुलना

क्षमताJoinGonkaOpenRouter
Management keysgm- / gc-नहीं
दैनिक/मासिक सीमाएंGNK (nGNK)
TTL (समाप्ति समय)expires_at
डैशबोर्ड UIहाँ (Keys अनुभाग)
रेफरल10% L1 + 3% L2नहीं
Inference की कीमत$0.0047 / $0.014 प्रति 1M$0.08+/1M

JoinGonka सस्ते Gonka-inference नेटवर्क के ऊपर management keys के लिए GNK-सीमाएं, TTL और डैशबोर्ड UI प्रदान करता है।

प्रबंधन कुंजियाँ JoinGonka Gateway को एक व्हाइट-लेबल प्लेटफॉर्म में बदल देती हैं। एक प्रबंधन कुंजी → व्यक्तिगत सीमाओं के साथ असीमित संख्या में चाइल्ड कुंजियाँ। आपके ग्राहक AI-अनुमान प्राप्त करते हैं, और आप लागतों को नियंत्रित करते हैं और मार्जिन पर कमाते हैं।

अधिक जानना चाहते हैं?

अन्य अनुभागों का अन्वेषण करें या अभी GNK कमाना शुरू करें।

मुफ्त टोकन प्राप्त करें →