मल्टी-इमेज से 3D API

एक ही वस्तु की अलग-अलग कोणों से ली गई एक से चार इमेज से 3D मॉडल जनरेट करें।

POST/openapi/v1/multi-image-to-3d

मल्टी-इमेज से 3D टास्क बनाएं

एक मल्टी-इमेज से 3D टास्क बनाता है। टास्क बैकग्राउंड में चलता है। आमतौर पर किसी टास्क में कितना समय लगता है, यह जानने के लिए Processing times देखें। टास्क में कौन-कौन से फ़ील्ड होते हैं, यह जानने के लिए मल्टी-इमेज से 3D टास्क ऑब्जेक्ट देखें।

Request

POST

/openapi/v1/multi-image-to-3d

# Simple request
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ]
  }'

# With Ultra 2K geometry, PBR texturing, and GLB format
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ],
    "ai_model": "meshy-7.1",
    "geometry_resolution": "2k",
    "should_texture": true,
    "enable_pbr": true,
    "target_formats": ["glb"]
  }'

# Textured with Meshy N1 from the input images, the first as the front view
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your front view image url or base64-encoded data URI>",
      "<your back view image url or base64-encoded data URI>"
    ],
    "ai_model": "meshy-7.1",
    "texture_model": "meshy-n1"
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

पैरामीटर

Name
input_task_id
Type
string
आवश्यक
Description
यह आवश्यक है जब तक आप image_urls न भेजें। टेक्स्ट से इमेज या इमेज से इमेज टास्क की ID, जिसमें मल्टी-व्यू टास्क भी शामिल है। Meshy इनपुट के रूप में इसकी एक से चार इमेज का उपयोग करता है। यह टास्क वही होना चाहिए जिसे आपने API से बनाया हो और जिसका स्टेटस SUCCEEDED हो।

Name
image_urls
Type
array
आवश्यक
Description
यह आवश्यक है जब तक आप input_task_id न भेजें। एक से चार इमेज, प्रत्येक एक सार्वजनिक URL या Data URI के रूप में, जैसे data:image/jpeg;base64,<your base64-encoded image data>। यदि आप दोनों भेजते हैं, तो Meshy input_task_id का उपयोग करता है।
प्रत्येक इमेज एक .jpg, .jpeg, .png, या .webp फ़ाइल होनी चाहिए, जो अधिकतम 20 MB की हो, प्रत्येक दिशा में कम से कम 32 पिक्सेल की हो, और अधिकतम 178,956,970 पिक्सेल (चौड़ाई × ऊँचाई) की हो। चार से अधिक इमेज भेजने पर 400 रिटर्न होता है।
सर्वोत्तम परिणामों के लिए, इमेज में एक ही ऑब्जेक्ट को अलग-अलग कोणों से दिखाया जाना चाहिए। meshy-7.1 या latest के साथ, Meshy पहली इमेज को फ्रंट व्यू के रूप में उपयोग करता है, और बाकी का क्रम कोई मायने नहीं रखता।

Name
ai_model
Type
string
डिफ़ॉल्ट latest
Description
वह AI मॉडल जो 3D मॉडल जनरेट करता है।
उपलब्ध वैल्यू:
- latest: Meshy 7.1
- meshy-7.1
- meshy-6
- meshy-6-lite
- meshy-7: डेप्रिकेटेड, इसके बजाय meshy-7.1 भेजें
Name
geometry_resolution
Type
string
डिफ़ॉल्ट standard
Description
कितना ज्यामिति डिटेल जनरेट करना है।
उपलब्ध वैल्यू:
- standard
- 2k: Ultra पास को 2048³ पर चलाता है। इसके लिए meshy-7.1, latest, या डेप्रिकेटेड meshy-7 आवश्यक है।
Name
ultra_mode
Type
boolean
⚠ पुराना
डिफ़ॉल्ट false
Description
इसके बजाय geometry_resolution भेजें। ultra_mode: true, geometry_resolution: "2k" के समान ही है।
Name
should_texture
Type
boolean
डिफ़ॉल्ट true
Description
टेक्सचर जनरेट करना है या नहीं। true एक टेक्सचर्ड मॉडल रिटर्न करता है, और false टेक्सचर स्टेप को छोड़कर बिना टेक्सचर वाला मेश रिटर्न करता है।

