API टास्क सीमा#

जनरेशन API असिंक्रोनस टास्क प्रोसेसिंग का उपयोग करते हैं। जब एक टास्क सफलतापूर्वक बनाया जाता है, तो API एक taskId लौटाता है। टास्क स्थिति, प्रगति, क्यू इकाई, और अंतिम आउटपुट की जाँच करने के लिए परिणाम एंडपॉइंट का उपयोग करें।

यह दस्तावेज़ API एकीकरणों के लिए सार्वजनिक टास्क सीमाओं की व्याख्या करता है, जिसमें प्रति मिनट अनुरोध, अपूर्ण जॉब्स, और कई टास्क प्रस्तुत किए जाने पर क्रेडिट कैसे शुल्क होते हैं, शामिल हैं।

---

रेट लिमिट सारांश#

जनरेशन API टास्क निर्माण के लिए एक स्थिर सार्वजनिक प्रति-मिनट-अनुरोध सीमा का उपयोग नहीं करते हैं। व्यावहारिक सीमा इस बात पर आधारित है कि एक खाते के पास एक ही समय में कितनी अपूर्ण जॉब्स हैं।

अपूर्ण जॉब्स में क्यू की गई जॉब्स और चालू जॉब्स दोनों शामिल हैं।

30-जॉब सीमा एक टास्क-गिनती सीमा है, न कि एक क्रेडिट पैकेज या मुफ्त कोटा। प्रत्येक स्वीकृत जनरेशन टास्क को उस API के क्रेडिट नियमों के अनुसार शुल्क किया जाता है।

---

टास्क स्थिति#

परिणाम एंडपॉइंट waitNumber भी लौटा सकता है, जो प्रतीक्षा कर रहे टास्क के लिए क्यू स्थिति को दर्शाता है। जब टास्क चल रहा होता है या समाप्त हो जाता है, तो waitNumber आमतौर पर 0 होता है।

---

AI 3D टास्क#

AI 3D टास्क एक समय पर एक-एक करके प्रोसेस किए जाते हैं।

आप कई AI 3D टास्क प्रस्तुत कर सकते हैं और प्रत्येक सफल प्रस्तुतीकरण एक taskId लौटाता है। हालाँकि, एक ही समय में केवल एक AI 3D टास्क चलता है। अतिरिक्त AI 3D टास्क वर्तमान टास्क समाप्त होने तक प्रतीक्षा करते हैं।

अनुशंसित एकीकरण व्यवहार:

1. लौटाए गए taskId को संग्रहीत करें।
2. हर 3-5 सेकंड में परिणाम एंडपॉइंट को पोल करें।
3. Unprocessed को प्रतीक्षा में मानें।
4. Processing को सक्रिय रूप से चलते हुए मानें।
5. अपने उपयोगकर्ताओं को प्रगति दिखाने के लिए waitNumber और percentage का उपयोग करें।

---

अन्य जनरेशन टास्क#

AI 3D के अलावा जनरेशन वर्कफ्लो के लिए, प्रत्येक खाते के पास वही वर्कफ्लो के लिए अधिकतम 30 अपूर्ण जॉब्स हो सकती हैं।

यह एक खाता-स्तर की सीमा है। यदि एक ही खाते के तहत कई API की बनाई जाती हैं, तो वे वही सीमा साझा करती हैं।

इसका हमेशा यह अर्थ नहीं है कि सभी 30 जॉब्स बिल्कुल उसी क्षण चल रही हैं। कुछ जॉब्स प्रतीक्षा में हो सकती हैं और कुछ चल रही हो सकती हैं। सीमा दोनों को गिनती है।

जब खाते के पास पहले से ही किसी वर्कफ्लो के लिए 30 अपूर्ण जॉब्स हों, तो उस वर्कफ्लो के लिए नए टास्क प्रस्तुतीकरण अस्थायी रूप से अस्वीकार किए जा सकते हैं जब तक मौजूदा जॉब्स समाप्त न हो जाएं।

---

क्रेडिट और अपूर्ण जॉब्स#

जब एक जनरेशन टास्क सफलतापूर्वक बनाया जाता है, तो क्रेडिट कटते हैं। यदि टास्क अंततः विफल हो जाता है, तो कटे गए क्रेडिट स्वतः रिफंड किए जाते हैं।

अपूर्ण-जॉब सीमा प्रत्येक टास्क के क्रेडिट लागत को नहीं बदलती है। यदि आप कई टास्क प्रस्तुत करते हैं, तो प्रत्येक स्वीकृत टास्क को अलग से शुल्क किया जाता है।

उदाहरण:

पूर्ण क्रेडिट टेबल के लिए, क्रेडिट विलोपन संदर्भ देखें।

परिणाम एंडपॉइंट को पोल करने से कोई नया जनरेशन टास्क नहीं बनता और यह अपूर्ण जॉब के रूप में गिना नहीं जाता।

---

अस्थायी सेवा व्यस्त प्रतिक्रियाएँ#

कुछ मामलों में, नए टास्क प्रस्तुतीकरण अस्थायी रूप से अस्वीकार किए जा सकते हैं क्योंकि सेवा व्यस्त है। यह तब भी हो सकता है जब आपके खाते के पास 30 से कम अपूर्ण जॉब्स हों।

यह अस्थायी है। इसे स्थायी विफलता के रूप में न मानें।

---

अनुशंसित क्लाइंट व्यवहार#

1. हर लौटाए गए taskId को संग्रहीत करें।
2. टास्क स्थिति को नियमित रूप से पोल करें।
3. प्रति खाता और वर्कफ्लो अपूर्ण जॉब्स की एक स्थानीय सूची बनाए रखें।
4. जब स्थिति Success या Failed हो जाती है, तो अपूर्ण सूची से जॉब्स को हटा दें।
5. गैर-AI-3D वर्कफ्लो के लिए, और प्रस्तुत करने से पहले अपूर्ण जॉब्स को 30 या उससे कम पर बनाए रखें।
6. यदि आपको 9015 या 5020 प्राप्त होता है, तो एक विलंब के बाद पुनः प्रयास करें।

अनुशंसित पुनः प्रयास व्यवहार:

---

उच्च थ्रूपुट की आवश्यकता है?#

यदि मानक 30 अपूर्ण जॉब्स प्रति खाता और वर्कफ्लो सीमा आपकी एकीकरण आवश्यकताओं को पूरा नहीं करती है, तो कृपया [email protected] पर हमसे संपर्क करें। हम आपके उपयोग के मामले की समीक्षा कर सकते हैं और उच्च थ्रूपुट या एक समर्पित व्यवस्था के विकल्पों पर चर्चा कर सकते हैं।

---