एरर

जानें कि कोई अनुरोध या टास्क क्यों विफल हुआ, और आगे क्या करना है। एक अनुरोध तुरंत HTTP एरर के साथ विफल हो सकता है, और एक टास्क बाद में task_error के साथ विफल हो सकता है।

अनुरोध एरर

Meshy अनुरोध को अस्वीकार करते समय ये एरर तुरंत लौटाता है। क्या गलत हुआ, यह जानने के लिए HTTP स्टेटस कोड और message फ़ील्ड देखें।

रिस्पॉन्स फ़ॉर्मेट

एरर रिस्पॉन्स में एक message फ़ील्ड होती है जो बताती है कि क्या गलत हुआ:

Name
message
Type
string
Description
एरर का संक्षिप्त विवरण।

स्टेटस कोड

Name
2xx
Description
सफलता।
- Name
  200 - OK
  Description
  अनुरोध सफल रहा।
- Name
  202 - Accepted
  Description
  Meshy ने अनुरोध स्वीकार कर लिया है, और प्रोसेसिंग अभी पूरी नहीं हुई है। उदाहरण के लिए, एक ऐसा अनुरोध जो टास्क बनाता है वह 202 लौटाता है।
Name
4xx
Description
अनुरोध या आपके खाते में कुछ गड़बड़ है। हर स्टेटस बताता है कि क्या करना है।
- Name
  400 - Bad Request
  Description
  अनुरोध मान्य नहीं है, अक्सर इसलिए क्योंकि कोई आवश्यक पैरामीटर गायब है या कोई पैरामीटर गलत फ़ॉर्मेट में है।
- Name
  401 - Unauthorized
  Description
  API की गायब है, मान्य नहीं है, या इस एंडपॉइंट तक पहुँच नहीं सकती। देखें प्रमाणीकरण।
- Name
  402 - Payment Required
  Description
  API की के खाते में अनुरोध के लिए पर्याप्त क्रेडिट नहीं हैं। Free प्लान पर, टास्क बनाने वाले अधिकांश अनुरोध भी 402 लौटाते हैं।
- Name
  403 - Forbidden
  Description
  आपको यह अनुरोध करने की अनुमति नहीं है, उदाहरण के लिए इनमें से किसी कारण से:
  
  अनुरोध API की के IP allowlist से बाहर के किसी पते से आया।
  
  जब आपने टास्क की फ़ाइलें पढ़ीं, तो आपके संगठन की IP फ़िल्टरिंग ने उन्हें ब्लॉक कर दिया।
  
  एंडपॉइंट आपके प्लान पर उपलब्ध नहीं है।
  
  कंटेंट moderation ने इनपुट को ब्लॉक कर दिया। कुछ एंडपॉइंट इसके लिए 400 लौटाते हैं; हर एंडपॉइंट पेज अपने कोड सूचीबद्ध करता है।
  
  API की उस टीम सदस्य की है जो अब टीम में सक्रिय नहीं है।
  
  खाता प्रतिबंधित (banned) है।
- Name
  404 - Not Found
  Description
  संसाधन मौजूद नहीं है। उदाहरण के लिए, ऐसे ID वाला टास्क प्राप्त करना जो मौजूद ही नहीं है, 404 लौटाता है।
- Name
  409 - Conflict
  Description
  संसाधन मौजूद है, लेकिन इसकी स्थिति ऑपरेशन की अनुमति नहीं देती। उदाहरण के लिए, किसी IN_PROGRESS टास्क को डिलीट करने पर 409 लौटता है, क्योंकि Meshy ऐसे टास्क को रिफंड नहीं कर सकता जिसे किसी वर्कर ने शुरू कर दिया हो। टास्क चलता रहता है। अंतिम स्टेटस (SUCCEEDED, FAILED, या CANCELED) की प्रतीक्षा करें, फिर टास्क को डिलीट करें।
- Name
  422 - Unprocessable Entity
  Description
  अनुरोध मान्य है, लेकिन Meshy इसके इनपुट को प्रोसेस नहीं कर सकता। उदाहरण के लिए, Rigging 422 लौटाता है जब उसे मॉडल में कोई मानवाकार (humanoid) बॉडी नहीं मिलती।