केवल तब लागू होता है जब should_texture = true

Name
texture_model
Type
string
डिफ़ॉल्ट depends on ai_model
Description
वह AI मॉडल जो उसी टास्क में कई व्यू से 3D मॉडल को टेक्सचर करता है। इसे छोड़ देने पर आपके ai_model के लिए डिफ़ॉल्ट टेक्सचर मॉडल उपयोग होता है। इससे क्रेडिट लागत नहीं बदलती।
उपलब्ध वैल्यू:
- meshy-7: Meshy 7, PBR मैप और 8K तक के टेक्सचर के साथ
- meshy-n1: Meshy N1, केवल रेफरेंस इमेज से 2K बेस कलर टेक्सचर
हर ai_model दोनों को स्वीकार करता है। meshy-6 या meshy-6-lite के साथ टेक्सचर्ड रिक्वेस्ट 400 रिटर्न करती है, और ऐसा ही किसी ऐसे ऑप्शन के साथ होता है जिसे चुना गया टेक्सचर मॉडल सपोर्ट नहीं करता। should_texture: false के साथ, Meshy texture_model को नज़रअंदाज़ करता है, लेकिन कोई अज्ञात वैल्यू फिर भी 400 रिटर्न करती है।
meshy-n1 के साथ, Meshy texture_image_urls या texture_image_url से, या जब आप दोनों में से कोई न भेजें तो इनपुट इमेज से टेक्सचर करता है। पहली इमेज फ्रंट व्यू होती है। 7,999,999 ट्राइएंगल से अधिक का जनरेट किया गया मॉडल टास्क को फेल करता है, और Meshy उसके क्रेडिट रिफंड कर देता है।
प्रत्येक टेक्सचर मॉडल क्या करता है और किसे चुनना चाहिए, यह जानने के लिए मॉडल देखें।
Name
enable_pbr
Type
boolean
डिफ़ॉल्ट false
Description
बेस कलर के अलावा मेटैलिक, रफनेस, और नॉर्मल मैप भी जनरेट करना है या नहीं। Meshy 6 टेक्सचर मॉडल एक इमिशन मैप भी जनरेट करता है, सिवाय texture_resolution: 8k पर। texture_model: meshy-n1 के साथ, true 400 रिटर्न करता है।
Name
texture_resolution
Type
string
डिफ़ॉल्ट 2k
Description
बेस कलर टेक्सचर का आकार। बड़ा आकार अधिक सतह विवरण कैप्चर करता है।
उपलब्ध वैल्यू:
- 2k: 2048×2048
- 4k: 4096×4096
- 8k: 8192×8192
4k और 8k के लिए Meshy 7 या Meshy 6 टेक्सचर मॉडल आवश्यक है, और अन्य के साथ 400 रिटर्न करता है। 8k पर, Meshy इमिशन मैप जनरेट नहीं करता।
Name
hd_texture
Type
boolean
⚠ पुराना
डिफ़ॉल्ट false
Description
इसके बजाय texture_resolution भेजें। hd_texture: true, texture_resolution: "4k" के समान ही है। यदि आप दोनों भेजते हैं, तो Meshy texture_resolution का उपयोग करता है।
Name
texture_prompt
Type
string
Description
टेक्सचर को निर्देशित करने वाला टेक्स्ट, अधिकतम 800 अक्षर। इससे लंबा टेक्स्ट 400 रिटर्न करता है। texture_model: meshy-n1 के साथ, इसे भेजने पर 400 रिटर्न होता है।
Name
texture_image_url
Type
string
Description
टेक्सचर को निर्देशित करने वाली एक 2D इमेज, जो एक सार्वजनिक URL या Data URI के रूप में हो, जैसे data:image/jpeg;base64,<your base64-encoded image data>। इमेज एक .jpg, .jpeg, .png, या .webp फ़ाइल होनी चाहिए, जो अधिकतम 20 MB की हो, प्रत्येक दिशा में कम से कम 32 पिक्सेल की हो, और अधिकतम 178,956,970 पिक्सेल (चौड़ाई × ऊँचाई) की हो।
यदि आप texture_image_url और texture_prompt दोनों भेजते हैं, तो Meshy texture_prompt का उपयोग करता है। texture_model: meshy-n1 के साथ, Meshy इस इमेज को फ्रंट व्यू के रूप में उपयोग करके टेक्सचर करता है।
जब इमेज में आकार 3D मॉडल से बहुत अलग हो, तो टेक्सचर अच्छी तरह से नहीं निकल सकता है।
Name
texture_image_urls
Type
string[]
Description
अलग-अलग व्यू से ऑब्जेक्ट की एक से चार इमेज जो टेक्सचर को निर्देशित करती हैं। Meshy पहली इमेज को फ्रंट व्यू के रूप में उपयोग करता है। अन्य व्यू (लेफ्ट, बैक, राइट) का क्रम कोई मायने नहीं रखता।
प्रत्येक इमेज texture_image_url जैसे ही नियमों का पालन करती है। यह एक सार्वजनिक URL या Data URI है, .jpg, .jpeg, .png, या .webp फ़ॉर्मेट में, अधिकतम 20 MB की, प्रत्येक दिशा में कम से कम 32 पिक्सेल की, और अधिकतम 178,956,970 पिक्सेल (चौड़ाई × ऊँचाई) की।
ये इमेज केवल टेक्सचर को निर्देशित करती हैं और image_urls पर निर्भर नहीं करतीं। दोनों लिस्ट में अलग-अलग इमेज और इमेज की अलग-अलग संख्या हो सकती है।
texture_image_urls के लिए Meshy 7 या Meshy N1 टेक्सचर मॉडल आवश्यक है। इसे इनमें से किसी एक के साथ भेजें:
- meshy-7.1, latest, या डेप्रिकेटेड meshy-7 का ai_model
- meshy-7 या meshy-n1 का texture_model
आप इसे texture_image_url या texture_prompt के साथ नहीं भेज सकते।

