प्लैटफ़ॉर्म

कुंजी की सीमाएँ और नियम

हर API कुंजी का इस्तेमाल उसके तय काम तक सीमित रखें: कितना खर्च हो, कितनी तेज़ी से, कौन से मॉडल, कहाँ से और कब तक। ये सीमाएँ कुंजी बनाते समय या कभी भी API कुंजियाँ → बदलाव करें में सेट करें।

नियम

नियम	सीमा पार होने पर	गड़बड़ी
मासिक बजट (USD)	अगले महीने तक रिक्वेस्ट अस्वीकार की जाती हैं (UTC)	`402 key_budget_exceeded`
दैनिक बजट (USD)	UTC के अनुसार आधी रात तक अस्वीकार	`402 key_daily_budget_exceeded`
रेट लिमिट (प्रति मिनट रिक्वेस्ट)	`retry-after` के साथ कुछ देर के लिए अस्वीकार	`429 rate_limit_exceeded`
समय-सीमा	कुंजी काम करना बंद कर देती है	`401 expired_api_key`
अनुमति वाले मॉडल	दूसरे मॉडल की रिक्वेस्ट अस्वीकार की जाती हैं	`403 model_not_allowed`
अनुमति वाले IP पते	दूसरी जगहों से आने वाली रिक्वेस्ट अस्वीकार की जाती हैं	`403 ip_not_allowed`

अस्वीकार की गई रिक्वेस्ट का कभी शुल्क नहीं लिया जाता। बजट में वह रकम भी गिनी जाती है जो कुंजी की चल रही रिक्वेस्ट के लिए अलग रखी गई है (बिलिंग देखें), इसलिए जो रिक्वेस्ट कुंजी का बजट पार कर सकती है, उसे शुरू होने से पहले ही अस्वीकार कर दिया जाता है, और जवाब देते समय बजट सीमा तक पहुँचने पर जवाब वहीं रुक जाता है और बजट की गड़बड़ी लौटाई जाती है। बदलाव हर जगह 15 सेकंड के भीतर लागू हो जाते हैं। आपका वर्कस्पेस बैलेंस हर कुंजी पर लागू होता है: जब वह किसी रिक्वेस्ट की लागत के लिए काफ़ी नहीं होता, तो रिक्वेस्ट को 402 insufficient_quota मिलता है।

अनुमति वाले मॉडल

टेक्स्ट, इमेज या वीडियो के कोई भी मॉडल चुनें। उदाहरण के लिए, gpt-6-sol और gemini-3.7-flash तक सीमित कुंजी कोई दूसरा मॉडल इस्तेमाल नहीं कर सकती, और स्मार्ट रूटिंग भी उसी सूची के वैकल्पिक मॉडल इस्तेमाल करती है। Zurelay Auto की अनुमति देने पर कुंजी उस मॉडल का इस्तेमाल कर सकती है जिसे Auto चुने।

अनुमति वाले IP पते

अलग-अलग पते और CIDR रेंज, IPv4 और IPv6, हर कुंजी के लिए अधिकतम 100। जाँच उस पते की होती है जिससे आपकी रिक्वेस्ट इंटरनेट पर आती है (प्रॉक्सी या NAT के पीछे होने पर, यह प्रॉक्सी का पता होता है)।

उदाहरण

203.0.113.7          one address
198.51.100.0/24      a range of 256 addresses
2001:db8::/32        an IPv6 range

सर्वरलेस प्लेटफ़ॉर्म और कुछ क्लाउड बदलते पतों से रिक्वेस्ट भेजते हैं। बाहर जाने वाले ट्रैफ़िक के लिए अपने प्रोवाइडर की प्रकाशित रेंज इस्तेमाल करें, या उन कुंजियों पर IP की पाबंदी न लगाएँ और दूसरे नियमों का सहारा लें।

बजट इस्तेमाल करने के सुझाव

हर ऐप या एनवायरनमेंट के लिए अलग कुंजी और बजट रखें, ताकि कोई बेकाबू लूप पूरा बैलेंस खत्म न कर दे।
दैनिक बजट किसी बग को उसी दिन रोक लेता है; मासिक बजट बिल को सीमा में रखता है।
API कुंजियाँ पेज पर हर कुंजी के बजट के साथ उसका आज का और इस महीने का खर्च दिखता है।

कोई सवाल है, या कुछ छूट गया है? हमारी सहायता टीम से पूछें और हम ईमेल से जवाब देंगे, आम तौर पर एक मिनट के भीतर.