- Name
  429 - Too Many Requests
  Description
  आपने बहुत अधिक अनुरोध भेज दिए हैं, या आपके बहुत सारे टास्क कतार में हैं या चल रहे हैं। जब रिस्पॉन्स में Retry-After हेडर हो, तो उतने सेकंड प्रतीक्षा करें, फिर पुनः प्रयास करें। देखें रेट लिमिट्स।
Name
5xx
Description
Meshy की ओर से कुछ गड़बड़ हुई है। बैकऑफ़ के साथ पुनः प्रयास करें। यदि एरर जारी रहे, तो स्टेटस पेज देखें और हमसे Discord पर संपर्क करें।

Example: 400 Bad Request

{
  "message": "Invalid model file extension: .3dm"
}

टास्क एरर

Meshy द्वारा बनाया गया टास्क चलते समय भी विफल हो सकता है। इसका status, FAILED हो जाता है, Meshy उसके क्रेडिट वापस कर देता है, और task_error यह बताता है कि ऐसा क्यों हुआ।

एक विफल टास्क के task_error में ये फ़ील्ड होते हैं:

Name
type
Type
string
Description
एरर की श्रेणी। यह किसी विफल टास्क में हमेशा मौजूद होती है। इसे फिर से कोशिश (retry) करनी है या नहीं, यह तय करने के लिए इस पर शाखा (branch) लें। देखें Error types।
Name
message
Type
string
Description
एरर का मानव-पठनीय विवरण। यह किसी विफल टास्क में हमेशा मौजूद होता है।
Name
code
Type
string
वैकल्पिक
Description
एक विशिष्ट, दस्तावेज़ीकृत समस्या जिस पर आप कार्रवाई कर सकते हैं। यह तब मौजूद होती है जब Meshy के पास अधिक विवरण हों। देखें Error codes। Meshy नए कोड जोड़ सकता है, इसलिए किसी अपरिचित कोड को उसके type के आधार पर संभालें।
Name
doc_url
Type
string
वैकल्पिक
Description
इस पेज पर उस कोड की प्रविष्टि का लिंक, जो बताता है कि क्या करना है। यह तब मौजूद होता है जब code मौजूद हो।

Error with details

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "status": "FAILED",
  "task_error": {
    "type": "invalid_input",
    "code": "image_too_complex",
    "message": "The uploaded image is too complex for 3D generation.",
    "doc_url": "https://docs.meshy.ai/en/api/errors#image-too-complex"
  }
}

Error without details

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "status": "FAILED",
  "task_error": {
    "type": "server_error",
    "message": "An internal error occurred. Please retry."
  }
}

एरर प्रकार

type विफलता की व्यापक श्रेणी है। अगले कदम के बारे में निर्णय लेने के लिए इसका उपयोग करें।

Name
invalid_input
Description
आपके द्वारा भेजे गए इनपुट में कुछ गड़बड़ है। code और message पढ़ें, इनपुट को ठीक करें, और एक नया टास्क बनाएं।
Name
timeout
Description
टास्क सर्वर-साइड समय सीमा से आगे चला गया, चाहे वह प्रोसेसिंग के लिए हो या कतार में प्रतीक्षा के लिए, और विफल हो गया। Meshy इसके क्रेडिट वापस कर देता है। यह अक्सर अस्थायी होता है। टास्क को फिर से बनाएं, और यदि यह लगातार विफल होता रहे, तो एक सरल इनपुट आज़माएं।
Name
service_unavailable
Description
सेवा अस्थायी रूप से अनुपलब्ध थी। कुछ समय प्रतीक्षा करें, फिर टास्क को फिर से बनाएं।
Name
server_error
Description
टास्क चलने के दौरान Meshy की ओर से कुछ गड़बड़ हो गई। टास्क को फिर से बनाएं। यदि यह लगातार विफल होता रहे, तो टास्क ID के साथ सहायता टीम से संपर्क करें।

एरर कोड

जब code मौजूद हो, तो यह निम्नलिखित समस्याओं में से किसी एक को दर्शाता है।

`image_too_complex`

इनपुट इमेज या prompt किसी ऐसे विषय का वर्णन करता है जो 3D जनरेशन के लिए ज्यामितीय रूप से बहुत जटिल है।

उदाहरण के लिए:

