रेट लिमिट

देखें कि आपका प्लान कितने रिक्वेस्ट और टास्क की अनुमति देता है, और जब आप किसी लिमिट पर पहुँचें तो क्या करें।

प्लान के अनुसार लिमिट

API को सभी के लिए तेज़ और उपलब्ध रखने के लिए, Meshy हर अकाउंट को दो तरीकों से सीमित करता है:

रिक्वेस्ट प्रति सेकंड: आप हर सेकंड कितने API रिक्वेस्ट भेज सकते हैं।
समवर्ती (concurrent) टास्क: आपके कितने टास्क एक साथ PENDING या IN_PROGRESS हो सकते हैं।

लिमिट आपके प्लान पर निर्भर करती हैं:

प्लान	रिक्वेस्ट प्रति सेकंड	समवर्ती टास्क	प्राथमिकता
Pro	20	10	डिफ़ॉल्ट
Premium	20	30	Pro से अधिक
Ultra	20	100	सबसे अधिक
Studio	20	60, या कुछ पुराने Studio प्लान पर 20	Pro से अधिक
Enterprise	100	डिफ़ॉल्ट रूप से 100, या एक कस्टम लिमिट	सबसे अधिक

प्राथमिकता कोई लिमिट नहीं है। जब क्यू व्यस्त होती है, तो Meshy पहले उच्च प्राथमिकता वाले टास्क शुरू करता है।

प्रत्येक लिमिट में क्या गिना जाता है

हर API रिक्वेस्ट रिक्वेस्ट प्रति सेकंड में गिना जाता है, जिसमें टास्क प्राप्त करने, सूचीबद्ध करने, या स्ट्रीम करने वाले रिक्वेस्ट भी शामिल हैं। Meshy वेब ऐप से आने वाले रिक्वेस्ट नहीं गिने जाते।

समवर्ती टास्क लिमिट रिक्वेस्ट को नहीं, बल्कि टास्क को गिनती है। जो भी एंडपॉइंट कोई टास्क बनाता है, वह टास्क बनाने से पहले इस लिमिट की जाँच करता है। उदाहरण के लिए, टेक्स्ट से 3D, इमेज से 3D, मल्टी-इमेज से 3D, रीटेक्सचर, रीमेश, Rigging, एनिमेशन, टेक्स्ट से इमेज, 3D प्रिंटिंग एंडपॉइंट, और Creative Lab इसकी जाँच करते हैं।

जो रिक्वेस्ट कोई टास्क नहीं बनाते, वे इसमें नहीं गिने जाते। उदाहरण के लिए, Balance, Usage, और टास्क प्राप्त करने, सूचीबद्ध करने, या स्ट्रीम करने वाले रिक्वेस्ट नहीं गिने जाते।

किसकी लिमिट लागू होती है

निम्नलिखित तालिका दिखाती है कि आपकी API की, Playground, और वेब ऐप किसकी लिमिट में गिने जाते हैं:

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

जब आप किसी लिमिट पर पहुँचते हैं

जब आप किसी लिमिट से अधिक हो जाते हैं, तो API 429 Too Many Requests लौटाता है। संदेश बताता है कि आप किस लिमिट पर पहुँचे हैं:

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

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

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

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

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