Name
should_remesh
Type
boolean
डिफ़ॉल्ट true (meshy-6-lite), false (other models)
Description
जनरेशन के बाद मॉडल को रीमेश करना है या नहीं। सबसे उच्च गुणवत्ता वाले 3D मॉडल के लिए, इसे false सेट करें।

केवल तब लागू होता है जब should_remesh = true

Name
topology
Type
string
डिफ़ॉल्ट triangle
Description
रीमेश किए गए मॉडल का फेस टाइप।
उपलब्ध वैल्यू:
- quad: एक क्वाड-प्रधान मेश
- triangle: एक डेसिमेटेड ट्राइएंगल मेश
texture_model: meshy-n1 के साथ, जब मॉडल रीमेश किया जाता है तो quad 400 रिटर्न करता है, जो meshy-6-lite डिफ़ॉल्ट रूप से करता है।
Name
target_polycount
Type
integer
डिफ़ॉल्ट 30000
Description
लक्षित फेस की संख्या, 100 से 300000 तक। मॉडल की ज्यामिति के आधार पर परिणाम लक्ष्य से भिन्न हो सकता है। इस रेंज के बाहर की वैल्यू 400 रिटर्न करती है।
Name
decimation_mode
Type
integer
Description
लेवल के अनुसार एडैप्टिव फेस काउंट। इसे सेट करने पर, Meshy target_polycount को नज़रअंदाज़ करता है।
उपलब्ध वैल्यू:
- 1: ultra
- 2: high
- 3: medium
- 4: low
Name
save_pre_remeshed_model
Type
boolean
डिफ़ॉल्ट false
Description
रीमेश से पहले का GLB भी सेव करना है या नहीं, जो model_urls.pre_remeshed_glb में रिटर्न होता है।