छोटी वस्तुओं के घने ढेर, जैसे फलों से भरी एक टोकरी या किताबों का ढेर
जटिल दोहराव वाले पैटर्न, जैसे जालीदार संरचनाएं, स्कैफोल्डिंग, या वायर मेश
जटिल इमारतें, जैसे कई खिड़कियों और बालकनी वाली बहुमंज़िला इमारतें
एक ही इमेज में कई अलग-अलग वस्तुएं, एक अकेले विषय के बजाय

ये इनपुट संभवतः बहुत जटिल हैं:

A building under construction with scaffolding

इसे ठीक करने के लिए, निम्नलिखित में से एक या अधिक तरीके आज़माएं:

प्रति इमेज एक वस्तु का उपयोग करें। Meshy एक स्पष्ट विषय के साथ सबसे अच्छा काम करता है, इसलिए एक ही इमेज या prompt में कई अलग-अलग वस्तुएं न रखें।
अपने विषय को सरल बनाएं। उदाहरण के लिए, दर्जनों फूलों से भरे फूलदान के बजाय एक साधारण फूलदान का उपयोग करें।
दृश्यों से बचें। पूरी इमारतें, शहर के ब्लॉक, सुसज्जित कमरे, और परिदृश्य संभवतः बहुत ज़्यादा होंगे। किसी एक वस्तु पर ध्यान केंद्रित करें।
घनी दोहराव वाली संरचनाओं से बचें। स्कैफोल्डिंग, वायर मेश, जालियां, और छोटी वस्तुओं के ढेर आम कारण हैं।

आपने enable_original_uv को true पर सेट करके टेक्सचरिंग के लिए एक मॉडल भेजा, लेकिन मॉडल में UV निर्देशांक नहीं हैं। UV निर्देशांक यह परिभाषित करते हैं कि एक 2D टेक्सचर 3D सतह पर कैसे लपेटा जाता है।

No UVs vs Good UVs

इसे ठीक करने के लिए, निम्नलिखित में से कोई एक करें:

अपने मॉडल के खुद के UV लेआउट को बनाए रखने के लिए, उदाहरण के लिए कस्टम सीम प्लेसमेंट के लिए, अपने 3D सॉफ़्टवेयर में मॉडल में UV जोड़ें। उन्हें इसके UV एडिटर में जाँचें, फिर मॉडल को दोबारा अपलोड करें। STL फ़ाइलें UV संग्रहीत नहीं कर सकतीं, इसलिए GLB, FBX, या OBJ का उपयोग करें।
यदि आपको अपने खुद के लेआउट की आवश्यकता नहीं है, या आप सुनिश्चित नहीं हैं, तो enable_original_uv को छोड़ दें या इसे false पर सेट करें। Meshy फिर मॉडल के लिए एक UV लेआउट बनाता है। नए UV मॉडल को अच्छी तरह कवर करते हैं, लेकिन आप यह नियंत्रित नहीं कर सकते कि टेक्सचर सीम कहाँ जाएँ।

`model_insufficient_uv`

मॉडल में UV निर्देशांक मौजूद हैं, लेकिन वे UV स्पेस के बहुत कम हिस्से को कवर करते हैं, जिससे अच्छी तरह टेक्सचर करना संभव नहीं होता। ऐसा अक्सर उन मॉडलों के साथ होता है जिनके एक्सपोर्टर ने उचित अनव्रैप किए बिना प्लेसहोल्डर या सिकुड़े हुए UV लिख दिए थे।

Insufficient UVs vs Good UVs

इसे ठीक करने के लिए, निम्नलिखित में से कोई एक करें:

अपना खुद का UV लेआउट बनाए रखने के लिए, अपने 3D सॉफ़्टवेयर में मॉडल के UV को फिर से अनव्रैप करें। आइलैंड्स को उसके एक छोटे से कोने में समेटने के बजाय पूरे UV स्पेस में फैलाएं।
अगर आपको अपने खुद के लेआउट की ज़रूरत नहीं है, तो enable_original_uv को छोड़ दें या इसे false पर सेट करें। इसके बाद Meshy एक नया UV लेआउट बनाता है। इससे आपकी सीम प्लेसमेंट खो जाती है, लेकिन नए UV टेक्सचर करने के लिए पर्याप्त जगह कवर करते हैं।

`model_missing_texture`

