API keys और लिमिट

Keys डैशबोर्ड पर बनाई जाती हैं (dashboard पर, याPOST /me/keys के माध्यम से)। पूरी key — br-…, 192 बिट एन्ट्रापी — केवल एक बार दिखाई जाती है और केवल एक हैश के रूप में संग्रहीत की जाती है; डैशबोर्ड पहले 12 वर्णों को उपसर्ग के रूप में प्रदर्शित करता है। बीटा में प्रति संगठन 5 सक्रिय keys तक।

टियर: ट्रायल बनाम स्टैंडर्ड

स्टैंडर्ड keys क्रेडिट पर निर्भर करती हैं: शून्य या नकारात्मक बैलेंस के साथ, अनुरोधinsufficient_credits (HTTP 402) के साथ विफल हो जाते हैं जब तक आपटॉप अप नहीं करते।

एक key बनाना

डैशबोर्ड से, या:

POST /me/keys
{ "name": "prod-backend", "budget_inr": 500, "expires_days": 90 }

→ { "key": "br-...", "tier": "standard", "budget_inr": 500, "expires_days": 90 }

• name — आपकी सक्रिय keys के बीच अद्वितीय होना चाहिए।
• budget_inr — ₹ में वैकल्पिक मासिक खर्च सीमा (नीचे देखें)।
• expires_days — वैकल्पिक auto-expiry, 1–365 दिन।

प्रति-key लिमिट

तीन स्वतंत्र सीमाएँ, सभी डैशबोर्ड पर प्रति key संपादन योग्य (PATCH /me/keys/:id), सभी स्थायी रूप से लागू और IST में संगणित:

इनके अलावा, गेटवे प्रति key एक वैश्विक 120 अनुरोध/मिनट लागू करता है। लिमिट और निरस्तीकरण परिवर्तन 60 सेकंड के भीतर प्रसारित होते हैं (key रिकॉर्ड इतनी देर तक कैश किए जाते हैं)।

मासिक ₹ बजट

एक बजट यह सीमित करता है कि एक key प्रति कैलेंडर माह कितना खर्च कर सकती है — एक साइड प्रोजेक्ट को ₹200/माह दें और इसके बारे में चिंता करना बंद करें। खर्च प्रत्येक प्रतिक्रिया के बाद दर्ज किया जाता है (लागत केवल टोकन गणना ज्ञात होने के बाद ही पता चलती है), इसलिए एकल इन-फ़्लाइट अनुरोध सीमा से थोड़ा अधिक हो सकता है; अगले अनुरोध को अवरुद्ध कर दिया जाता है। डैशबोर्ड प्रति key बजट के मुकाबले अब तक के खर्च को दर्शाता है, और GET /me/keys इसेspent_month को monthly_budget के साथ लौटाता है।

निरस्त करना

DELETE /me/keys/:id   →   { "revoked": true }

निरस्तीकरण स्थायी है और 60 सेकंड के भीतर हर जगह प्रभावी होता है।

एजेंट्स के लिए स्कोप और क्षणिक keys

मनुष्यों द्वारा बनाई गई keys का पूर्ण स्कोप होता है: इनफ़रेंस औरMCP सर्वर पर प्रबंधन उपकरण। MCP के माध्यम से, एक पूर्ण-स्कोप key रखने वाला एजेंट क्षणिक keys — अल्पकालिक (1–168 घंटे), केवल-इनफ़रेंस, दैनिक-सीमित (1,000 req/day तक) — बना सकता है ताकि उप-एजेंटों या अविश्वसनीय कोड को संगठन key को उजागर किए बिना दिया जा सके। क्षणिक keys keys, BYOK, या बिलिंग का प्रबंधन नहीं कर सकती हैं।