Name
symmetry_mode
Type
string
⚠ पुराना
डिफ़ॉल्ट auto
Description
इसे छोड़ दें। इसका आउटपुट पर कोई असर नहीं पड़ता।
उपलब्ध वैल्यू:
- off: कोई सममिति नहीं
- auto: इनपुट ज्यामिति के आधार पर सममिति
- on: लागू की गई सममिति
Name
pose_mode
Type
string
डिफ़ॉल्ट ""
Description
जनरेट किए गए मॉडल की पोज़।
उपलब्ध वैल्यू:
- a-pose: एक A पोज़
- t-pose: एक T पोज़
- "" (खाली स्ट्रिंग): कोई विशेष पोज़ नहीं
Name
is_a_t_pose
Type
boolean
⚠ पुराना
डिफ़ॉल्ट false
Description
इसके बजाय pose_mode भेजें। मॉडल को A या T पोज़ में जनरेट करना है या नहीं।
Name
image_enhancement
Type
boolean
डिफ़ॉल्ट true
Description
जनरेट करने से पहले इनपुट इमेज को ऑप्टिमाइज़ करना है या नहीं। false इनपुट इमेज का बिल्कुल वैसा ही रूप बनाए रखता है, बिना किसी स्टाइल प्रोसेसिंग के। यह केवल meshy-6, meshy-7.1, या latest के साथ सपोर्ट होता है। इसे meshy-6-lite के साथ भेजने पर 400 रिटर्न होता है।
Name
remove_lighting
Type
boolean
डिफ़ॉल्ट true
Description
बेस कलर टेक्सचर से हाइलाइट्स और शैडो हटाना है या नहीं। क्लीनर परिणाम आपकी अपनी लाइटिंग के तहत बेहतर काम करता है। केवल Meshy 6 टेक्सचर मॉडल इसका उपयोग करता है, और texture_resolution: 8k पर यह हमेशा लाइटिंग हटाता है। texture_model: meshy-n1 के साथ, true 400 रिटर्न करता है। ai_model: meshy-6-lite और इसके डिफ़ॉल्ट टेक्सचर मॉडल के साथ, इसे भेजने पर 400 रिटर्न होता है।
Name
moderation
Type
boolean
डिफ़ॉल्ट false
Description
हानिकारक कंटेंट के लिए इनपुट को जांचना है या नहीं। Meshy प्रत्येक इनपुट इमेज, texture_image_url या texture_image_urls में प्रत्येक इमेज, और texture_prompt में टेक्स्ट को जांचता है। यदि Meshy को हानिकारक कंटेंट मिलता है, तो रिक्वेस्ट 400 रिटर्न करती है और Meshy कोई टास्क नहीं बनाता।
Name
target_formats
Type
string[]
Description
जनरेट किए जाने वाले 3D फ़ाइल फ़ॉर्मेट। Meshy केवल आपके द्वारा लिस्ट किए गए फ़ॉर्मेट जनरेट करता है और रिटर्न करता है, जिससे टास्क छोटा हो सकता है।
उपलब्ध वैल्यू:
- glb
- obj
- fbx
- stl
- usdz
- 3mf
यदि आप इसे छोड़ देते हैं, तो Meshy 3mf को छोड़कर हर फ़ॉर्मेट जनरेट करता है। Meshy 3mf केवल तभी जनरेट करता है जब आप उसे लिस्ट करते हैं।
Name
auto_size
Type
boolean
डिफ़ॉल्ट false
Description
AI विज़न से ऑब्जेक्ट की वास्तविक दुनिया की ऊँचाई का अनुमान लगाना है और मॉडल को उसके अनुसार रीसाइज़ करना है या नहीं। जब तक आप origin_at सेट न करें, Meshy ओरिजिन को नीचे रखता है।

केवल तब लागू होता है जब auto_size = true

Name
origin_at
Type
string
डिफ़ॉल्ट bottom
Description
मॉडल का ओरिजिन कहाँ रखना है, bottom या center।

Name
alpha_thumbnail
Type
boolean
डिफ़ॉल्ट false
Description
पारदर्शी बैकग्राउंड (RGBA) के साथ एक प्रिव्यू भी रेंडर करना है या नहीं, जो टास्क प्राप्त करते समय alpha_thumbnail_url में रिटर्न होता है। thumbnail_url नहीं बदलता।
Name
multi_view_thumbnails
Type
boolean
डिफ़ॉल्ट false
Description
फ्रंट, राइट, बैक, और लेफ्ट प्रिव्यू भी रेंडर करना है या नहीं, जो टास्क प्राप्त करते समय thumbnail_urls में रिटर्न होते हैं। thumbnail_url नहीं बदलता और अभी भी फ्रंट व्यू दिखाता है। इससे टास्क में लगभग 5 सेकंड जुड़ जाते हैं।

रिटर्न

रिस्पॉन्स के result फ़ील्ड में नए मल्टी-इमेज से 3D टास्क की ID होती है।

फेल्योर मोड