किसी Multi-Color Print कार्य के इनपुट मॉडल में ऐसा कोई रंग नहीं है जिसे Meshy प्रिंट रंगों में विभाजित कर सके। Meshy मॉडल के रंगों से एक मल्टी-कलर 3MF बनाता है, इसलिए एक सादे सफेद मेश के पास काम करने के लिए कुछ भी नहीं होता। उदाहरण के लिए, ऐसा टेक्स्ट से 3D या इमेज से 3D प्रीव्यू जिसे कभी टेक्सचर नहीं किया गया, उसमें कोई रंग नहीं होता। न ही प्रिंट-योग्यता मरम्मत के आउटपुट में, और न ही ऐसे Auto Split कार्य में जिसने टेक्सचर को बरकरार नहीं रखा।

क्या चीज़ रंग माना जाता है यह इस पर निर्भर करता है कि आपने कौन-सा style अनुरोध किया है:

realistic मॉडल के UV के माध्यम से बेस कलर टेक्सचर को सैंपल करता है। इसे एक सिंगल बेस कलर टेक्सचर, और हर मेश पार्ट पर UV की आवश्यकता होती है।
cartoon रंगों को प्रति फेस फ्लैट कर देता है। यह किसी भी पार्ट पर बेस कलर टेक्सचर, या प्रति-वर्टेक्स रंगों (COLOR_0) को स्वीकार करता है।

Meshy ऐसे मॉडल को दोनों स्टाइल के लिए अस्वीकार कर देता है जिसमें न तो बेस कलर टेक्सचर है और न ही वर्टेक्स रंग, बजाय इसके कि cartoon इसे सिंगल-कलर प्रिंट में बदल दे।

Meshy इनमें से ज़्यादातर अनुरोधों को कार्य बनाने से पहले ही 400 के साथ और उसी स्पष्टीकरण के साथ अस्वीकार कर देता है। आपको यह कोड आमतौर पर तभी मिलता है जब Meshy पहले से इनपुट की जांच नहीं कर सकता। उदाहरण के लिए, Meshy किसी .fbx अपलोड की जांच केवल तब करता है जब कार्य उसे कन्वर्ट कर चुका होता है।

इसे ठीक करने के लिए, अपने मॉडल के अनुकूल विकल्प का उपयोग करें:

पहले मॉडल को टेक्सचर करें। इस पर Retexture चलाएँ, या इसे टेक्स्ट से 3D refine कार्य के साथ, या should_texture: true के साथ इमेज से 3D कार्य के साथ जनरेट करें। फिर उस कार्य को input_task_id के रूप में भेजें।
वर्टेक्स-रंगीन मॉडल के लिए, जैसे कि फोटोग्रामेट्री स्कैन या हाथ से पेंट किया गया मेश, style: "cartoon" का उपयोग करें, जो COLOR_0 को पढ़ता है।
realistic के साथ आंशिक रूप से टेक्सचर किए गए या मल्टी-टेक्सचर मॉडल के लिए, हर मेश पार्ट को UV और एक ही सिंगल बेस कलर टेक्सचर दें। ऐसा करने के लिए, शेष पार्ट्स को टेक्सचर करें, या टेक्सचर को एक एटलस में मर्ज करें। आप style: "cartoon" पर भी स्विच कर सकते हैं।

`textured_split_refused`

keep_texture: true वाला एक Auto Split टास्क, इनपुट मॉडल के टेक्सचर को पार्ट्स पर बनाए नहीं रख सकता। उदाहरण के लिए, मॉडल में कोई UV नहीं है, या इसके टेक्सचर में कट्स से बनने वाले नए फेसेस के लिए जगह नहीं है। Meshy क्रेडिट वापस कर देता है।

इसे ठीक करने के लिए, keep_texture के बिना, या keep_texture: false के साथ अनुरोध दोबारा भेजें। इसके बाद पार्ट्स प्रत्येक के लिए एक फ्लैट रंग के साथ वापस आते हैं।

`invalid_input`

इनपुट एक जांच में विफल रहा, और कोई अधिक विशिष्ट कोड लागू नहीं होता। message कारण बताता है।

उदाहरण के लिए:

