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, किंवा बिलिंगचे व्यवस्थापन करू शकत नाहीत.