lowpoly 30 अक्टू॰ 2026 को बंद हो जाएगा। अनुरोध त्रुटियों से बचने के लिए इन तारीखों से पहले मॉडल बदल लें। सभी बहिष्करण देखें

टास्क लाइफसाइकल

जानें कि एक टास्क रिक्वेस्ट से रिज़ल्ट तक कैसे पहुँचता है, इसमें आमतौर पर कितना समय लगता है, और आपके कोड को इसके लिए कितनी देर इंतज़ार करना चाहिए।

टास्क कैसे चलता है

एक क्रिएट रिक्वेस्ट टास्क के चलने का इंतज़ार किए बिना एक टास्क ID लौटाता है। इसके बाद टास्क बैकग्राउंड में चलता है, और आप इसे तीन तरीकों में से किसी एक से फॉलो कर सकते हैं: इसके GET एंडपॉइंट को पोल करें, इसके स्ट्रीम एंडपॉइंट को खोलें, या webhook प्राप्त करें।

एक क्रिएट रिक्वेस्ट PENDING में एक टास्क शुरू करता है। एक वर्कर इसे उठाता है और यह IN_PROGRESS में चला जाता है, जहाँ यह अपना ज़्यादातर समय बिताता है। यह SUCCEEDED या FAILED पर समाप्त होता है, और अंतिम स्टेटस कभी नहीं बदलता।
क्रिएट रिक्वेस्ट
PENDING
कतार में इंतज़ार कर रहा है
IN_PROGRESS
रिज़ल्ट जनरेट किया जा रहा है
SUCCEEDED
रिज़ल्ट डाउनलोड करें
FAILED
क्रेडिट वापस कर दिए गए

टास्क हर चरण को अपने created_at, started_at, और finished_at फ़ील्ड में दर्ज करता है।

निम्न तालिका दिखाती है कि हर स्टेटस पर आपके कोड को क्या करना चाहिए।

स्टेटसआपके कोड को क्या करना चाहिए
PENDINGइंतज़ार करते रहें।
IN_PROGRESSprogress ट्रैक करें: पूरे हो चुके काम का प्रतिशत, 0 से 100 तक।
SUCCEEDEDरिज़ल्ट डाउनलोड करें। Meshy फ़ाइलों को एक सीमित समय के लिए रखता है। देखें Asset retention।
FAILEDtask_error पढ़ें, फिर इनपुट ठीक करें या एक नया टास्क बनाएं। देखें एरर।
CANCELEDइंतज़ार करना बंद करें। टास्क कोई रिज़ल्ट नहीं देगा। केवल Creative Lab टास्क इस स्टेटस का उपयोग करते हैं।

SUCCEEDED, FAILED, और CANCELED अंतिम स्टेटस हैं। एक बार टास्क इनमें से किसी एक पर पहुँच जाए, तो इसका स्टेटस फिर कभी नहीं बदलता।

आपके कोड से, यह इस तरह दिखता है:

एक टास्क बनाएं, फिर इसके समाप्त होने तक इसे पोल करें।

  1. रिक्वेस्ट: POST/image-to-3d

  2. रिस्पॉन्स: 202{ "result": "<task_id>" }टास्क बनाया गया

  3. हर कुछ सेकंड में दोहराएं

    1. रिक्वेस्ट: GET/image-to-3d/<task_id>

    2. रिस्पॉन्स: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5

  4. रिक्वेस्ट: GET/image-to-3d/<task_id>

  5. रिस्पॉन्स: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }

अगर आपका ऐप इंतज़ार करना बंद कर दे, तो टास्क चलता रहता है। इसे बाद में उसी टास्क ID से GET करें।

प्रोसेसिंग समय

निम्न तालिकाएं सितंबर 2026 में प्रोडक्शन API ट्रैफ़िक पर माध्य समय दिखाती हैं।

एक समय टास्क बनाए जाने से लेकर अंतिम स्टेटस तक चलता है। इसका लगभग सारा समय प्रोसेसिंग में जाता है, क्योंकि एक टास्क आमतौर पर PENDING में केवल कुछ सेकंड के लिए रहता है। जब कतार व्यस्त होती है, तो टास्क शुरू होने से पहले अधिक समय तक इंतज़ार कर सकते हैं, और उच्च प्राथमिकता वाले प्लान पर टास्क आमतौर पर जल्दी शुरू होते हैं।

2 मिनट से कम समय सेकंड (s) में हैं, और लंबे समय मिनट (min) में हैं। "समर्थित नहीं" का मतलब है कि API उस मॉडल के साथ वह विकल्प प्रदान नहीं करता।

ये सामान्य समय हैं, निश्चित पूर्णता समय नहीं। व्यस्त अवधि के दौरान, कुछ टास्क अधिक समय लेते हैं और फिर भी सफल होते हैं। Meshy की स्थिति जांचने के लिए, स्टेटस पेज देखें। इन समयों का उपयोग अपने कोड में timeout के रूप में न करें। timeout मानों के लिए, कितनी देर इंतज़ार करें देखें।

3D जनरेशन

APIकॉन्फ़िगरेशनmeshy-7.1 (latest)meshy-6meshy-6-litemeshy-t2
टेक्स्ट से 3D (Preview)केवल मेश75 s90 s45 s10 s
इमेज से 3Dकेवल मेश75 s90 s40 s4 s
2K टेक्सचर के साथ मेश2 min3 min75 s60 s
4K टेक्सचर के साथ मेश2.5 min3.5 minसमर्थित नहीं80 s
8K टेक्सचर के साथ मेश3.5 min4 minसमर्थित नहीं2.5 min
मल्टी-इमेज से 3Dकेवल मेश65 s2 min30 sसमर्थित नहीं
2K टेक्सचर के साथ मेश2.5 min3.5 min85 sसमर्थित नहीं
4K टेक्सचर के साथ मेश3 min4 minसमर्थित नहींसमर्थित नहीं
8K टेक्सचर के साथ मेश3.5 min4.5 minसमर्थित नहींसमर्थित नहीं