Name
400 - Bad Request
Description
रिक्वेस्ट नहीं चल सकती। एरर मैसेज में बताया जाता है कि कौन सी समस्या मिली। उदाहरण के लिए:
- मिसिंग पैरामीटर: न तो image_urls और न ही input_task_id भेजा गया।
- अमान्य इनपुट टास्क: input_task_id कोई SUCCEEDED टेक्स्ट से इमेज या इमेज से इमेज टास्क नहीं है, या कोई मल्टी-व्यू टास्क नहीं है।
- अमान्य इमेज काउंट: image_urls या texture_image_urls में 1 से 4 इमेज नहीं हैं।
- अमान्य इमेज फ़ॉर्मेट: image_urls में कोई इमेज सपोर्टेड फ़ॉर्मेट में नहीं है।
- टकराव वाले टेक्सचर इनपुट: texture_image_urls को texture_image_url, texture_prompt, या should_texture: false के साथ भेजा गया।
- मल्टी-व्यू टेक्सचर के लिए असमर्थित मॉडल: texture_image_urls को meshy-6 या meshy-6-lite के ai_model के साथ भेजा गया, जब तक texture_model, meshy-7 या meshy-n1 न हो।
- अनरीचेबल URL: Meshy, image_urls या texture_image_urls में कोई इमेज डाउनलोड नहीं कर सकता।
- इमेज बहुत बड़ी है: image_urls, texture_image_url, या texture_image_urls में कोई इमेज 20 MB से अधिक की है।
- अमान्य इमेज साइज़: image_urls, texture_image_url, या texture_image_urls में किसी इमेज की साइड 32 पिक्सेल से छोटी है, या 178,956,970 पिक्सेल (चौड़ाई × ऊँचाई) से अधिक है।
- मल्टी-इमेज इनपुट के लिए असमर्थित रिज़ॉल्यूशन: geometry_resolution, "4k" है, जिसे यह एंडपॉइंट सपोर्ट नहीं करता। 2k या standard का उपयोग करें।
- इमेज ऑप्शन के लिए असमर्थित मॉडल: image_enhancement, ai_model: "meshy-6-lite" के साथ भेजा गया, या remove_lighting, ai_model: "meshy-6-lite" और इसके डिफ़ॉल्ट टेक्सचर मॉडल के साथ भेजा गया।
- अमान्य टेक्सचर मॉडल: texture_model कोई मान्य टेक्सचर मॉडल नाम नहीं है।
- टेक्सचर मॉडल उपलब्ध नहीं है: एक टेक्सचर्ड रिक्वेस्ट ने meshy-6 या meshy-6-lite का texture_model भेजा। मल्टी-इमेज से 3D केवल उन्हीं टेक्सचर मॉडलों को स्वीकार करता है जो कई व्यू से टेक्सचर करते हैं। meshy-7 या meshy-n1 भेजें, या texture_model को छोड़ दें।
- टेक्सचर मॉडल के लिए असमर्थित ऑप्शन: रिक्वेस्ट टेक्सचर मॉडल से ऐसा ऑप्शन मांगती है जिसे वह सपोर्ट नहीं करता, जैसे meshy-n1 के साथ enable_pbr: true या meshy-6-lite के साथ 4k टेक्सचर। मॉडल देखें।
रिक्वेस्ट को ठीक करें, फिर इसे फिर से भेजें। एरर देखें।
Name
401 - Unauthorized
Description
API की मौजूद नहीं है या अमान्य है। Authorization हेडर जांचें।
Name
402 - Payment Required
Description
उदाहरण के लिए:
- अपर्याप्त क्रेडिट: अकाउंट के पास इस टास्क के लिए पर्याप्त क्रेडिट नहीं हैं, या अकाउंट ने क्रेडिट लिमिट तक पहुंच गया है। अपना क्रेडिट बैलेंस जांचें, फिर पुनः प्रयास करें।
- फ्री प्लान: टास्क बनाने के लिए पेड प्लान आवश्यक है। अपने सब्सक्रिप्शन सेटिंग्स में अपना प्लान अपग्रेड करें, फिर पुनः प्रयास करें।
Name
403 - Forbidden
Description
कंटेंट मॉडरेशन ने prompt या किसी इनपुट इमेज को ब्लॉक कर दिया। इनपुट बदलें, फिर पुनः प्रयास करें।
Name
404 - Not Found
Description
input_task_id आपके किसी भी टास्क से मेल नहीं खाता। टास्क ID जांचें, फिर रिक्वेस्ट फिर से भेजें।
Name
429 - Too Many Requests
Description
आपने अपनी रेट लिमिट पार कर ली है। प्रतीक्षा करें, फिर पुनः प्रयास करें। रेट लिमिट देखें।

