रेट लिमिट

रेट लिमिट वे प्रतिबंध हैं जो हमारा API किसी यूज़र या क्लाइंट द्वारा एक निर्दिष्ट समय-अवधि के भीतर हमारी सेवाओं तक पहुँचने की संख्या पर लगाता है।

सीमाएँ क्यों

हमने अपने API पर रेट लिमिट इसलिए लागू की हैं ताकि सभी के लिए सबसे अच्छा अनुभव बनाया जा सके। यहाँ बताया गया है कि ये क्यों महत्वपूर्ण हैं:

हमारी सेवा को सुरक्षित और सुचारू रखने के लिए! रेट लिमिट को मित्रवत बाउंसर समझें - वे सुनिश्चित करते हैं कि कोई भी एक साथ बहुत सारे रिक्वेस्ट भेजकर हमारे API को अभिभूत न कर सके। इससे हमारी सेवा को संभावित दुरुपयोग से बचाने में मदद मिलती है और सब कुछ सुचारू रूप से चलता रहता है।
यह सुनिश्चित करने के लिए कि हर किसी को उसका उचित हिस्सा मिले। ठीक वैसे ही जैसे खेल के मैदान में खिलौने साझा किए जाते हैं, हम चाहते हैं कि हमारे सभी यूज़र को API तक समान पहुँच मिले। हर यूज़र कितने रिक्वेस्ट कर सकता है, इसे हल्के ढंग से सीमित करके हम सुनिश्चित करते हैं कि किसी को भी अपनी बारी के लिए बहुत लंबा इंतज़ार न करना पड़े।
प्रदर्शन को तेज़ और भरोसेमंद बनाए रखने के लिए। रिक्वेस्ट के समग्र प्रवाह का प्रबंधन करके, हम अपने सभी शानदार यूज़र के लिए तेज़ रिस्पॉन्स समय और स्थिर सेवा बनाए रख सकते हैं। यह एक हाईवे को बहुत भीड़भाड़ वाला होने से बचाने जैसा है - जब हम जाम को रोकते हैं तो ट्रैफिक बेहतर तरीके से चलता है!

सीमाएँ कैसे काम करती हैं

रेट लिमिट को 2 तरीकों से मापा जाता है:

रिक्वेस्ट प्रति सेकंड: यह प्रति सेकंड आप जितने नेटवर्क रिक्वेस्ट कर सकते हैं, उनकी संख्या है।
क्यू टास्क: यह किसी भी समय क्यू में आप जितने समवर्ती जनरेशन टास्क चला सकते हैं, उनकी संख्या है।

क्यू टास्क आपके अकाउंट पर वे टास्क हैं जो PENDING या IN_PROGRESS स्थिति में हैं। टास्क बनाने वाला हर एंडपॉइंट (उदाहरण के लिए टेक्स्ट से 3D, इमेज से 3D, मल्टी-इमेज से 3D, रीटेक्सचर, रीमेश, Rigging, एनिमेशन, टेक्स्ट से इमेज, 3D प्रिंटिंग एंडपॉइंट और Creative Lab) नया टास्क स्वीकार करने से पहले इस सीमा की जाँच करता है। जो रिक्वेस्ट कोई टास्क नहीं बनाते, जैसे Balance, Usage, और टास्क प्राप्त करना, सूचीबद्ध करना या स्ट्रीम करना, वे इस सीमा में नहीं गिने जाते, हालाँकि वे फिर भी प्रति सेकंड रिक्वेस्ट में गिने जाते हैं।

ये सीमाएँ प्रति अकाउंट लागू होती हैं, इसलिए ये आपकी सभी API key और Playground में साझा होती हैं। Meshy वेब ऐप में आपके द्वारा शुरू किए गए टास्क भी आपके क्यू टास्क में गिने जाते हैं।

रेट लिमिट के अलावा, टास्क प्रोसेसिंग प्राथमिकता भी आपके टास्क की गति को प्रभावित करेगी।

हर यूज़र टियर में विशिष्ट रेट लिमिट और प्राथमिकता स्तर होते हैं जो उनकी ज़रूरतों के अनुसार बनाए गए हैं। यहाँ टियर के अनुसार वर्तमान सीमाएँ दी गई हैं:

यूज़र टियर	रिक्वेस्ट प्रति सेकंड	क्यू टास्क	प्राथमिकता स्तर
Pro	20	10	डिफ़ॉल्ट
Premium	20	30	Pro से उच्च
Ultra	20	100	सर्वोच्च
Studio	20	20	Pro से उच्च
Enterprise	100	डिफ़ॉल्ट रूप से 100, कस्टमाइज़ किया जा सकता है	सर्वोच्च

यदि आप इन सीमाओं को पार करते हैं, तो आपको हमारे API से 429 Too Many Requests रिस्पॉन्स प्राप्त होगा। इसे ट्रिगर करने वाले दो प्रकार के हिट हो सकते हैं, हर एक का रिस्पॉन्स अलग होता है:

रिक्वेस्ट हिट: यह तब होता है जब आप प्रति सेकंड बहुत अधिक रिक्वेस्ट करते हैं। आपको Rate limit exceeded संदेश के साथ 429 Too Many Requests रिस्पॉन्स प्राप्त होगा।
क्यू हिट: यह तब होता है जब आपके पास बहुत अधिक समवर्ती जनरेशन टास्क चल रहे होते हैं। आपको NoMorePendingTasks (या, जब आपके क्रेडिट खत्म हो जाएँ, तो NoMoreConcurrentTasks) संदेश के साथ 429 Too Many Requests रिस्पॉन्स प्राप्त होगा। इस 429 में कोई Retry-After नहीं होता: अगला टास्क बनाने से पहले अपने किसी टास्क के पूरा होने की प्रतीक्षा करें।

रेट लिमिट हेडर

API रिस्पॉन्स में ये हेडर शामिल होते हैं ताकि आप अपने रिक्वेस्ट की गति को नियंत्रित कर सकें:

हेडर	विवरण
`X-RateLimit-Limit`	आपके टियर पर प्रति सेकंड अनुमत रिक्वेस्ट।
`X-RateLimit-Remaining`	वर्तमान सेकंड में बचे हुए रिक्वेस्ट।
`X-RateLimit-Reset`	आपका बजट फिर से पूरा होने में बचे सेकंड।
`Retry-After`	अगले रिक्वेस्ट से पहले प्रतीक्षा करने के सेकंड। यह रिक्वेस्ट हिट `429` के साथ भेजा जाता है, और जब आप कोई ऐसा टास्क प्राप्त करते हैं जो अभी भी `PENDING` या `IN_PROGRESS` स्थिति में है।

जब Retry-After मौजूद हो, तो अगला रिक्वेस्ट भेजने से पहले उतने सेकंड प्रतीक्षा करें।