इमेज से 3D और मल्टी-इमेज से 3D के लिए, "केवल मेश" का मतलब है should_texture: false। ये विकल्प और इनपुट समय को बदलते हैं:

  • PBR मैप (enable_pbr) 30 से 60 सेकंड जोड़ते हैं।
  • Ultra ज्यामिति (geometry_resolution: "2k" या "4k") 1 मिनट तक जोड़ती है।
  • समान सेटिंग्स के साथ, अधिक जटिल इनपुट इमेज में अधिक समय लगता है।

टेक्सचरिंग

APIटेक्सचर रिज़ॉल्यूशनसामान्य समय
टेक्स्ट से 3D (Refine)2K या 4K80 s
8K3.5 min
रीटेक्सचर2K55 s
4K90 s
8K2.5 min

इमेज जनरेशन

APInano-banananano-banana-2nano-banana-proGPT Image मॉडल
टेक्स्ट से इमेज20 s15 s25 s20 से 35 s
इमेज से इमेज40 s20 s30 s20 से 40 s

Rigging और एनिमेशन

APIकॉन्फ़िगरेशनसामान्य समय
Auto-Riggingऑटोमैटिक rigging40 s
एनिमेशनप्रति रिक्वेस्ट15 s
टेक्स्ट से मोशनprime mode15 s
swift mode10 s

पोस्ट-प्रोसेसिंग

APIसामान्य समय
रीमेश2 min
UV अनरैप35 s
कन्वर्ट7 s
रीसाइज़15 s

3D प्रिंटिंग

APIकॉन्फ़िगरेशनसामान्य समय
प्रिंट-योग्यता विश्लेषणकेवल मेश जांच1 s
मेश और पतली-दीवार जांच10 s
मल्टी-कलरप्रति रिक्वेस्ट30 s
प्रिंट-योग्यता मरम्मतकेवल मेश मरम्मत10 s
पतली-दीवार जांच, दीवारें बरकरार20 s
पतली-दीवार जांच, दीवारें मोटी की गईं100 s
Auto Splitप्रति रिक्वेस्ट70 s

v2 पर, प्रिंट-योग्यता मरम्मत और प्रिंट-योग्यता विश्लेषण हमेशा पतली-दीवार जांच चलाते हैं। v1 पर, वे इसे तब चलाते हैं जब आप प्रिंटर प्रकार या प्रिंट साइज़ भेजते हैं।

कितनी देर इंतज़ार करें

टास्क चलता रहता है भले ही आपका कोड इंतज़ार करना बंद कर दे। अगर आपकी रिक्वेस्ट timeout हो जाती है, आपका कनेक्शन टूट जाता है, या आपकी स्ट्रीम बंद हो जाती है, तो टास्क फेल नहीं होता और कैंसल नहीं होता।

  • इंतज़ार करना बंद करने से पहले, टास्क के created_at से गिनते हुए कम से कम 60 मिनट इंतज़ार करें। अगर आप पहले रुक जाते हैं, तो हो सकता है आप एक ऐसे टास्क को चूक जाएं जो बाद में सफल होता है। यह ज़्यादातर व्यस्त अवधि के दौरान होता है।
  • टास्क ID रखें। आप किसी भी समय टास्क को फिर से प्राप्त कर सकते हैं। अगर यह 60 मिनट के बाद भी अंतिम नहीं है, तो इसे बाद में फिर से जांचें। अगर यह ऐसा ही बना रहता है, तो सपोर्ट से संपर्क करें।
  • केवल FAILED का मतलब है कि टास्क फेल हो गया। Meshy फेल हुए टास्क के लिए स्वतः ही क्रेडिट वापस कर देता है।

अपने कोड में इन मानों का उपयोग करें:

सेटिंगअनुशंसित मान
क्रिएट रिक्वेस्ट (POST) timeout60 सेकंड
100 MB से बड़ी model_url फ़ाइल के साथ क्रिएट रिक्वेस्ट (POST) timeout120 सेकंड। Meshy रिस्पॉन्स देने से पहले फ़ाइल को डाउनलोड करता है।
स्टेटस रिक्वेस्ट (GET) timeout30 सेकंड
पोल इंटरवलRetry-After हेडर, या अगर यह मौजूद नहीं है तो 5 सेकंड। पोल आपकी रेट लिमिट में गिने जाते हैं।
फेल हुई स्टेटस रिक्वेस्ट (timeout, 429, या 5xx)अगले पोल पर फिर से प्रयास करें। इसका मतलब यह नहीं है कि टास्क फेल हो गया।
प्रति टास्क कुल इंतज़ारcreated_at से कम से कम 60 मिनट। जब आप किसी स्ट्रीम को फिर से कनेक्ट करें तो इस गिनती को फिर से शुरू न करें।
स्ट्रीमएक स्ट्रीम टास्क के समाप्त होने से पहले बंद हो सकती है। अगर यह बिना किसी अंतिम स्टेटस के बंद हो जाती है, तो फिर से कनेक्ट करें या पोलिंग पर स्विच करें।

एक साथ कई टास्क के लिए, हर एक को पोल करने के बजाय webhooks का उपयोग करें। अगर किसी टास्क का अंतिम इवेंट उसके सामान्य समय के लगभग दोगुने के बाद भी नहीं आया है, तो टास्क को उसके GET एंडपॉइंट से प्राप्त करें।