GET/openapi/v1/multi-image-to-3d/:id

मल्टी-इमेज से 3D टास्क प्राप्त करें

यह किसी मल्टी-इमेज से 3D टास्क को उसकी ID के ज़रिए लौटाता है।

Request

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": null,

  "consumed_credits": 30
}

पैरामीटर

Name
id
Type
path
Description
क्रिएट रिस्पॉन्स से प्राप्त टास्क ID।

रिटर्न वैल्यू

मल्टी-इमेज से 3D टास्क ऑब्जेक्ट।

DELETE/openapi/v1/multi-image-to-3d/:id

मल्टी-इमेज से 3D टास्क को डिलीट करें

किसी मल्टी-इमेज से 3D टास्क को उसके मॉडल्स और डेटा सहित स्थायी रूप से डिलीट करता है। आप डिलीट को अनडू नहीं कर सकते।

Request

DELETE

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

Path parameters

Name
id
Type
path
Description
डिलीट करने वाले टास्क की ID।

टास्क स्टेटस

किसी PENDING टास्क को डिलीट करने पर, इसे बनाते समय उपयोग किए गए क्रेडिट वापस कर दिए जाते हैं।

किसी IN_PROGRESS टास्क को डिलीट नहीं किया जा सकता। रिक्वेस्ट 409 Conflict रिटर्न करती है, और टास्क चलता रहता है। Meshy शुरू हो चुके टास्क को रिफंड नहीं करता, इसलिए इसे डिलीट करने पर आपको क्रेडिट और रिजल्ट दोनों का नुकसान होगा। इसके SUCCEEDED, FAILED, या CANCELED होने की प्रतीक्षा करें, फिर उसे डिलीट करें।

किसी फाइनल स्टेटस (SUCCEEDED, FAILED, या CANCELED) वाले टास्क को डिलीट करने पर इसके क्रेडिट वापस नहीं किए जाते।

Returns

टास्क के डिलीट होने पर 200 OK, या टास्क के IN_PROGRESS होने पर 409 Conflict।

GET/openapi/v1/multi-image-to-3d

मल्टी-इमेज से 3D टास्क की सूची

आपके मल्टी-इमेज से 3D टास्क की सूची लौटाता है।

Request

GET

/openapi/v1/multi-image-to-3d

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "multi-image-to-3d",
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
      "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
      "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "thumbnail_urls": {
      "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
      "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
      "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
      "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
    },
    "texture_prompt": "",
    "progress": 100,
    "started_at": 1692771667037,
    "created_at": 1692771650657,
    "expires_at": 1692771679037,
    "finished_at": 1692771669037,
    "status": "SUCCEEDED",
    "texture_urls": [
      {
        "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
        "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
        "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
        "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
      }
    ],
    "preceding_tasks": 0,
    "task_error": null,

    "consumed_credits": 30
  }
]

पैरामीटर

Name
page_num
Type
integer
डिफ़ॉल्ट 1
Description
लौटाया जाने वाला पेज नंबर, अधिकतम 255 तक। इससे बड़ा मान 400 लौटाता है।
Name
page_size
Type
integer
डिफ़ॉल्ट 10
Description
प्रति पेज टास्क की संख्या, अधिकतम 100 तक।
Name
sort_by
Type
string
Description
सॉर्ट ऑर्डर।
उपलब्ध मान:
- +created_at: सबसे पुराना पहले
- -created_at: सबसे नया पहले

रिटर्न

मल्टी-इमेज से 3D टास्क ऑब्जेक्ट्स की एक पेजिनेटेड सूची।

GET/openapi/v1/multi-image-to-3d/:id/stream

मल्टी-इमेज से 3D टास्क को स्ट्रीम करें

मल्टी-इमेज से 3D टास्क के अपडेट्स को Server-Sent Events (SSE) के रूप में स्ट्रीम करता है।

Request

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// These examples are shortened. Each event holds the full task object.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
  "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
  "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
  "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
  "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
  "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
  "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
  "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
  "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
  "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
  "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": null,

  "consumed_credits": 30
}

पैरामीटर