एक खाली या करप्ट मॉडल फ़ाइल
फ़ाइल फॉर्मेट का एक असमर्थित वेरिएंट, जैसे कि एक ASCII FBX फ़ाइल या एक meshopt-कंप्रेस्ड GLB फ़ाइल
ऐसा अपलोड किया गया मॉडल जिसमें कोई मान्य 3D ऑब्जेक्ट नहीं है, उदाहरण के लिए केवल आर्मेचर, कैमरा, या लाइट्स वाली फ़ाइल
ऐसी सामग्री जो सुरक्षा फ़िल्टर पास नहीं करती

इसे ठीक करने के लिए, विशिष्ट समस्या के लिए message पढ़ें। जांच लें कि आपकी इनपुट फ़ाइलें और पैरामीटर एंडपॉइंट की आवश्यकताओं को पूरा करते हैं।

`moderation_blocked`

सुरक्षा फ़िल्टर्स ने आपके prompt या रेफ़रेंस इमेज को अस्वीकार कर दिया। फ़िल्टर्स टेक्स्ट और इमेज दोनों को साथ में जाँचते हैं।

इसे ठीक करने के लिए, निम्न में से एक या दोनों काम करें:

प्रॉम्प्ट को फिर से लिखें ताकि उसमें से भड़काऊ या संवेदनशील विवरण हट जाएँ।
ऐसी रेफ़रेंस इमेज बदलें जिनमें ऐसी सामग्री दिखती हो जिसे फ़िल्टर्स ब्लॉक कर सकते हैं।

`moderation_unavailable`

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

इसे ठीक करने के लिए, टास्क को फिर से बनाएँ।

`timeout`

टास्क सर्वर-साइड समय सीमा से आगे निकल गया, चाहे वह प्रोसेसिंग के लिए हो या कतार में प्रतीक्षा करने के लिए, इसलिए Meshy ने इसे फेल कर दिया और इसके क्रेडिट वापस कर दिए। अधिक लोड, या ऐसा इनपुट जो समय पर पूरा होने के लिए बहुत जटिल हो, इसका कारण बन सकता है।

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

इसे ठीक करने के लिए, इन चरणों का पालन करें:

टास्क को फिर से बनाएं। Timeout अक्सर अस्थायी होते हैं, और एक नया टास्क सफल हो सकता है।
अगर यह बार-बार फेल होता रहे, तो अपना इनपुट सरल बनाएं, उदाहरण के लिए अपनी इमेज या prompt में डिटेल कम करके। उन इनपुट के लिए जिन्हें प्रोसेस करना अधिक कठिन है, देखें image_too_complex।

`queue_timeout`

टाइप: timeout। टास्क बिना शुरू हुए कतार में बहुत देर तक प्रतीक्षा करता रहा, इसलिए Meshy ने इसे FAILED कर दिया और इसके लिए चार्ज किए गए किसी भी क्रेडिट को वापस कर दिया। इस एरर का कारण आपका इनपुट नहीं था।

इसे ठीक करने के लिए, टास्क को फिर से बनाएं।

`format_conversion_failed`

Meshy ने मॉडल जनरेट कर दिया, लेकिन इसे आपके द्वारा अनुरोधित फॉर्मेट में कन्वर्ट करना विफल हो गया।

इसे ठीक करने के लिए, इन चरणों का पालन करें:

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

सर्वश्रेष्ठ प्रैक्टिस

विफल टास्क को रीट्राई करें। timeout, service_unavailable, या server_error वाले FAILED टास्क के लिए, एक्सपोनेंशियल बैकऑफ़ के साथ एक नया टास्क बनाएँ।
जब आपका अपना रिक्वेस्ट timeout हो जाए तो नया टास्क न बनाएँ। पहला टास्क अभी भी चल रहा हो सकता है, इसलिए दूसरा बनाने से पहले यह जाँच लें कि वह मौजूद है या नहीं। देखें कितनी देर प्रतीक्षा करें।
टास्क IDs लॉग करें। सपोर्ट से संपर्क करते समय ID शामिल करें।
इनपुट्स को भेजने से पहले जाँच लें। सुनिश्चित करें कि इमेज और मॉडल एंडपॉइंट की फ़ॉर्मेट आवश्यकताओं को पूरा करते हैं।
API को अपने सर्वर से कॉल करें। ब्राउज़र में चलने वाला कोड आपकी API की को किसी भी व्यक्ति के सामने उजागर कर देता है जो पेज खोलता है।