lowpoly 30 अक्टू॰ 2026 को बंद हो जाएगा। 3D जनरेशन मॉडल के रूप में meshy-7 31 दिस॰ 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 फ़ाइलों को सीमित समय के लिए रखता है। देखें एसेट रिटेंशन।
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 ट्रैफ़िक पर माध्य (median) समय दिखाती हैं।

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

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

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 सेकंड जोड़ता है।
  • अल्ट्रा ज्यामिति (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
टेक्सचर किए गए पार्ट्स (keep_texture: true)170 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 एंडपॉइंट से टास्क प्राप्त करें।