Name
id
Type
path
Description
क्रिएट रिस्पॉन्स से मिला टास्क ID।

रिटर्न

मल्टी-इमेज से 3D टास्क ऑब्जेक्ट्स की एक स्ट्रीम Server-Sent Events के रूप में।

हर इवेंट में पूरा टास्क ऑब्जेक्ट होता है, उसी फॉर्मेट में जो Get एंडपॉइंट रिटर्न करता है। जब तक टास्क PENDING या IN_PROGRESS स्थिति में है, तब तक इसके रिजल्ट फील्ड्स में अभी कोई वैल्यू नहीं होती।

मल्टी-इमेज से 3D टास्क ऑब्जेक्ट

एक मल्टी-इमेज से 3D टास्क ऑब्जेक्ट किसी ऑब्जेक्ट की एक से चार इमेज से 3D मॉडल के एक जनरेशन का वर्णन करता है। यह स्टेटस, progress, और टास्क सफल होने पर मॉडल फ़ाइलों को रखता है।

Properties

Example Multi-Image to 3D Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": null,

  "consumed_credits": 30
}

Name
id
Type
string
Description
टास्क ID। इसे एक ऑपेक स्ट्रिंग मानें, और इसके फॉर्मेट पर निर्भर न रहें।
Name
type
Type
string
Description
टास्क टाइप, हमेशा multi-image-to-3d।
Name
model_urls
Type
object
Description
जनरेट किए गए 3D मॉडल के लिए डाउनलोड URL, प्रत्येक फ़ाइल फॉर्मेट के लिए एक। जिस फॉर्मेट को टास्क ने जनरेट नहीं किया, उसकी कोई key नहीं होती, खाली स्ट्रिंग के बजाय।
- Name
  glb
  Type
  string
  Description
  GLB फ़ाइल।
- Name
  fbx
  Type
  string
  Description
  FBX फ़ाइल।
- Name
  obj
  Type
  string
  Description
  OBJ फ़ाइल।
- Name
  usdz
  Type
  string
  Description
  USDZ फ़ाइल।
- Name
  mtl
  Type
  string
  Description
  MTL फ़ाइल, जब मॉडल में टेक्सचर होते हैं तो OBJ फ़ाइल के साथ दी जाती है।
- Name
  stl
  Type
  string
  Description
  STL फ़ाइल।
- Name
  3mf
  Type
  string
  Description
  3MF फ़ाइल। केवल तब मौजूद होती है जब target_formats में 3mf शामिल हो।
- Name
  pre_remeshed_glb
  Type
  string
  Description
  रीमेश से पहले की GLB फ़ाइल। केवल तब मौजूद होती है जब आपने टास्क should_remesh: true और save_pre_remeshed_model: true दोनों के साथ बनाया हो।
Name
thumbnail_url
Type
string
Description
मॉडल की प्रीव्यू इमेज के लिए डाउनलोड URL। जब thumbnail_urls.front फ़ील्ड मौजूद हो, तो यह उसके समान होता है।
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url के पारदर्शी बैकग्राउंड (RGBA) वाले वर्शन के लिए डाउनलोड URL। केवल तब मौजूद होता है जब आपने टास्क alpha_thumbnail: true के साथ बनाया हो और Meshy ने पारदर्शी प्रीव्यू रेंडर किया हो।
Name
thumbnail_urls
Type
object
Description
4D मॉडल के चार दिशाओं से प्रीव्यू के लिए डाउनलोड URL। प्रत्येक एक 512×512 PNG के लिए साइन किया हुआ URL है, जिसे thumbnail_url के समान मटेरियल और लाइटिंग के साथ रेंडर किया गया है। आप GLB डाउनलोड किए बिना मॉडल को कई कोणों से प्रीव्यू करने के लिए इनका उपयोग कर सकते हैं।
केवल तब मौजूद होता है जब आपने टास्क multi_view_thumbnails: true के साथ बनाया हो और टास्क SUCCEEDED तक पहुँच गया हो। बिना multi_view_thumbnails: true के बनाए गए टास्क में यह फ़ील्ड नहीं होती।
- Name
  front
  Type
  string
  Description
  फ्रंट व्यू, वर्टिकल अक्ष के चारों ओर 0° पर। यह thumbnail_url से मेल खाता है।
