टास्क लाइफसाइकल
जानें कि एक टास्क अनुरोध से परिणाम तक कैसे आगे बढ़ता है, इसमें आमतौर पर कितना समय लगता है, और आपके कोड को इसके लिए कितनी देर प्रतीक्षा करनी चाहिए।
टास्क कैसे चलता है
एक क्रिएट अनुरोध टास्क के चलने की प्रतीक्षा किए बिना एक टास्क ID लौटाता है। इसके बाद टास्क बैकग्राउंड में चलता है, और आप इसे तीन तरीकों में से किसी एक से फॉलो करते हैं: इसके GET एंडपॉइंट को पोल करें, इसके स्ट्रीम एंडपॉइंट को खोलें, या webhook प्राप्त करें।
PENDING में एक टास्क शुरू करता है। एक वर्कर इसे उठाता है और यह IN_PROGRESS में चला जाता है, जहाँ यह अपना अधिकांश समय बिताता है। यह SUCCEEDED या FAILED पर समाप्त होता है, और अंतिम स्थिति कभी नहीं बदलती।PENDINGIN_PROGRESSSUCCEEDEDFAILEDटास्क हर चरण को अपने created_at, started_at, और finished_at फील्ड में दर्ज करता है।
निम्न तालिका दिखाती है कि प्रत्येक स्थिति पर आपके कोड को क्या करना चाहिए।
| स्थिति | आपके कोड को क्या करना चाहिए |
|---|---|
PENDING | प्रतीक्षा जारी रखें। |
IN_PROGRESS | progress को ट्रैक करें: पूरा हो चुके काम का प्रतिशत, 0 से 100 तक। |
SUCCEEDED | परिणाम डाउनलोड करें। Meshy फ़ाइलों को सीमित समय के लिए रखता है। देखें एसेट रिटेंशन। |
FAILED | task_error पढ़ें, फिर इनपुट ठीक करें या एक नया टास्क बनाएँ। देखें एरर। |
CANCELED | प्रतीक्षा करना बंद करें। टास्क कोई परिणाम नहीं देगा। केवल Creative Lab टास्क इस स्थिति का उपयोग करते हैं। |
SUCCEEDED, FAILED, और CANCELED अंतिम स्थितियाँ हैं। एक बार टास्क इनमें से किसी एक पर पहुँच जाए, तो उसकी स्थिति फिर कभी नहीं बदलती।
आपके कोड से देखने पर यह ऐसा दिखता है:
अनुरोध: POST/image-to-3d
रिस्पॉन्स: 202{ "result": "<task_id>" }टास्क बनाया गया
- हर कुछ सेकंड में दोहराएँ
अनुरोध: GET/image-to-3d/<task_id>
रिस्पॉन्स: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5
अनुरोध: GET/image-to-3d/<task_id>
रिस्पॉन्स: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }
GET करें।प्रोसेसिंग समय
निम्न तालिकाएँ सितंबर 2026 में प्रोडक्शन API ट्रैफ़िक पर माध्य (median) समय दिखाती हैं।
समय टास्क बनाए जाने से लेकर अंतिम स्थिति तक चलता है। इसका लगभग पूरा हिस्सा प्रोसेसिंग का होता है, क्योंकि एक टास्क आमतौर पर PENDING में केवल कुछ सेकंड के लिए ही रहता है। जब कतार व्यस्त होती है, तो टास्क शुरू होने से पहले अधिक समय तक प्रतीक्षा कर सकते हैं, और उच्च प्राथमिकता वाली योजनाओं पर टास्क आमतौर पर जल्दी शुरू होते हैं।
2 मिनट से कम समय सेकंड (s) में हैं, और लंबे समय मिनट (min) में हैं। "समर्थित नहीं" का मतलब है कि API उस मॉडल के साथ वह विकल्प प्रदान नहीं करता।
ये सामान्य समय हैं, गारंटीशुदा पूर्णता समय नहीं। व्यस्त अवधि के दौरान, कुछ टास्क में अधिक समय लगता है और फिर भी वे सफल होते हैं। Meshy की स्थिति जाँचने के लिए, स्टेटस पेज देखें। इन समयों का उपयोग अपने कोड में timeout के रूप में न करें। timeout मान के लिए, कितनी देर प्रतीक्षा करें देखें।
3D जनरेशन
| API | कॉन्फ़िगरेशन | meshy-7.1 (latest) | meshy-6 | meshy-6-lite | meshy-t2 |
|---|---|---|---|---|---|
| टेक्स्ट से 3D (Preview) | केवल मेश | 75 s | 90 s | 45 s | 10 s |
| इमेज से 3D | केवल मेश | 75 s | 90 s | 40 s | 4 s |
| 2K टेक्सचर के साथ मेश | 2 min | 3 min | 75 s | 60 s | |
| 4K टेक्सचर के साथ मेश | 2.5 min | 3.5 min | समर्थित नहीं | 80 s | |
| 8K टेक्सचर के साथ मेश | 3.5 min | 4 min | समर्थित नहीं | 2.5 min | |
| मल्टी-इमेज से 3D | केवल मेश | 65 s | 2 min | 30 s | समर्थित नहीं |
| 2K टेक्सचर के साथ मेश | 2.5 min | 3.5 min | 85 s | समर्थित नहीं | |
| 4K टेक्सचर के साथ मेश | 3 min | 4 min | समर्थित नहीं | समर्थित नहीं | |
| 8K टेक्सचर के साथ मेश | 3.5 min | 4.5 min | समर्थित नहीं | समर्थित नहीं |
इमेज से 3D और मल्टी-इमेज से 3D के लिए, "केवल मेश" का मतलब है should_texture: false। ये विकल्प और इनपुट समय को बदलते हैं:
- PBR मैप (
enable_pbr) 30 से 60 सेकंड जोड़ता है। - अल्ट्रा ज्यामिति (
geometry_resolution: "2k"या"4k") 1 मिनट तक जोड़ती है। - समान सेटिंग के साथ, अधिक जटिल इनपुट इमेज में अधिक समय लगता है।
टेक्सचरिंग
| API | टेक्सचर रिज़ॉल्यूशन | सामान्य समय |
|---|---|---|
| टेक्स्ट से 3D (Refine) | 2K या 4K | 80 s |
| 8K | 3.5 min | |
| रीटेक्सचर | 2K | 55 s |
| 4K | 90 s | |
| 8K | 2.5 min |
इमेज जनरेशन
| API | nano-banana | nano-banana-2 | nano-banana-pro | GPT Image मॉडल |
|---|---|---|---|---|
| टेक्स्ट से इमेज | 20 s | 15 s | 25 s | 20 से 35 s |
| इमेज से इमेज | 40 s | 20 s | 30 s | 20 से 40 s |
Rigging और एनिमेशन
| API | कॉन्फ़िगरेशन | सामान्य समय |
|---|---|---|
| Auto-Rigging | स्वचालित rigging | 40 s |
| एनिमेशन | प्रति अनुरोध | 15 s |
| टेक्स्ट से मोशन | prime mode | 15 s |
swift mode | 10 s |
पोस्ट-प्रोसेसिंग
3D प्रिंटिंग
| API | कॉन्फ़िगरेशन | सामान्य समय |
|---|---|---|
| प्रिंट-योग्यता विश्लेषण | केवल मेश जाँच | 1 s |
| मेश और पतली-दीवार जाँच | 10 s | |
| मल्टी-कलर | प्रति अनुरोध | 30 s |
| प्रिंट-योग्यता मरम्मत | केवल मेश मरम्मत | 10 s |
| पतली-दीवार जाँच, दीवारें बरकरार रखी गईं | 20 s | |
| पतली-दीवार जाँच, दीवारें मोटी की गईं | 100 s | |
| Auto Split | फ्लैट-रंगीन पार्ट्स | 70 s |
टेक्सचर किए गए पार्ट्स (keep_texture: true) | 170 s |
v2 पर, प्रिंट-योग्यता मरम्मत और प्रिंट-योग्यता विश्लेषण हमेशा पतली-दीवार जाँच चलाते हैं। v1 पर, वे इसे तब चलाते हैं जब आप एक प्रिंटर प्रकार या प्रिंट साइज़ भेजते हैं।
कितनी देर प्रतीक्षा करें
आपके कोड के प्रतीक्षा करना बंद करने पर भी टास्क चलता रहता है। यदि आपका अनुरोध timeout हो जाता है, आपका कनेक्शन टूट जाता है, या आपकी स्ट्रीम बंद हो जाती है, तो टास्क विफल नहीं होता और रद्द नहीं होता।
- प्रतीक्षा बंद करने से पहले, टास्क के
created_atसे गिनते हुए कम से कम 60 मिनट प्रतीक्षा करें। यदि आप जल्दी रुक जाते हैं, तो आप ऐसे टास्क को मिस कर सकते हैं जो बाद में सफल होता है। ऐसा ज़्यादातर व्यस्त अवधि के दौरान होता है। - टास्क ID रखें। आप किसी भी समय टास्क को फिर से प्राप्त कर सकते हैं। यदि 60 मिनट के बाद भी यह अंतिम नहीं है, तो बाद में इसे फिर से जाँचें। यदि यह वैसा ही बना रहता है, तो सपोर्ट से संपर्क करें।
- केवल
FAILEDका मतलब है कि टास्क विफल हुआ। Meshy विफल टास्क को स्वतः रिफंड करता है।
अपने कोड में इन मानों का उपयोग करें:
| सेटिंग | अनुशंसित मान |
|---|---|
क्रिएट अनुरोध (POST) timeout | 60 सेकंड |
100 MB से बड़ी model_url फ़ाइल के साथ क्रिएट अनुरोध (POST) timeout | 120 सेकंड। Meshy रिस्पॉन्स देने से पहले फ़ाइल डाउनलोड करता है। |
स्टेटस अनुरोध (GET) timeout | 30 सेकंड |
| पोल अंतराल | Retry-After हेडर, या यदि यह गायब है तो 5 सेकंड। पोल आपके रेट लिमिट में गिने जाते हैं। |
विफल स्टेटस अनुरोध (timeout, 429, या 5xx) | अगली पोल पर फिर से प्रयास करें। इसका मतलब यह नहीं कि टास्क विफल हो गया। |
| प्रति टास्क कुल प्रतीक्षा | created_at से कम से कम 60 मिनट। स्ट्रीम को फिर से कनेक्ट करने पर इस गिनती को फिर से शुरू न करें। |
| स्ट्रीम | एक स्ट्रीम टास्क समाप्त होने से पहले बंद हो सकती है। यदि यह बिना अंतिम स्थिति के बंद हो जाती है, तो फिर से कनेक्ट करें या पोलिंग पर स्विच करें। |
एक साथ कई टास्क के लिए, हर एक को पोल करने के बजाय webhooks का उपयोग करें। यदि किसी टास्क का अंतिम इवेंट उसके सामान्य समय के लगभग दोगुने समय के बाद भी नहीं आया है, तो उसके GET एंडपॉइंट से टास्क प्राप्त करें।