- Name
  right
  Type
  string
  Description
  राइट व्यू, 90° पर।
- Name
  back
  Type
  string
  Description
  बैक व्यू, 180° पर।
- Name
  left
  Type
  string
  Description
  लेफ्ट व्यू, 270° पर।
Name
texture_prompt
Type
string
Description
वह टेक्स्ट prompt जिसने टेक्सचर का मार्गदर्शन किया।
Name
texture_image_urls
Type
string[]
Description
आपके द्वारा टास्क बनाने में इस्तेमाल की गई टेक्सचर रेफरेंस इमेज के लिए डाउनलोड URL, जिस क्रम में आपने उन्हें भेजा था। केवल तब मौजूद होता है जब आपने टास्क texture_image_urls के साथ बनाया हो।
Name
ultra_mode
Type
boolean
⚠ पुराना
Description
इसके बजाय geometry_resolution पढ़ें।
Name
geometry_resolution
Type
string
Description
जिस Ultra टियर पर टास्क चला, जो 2k है। standard टास्क में यह फ़ील्ड नहीं होती।
Name
progress
Type
integer
Description
टास्क का कितना हिस्सा पूरा हो चुका है, प्रतिशत के रूप में। यह तब तक 0 रहता है जब तक टास्क शुरू नहीं होता और सफल होने पर 100 हो जाता है।
Name
started_at
Type
timestamp
Description
टास्क शुरू होने का समय, Unix मिलीसेकंड में। यह तब तक 0 रहता है जब तक टास्क शुरू नहीं होता।
Name
created_at
Type
timestamp
Description
टास्क बनाए जाने का समय, Unix मिलीसेकंड में।
Name
expires_at
Type
timestamp
Description
वह समय जब टास्क के रिज़ल्ट एक्सपायर होते हैं, Unix मिलीसेकंड में।
Name
finished_at
Type
timestamp
Description
टास्क पूरा होने का समय, Unix मिलीसेकंड में। यह तब तक 0 रहता है जब तक टास्क पूरा नहीं होता।
Name
status
Type
string
Description
टास्क स्टेटस, इनमें से एक: PENDING, IN_PROGRESS, SUCCEEDED, FAILED, या CANCELED।
Name
texture_urls
Type
array
Description
टास्क द्वारा जनरेट किए गए टेक्सचर मैप के लिए डाउनलोड URL, ऑब्जेक्ट्स की एक array के रूप में। इसमें आमतौर पर एक ऑब्जेक्ट होता है। प्रत्येक ऑब्जेक्ट में ये फ़ील्ड होते हैं:
- Name
  base_color
  Type
  string
  Description
  बेस कलर मैप।
- Name
  metallic
  Type
  string
  Description
  मेटैलिक मैप। जब आपने टास्क enable_pbr: false के साथ बनाया हो, तो शामिल नहीं होता।
- Name
  normal
  Type
  string
  Description
  नॉर्मल मैप। जब आपने टास्क enable_pbr: false के साथ बनाया हो, तो शामिल नहीं होता।
- Name
  roughness
  Type
  string
  Description
  रफनेस मैप। जब आपने टास्क enable_pbr: false के साथ बनाया हो, तो शामिल नहीं होता।
- Name
  emission
  Type
  string
  Description
  एमिशन मैप। केवल तभी शामिल होता है जब आपने टास्क इन सभी के साथ बनाया हो:
  
  ai_model: meshy-6, इसके डिफ़ॉल्ट टेक्सचर मॉडल के साथ
  
  enable_pbr: true
  
  2k या 4k का texture_resolution
Name
preceding_tasks
Type
integer
Description
कतार में इस टास्क से आगे मौजूद टास्क की संख्या। यह मान केवल तभी सार्थक होता है जब टास्क PENDING हो।
Name
task_error
Type
object
Description
टास्क फेल होने पर एरर विवरण। यह null होता है जब तक स्टेटस FAILED न हो। देखें एरर।
Name
consumed_credits
Type
integer
Description
टास्क द्वारा इस्तेमाल किए गए क्रेडिट की संख्या। यह तब मौजूद होता है जब स्टेटस PENDING, IN_PROGRESS, या SUCCEEDED हो। FAILED टास्क के लिए यह 0 होता है, क्योंकि Meshy टास्क फेल होने पर क्रेडिट वापस कर देता है।