मल्टी-कलर प्रिंट API

किसी 3D मॉडल को 3D प्रिंटिंग के लिए मल्टी-कलर 3MF फ़ाइल में कन्वर्ट करें। 16 तक रंगों का पैलेट और अपने प्रिंटर ब्रांड के लिए स्लाइसर प्रीसेट चुनें।

POST/openapi/v1/print/multi-color

मल्टी-कलर प्रिंट टास्क बनाएँ

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

Request

POST

/openapi/v1/print/multi-color

# Convert a 3D model to a multi-color 3MF with a Creality slicer preset
curl https://api.meshy.ai/openapi/v1/print/multi-color \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "max_colors": 8,
    "printer_brand": "creality"
  }'

Response

{
  "result": "0193bfc5-ee4f-73f8-8525-44b398884ce9"
}

पैरामीटर

Name
input_task_id
Type
string
आवश्यक
Description
model_url भेजने पर यह आवश्यक नहीं है, अन्यथा आवश्यक है। उस टास्क की ID, जिसके मॉडल को आप प्रिंट करना चाहते हैं, उदाहरण के लिए इमेज से 3D, मल्टी-इमेज से 3D, टेक्स्ट से 3D, रीमेश, या रीटेक्सचर टास्क। यह टास्क वही होना चाहिए जिसे आपने API से बनाया हो, और जिसका स्टेटस SUCCEEDED हो।
मल्टी-कलर प्रिंट उस टास्क की GLB फ़ाइल को पढ़ता है, जिसमें अधिकतम 8,000,000 फेस हो सकते हैं। इससे अधिक फेस वाला मॉडल 400 लौटाता है। ऐसे में पहले उस पर रीमेश टास्क चलाएँ, और उसकी जगह रीमेश टास्क की ID भेजें।

Name
model_url
Type
string
आवश्यक
Description
input_task_id भेजने पर यह आवश्यक नहीं है, अन्यथा आवश्यक है। प्रिंट किया जाने वाला मॉडल, एक पब्लिक URL या data URI के रूप में। यदि आप दोनों भेजते हैं, तो Meshy input_task_id का उपयोग करता है।
एक http या https URL को अधिकतम 400 MB की .glb या .fbx फ़ाइल की ओर इशारा करना चाहिए। एक data URI में अधिकतम 100 MB की base64 GLB फ़ाइल होनी चाहिए। data:model/gltf-binary;base64, का उपयोग करें। .fbx फ़ाइल को http या https URL के रूप में भेजें।
100 MB से बड़ी फ़ाइल को इन नियमों का भी पालन करना चाहिए:
- इसमें अधिकतम 8,000,000 फेस हो सकते हैं। Meshy फेस को ट्रायंगल के रूप में गिनता है, इसलिए एक क्वाड 2 के रूप में गिना जाता है, और एक से अधिक बार बनाया गया मेश हर कॉपी के लिए एक बार गिना जाता है।
- एक FBX फ़ाइल बाइनरी FBX 7.1 या उससे नई होनी चाहिए।
- एक GLB फ़ाइल को Draco कम्प्रेशन का उपयोग नहीं करना चाहिए।

Name
max_colors
Type
integer
डिफ़ॉल्ट 4
Description
आउटपुट पैलेट में रंगों की अधिकतम संख्या, 1 से 16 तक। डिफ़ॉल्ट का उपयोग करने के लिए, इसे 0 भेजने के बजाय छोड़ दें।
Name
style
Type
string
डिफ़ॉल्ट realistic
Description
3MF फ़ाइल की कलर स्टाइल।
उपलब्ध वैल्यू:
- realistic: बारीक, फ़ोटो-रियलिस्टिक डिटेल के लिए मॉडल के टेक्सचर से सीधे रंग सैंपल करता है, और एक बड़ी फ़ाइल बनाता है।
- cartoon: स्टाइलाइज़्ड लुक के लिए रंगों को साफ़, यूनिफ़ॉर्म रीजन में फ़्लैटन करता है, और एक छोटी फ़ाइल बनाता है।
मॉडल में रंग होना चाहिए। realistic को हर मेश पार्ट पर UV सहित एक सिंगल बेस कलर टेक्सचर की आवश्यकता है, और cartoon वर्टेक्स कलर्स को भी स्वीकार करता है। Meshy बिना टेक्सचर (सफ़ेद) वाले मॉडल को रिजेक्ट कर देता है। देखें model_missing_texture।
Name
max_depth
Type
integer
डिफ़ॉल्ट 4
Description
सबडिविज़न डेप्थ जिसका उपयोग Meshy मेश पर टेक्सचर रंगों को सैंपल करने के लिए करता है, 3 से 6 तक। 0 इसे छोड़ने के समान है। अधिक वैल्यू बारीक कलर डिटेल कैप्चर करती हैं, और एक बड़ी फ़ाइल बनाती हैं। केवल realistic स्टाइल इसका उपयोग करती है, और cartoon इसे नज़रअंदाज़ करता है।
Name
printer_brand
Type
string
डिफ़ॉल्ट bambu
Description
प्रिंटर ब्रांड जिसका स्लाइसर प्रीसेट Meshy 3MF फ़ाइल में लिखता है। फिर यह फ़ाइल उस ब्रांड के स्लाइसर में एक मिलते-जुलते प्रिंटर, फिलामेंट, और प्रोसेस प्रोफ़ाइल के साथ खुलती है। यह प्रीसेट ब्रांड के डिफ़ॉल्ट प्रिंटर का उपयोग करता है, 0.4 mm नोज़ल के साथ।
उपलब्ध वैल्यू:
- bambu
- anycubic
- creality
- elegoo
- flashforge
- prusa
- qidi
- snapmaker
- ankermake
कोई अन्य वैल्यू 400 लौटाती है।

रिटर्न

रिस्पॉन्स का result फ़ील्ड नए मल्टी-कलर प्रिंट टास्क की ID रखता है।

फेलियर मोड

Name
400 - Bad Request
Description
रिक्वेस्ट नहीं चल सकती। एरर मैसेज बताता है कि कौन सी समस्या मिली। उदाहरण के लिए:
- गायब पैरामीटर: न तो model_url और न ही input_task_id भेजा गया।
- अमान्य मॉडल फॉर्मेट: model_url फ़ाइल .glb या .fbx फ़ाइल नहीं है।
- अनरीचेबल URL: Meshy model_url फ़ाइल को डाउनलोड नहीं कर सकता।
- मॉडल फ़ाइल बहुत बड़ी: model_url फ़ाइल http या https URL से 400 MB से अधिक है, या data URI के रूप में 100 MB से अधिक है।
- बहुत अधिक फेस: model_url फ़ाइल 100 MB से अधिक है और इसमें 8,000,000 से अधिक फेस हैं। फेस काउंट कम करें, फिर फ़ाइल दोबारा भेजें।
- ASCII FBX 100 MB से अधिक: model_url फ़ाइल 100 MB से बड़ी ASCII FBX है। इसे बाइनरी FBX या GLB के रूप में भेजें।
- अपठनीय मॉडल फ़ाइल: model_url फ़ाइल 100 MB से अधिक है, और Meshy इसका हेडर नहीं पढ़ सकता। उदाहरण के लिए, यह Draco-कम्प्रेस्ड GLB है, या 7.1 से पुरानी बाइनरी FBX है।
- मॉडल हेडर बहुत जटिल: model_url फ़ाइल 100 MB से अधिक है, और इसके हेडर में चेक करने के लिए बहुत अधिक मेश, नोड्स, या रिकॉर्ड हैं। फ़ाइल में ऑब्जेक्ट्स की संख्या कम करें, फिर इसे दोबारा भेजें।
- अमान्य इनपुट टास्क: input_task_id एक सफल टास्क नहीं है।
- इनपुट टास्क में बहुत अधिक फेस: input_task_id मॉडल में 8,000,000 से अधिक फेस हैं। उस पर रीमेश टास्क चलाएँ, फिर उसकी जगह रीमेश टास्क की ID भेजें।
- अमान्य max_colors: max_colors नेगेटिव है या 16 से अधिक है।
- अमान्य style: style न तो realistic है और न ही cartoon।
- अमान्य max_depth: max_depth 3 से 6 की रेंज से बाहर है, और 0 भी नहीं है।
- अमान्य printer_brand: printer_brand इसकी उपलब्ध वैल्यूज़ में से कोई नहीं है।
- कोई कलर सोर्स नहीं: मॉडल में वह रंग नहीं है जिसकी style को आवश्यकता है। realistic को हर मेश पार्ट पर UV सहित एक सिंगल बेस कलर टेक्सचर की आवश्यकता है। cartoon बेस कलर टेक्सचर या वर्टेक्स कलर्स स्वीकार करता है। पहले मॉडल को टेक्सचर करें, या वर्टेक्स कलर्स वाले मॉडल के लिए cartoon का उपयोग करें। Meshy एक .fbx अपलोड को केवल टास्क द्वारा इसे नॉर्मलाइज़ करने के बाद ही चेक करता है, इसलिए टास्क इसके बजाय model_missing_texture के साथ विफल हो जाता है।
रिक्वेस्ट ठीक करें, फिर इसे दोबारा भेजें। देखें एरर।
Name
401 - Unauthorized
Description
API की गायब है या अमान्य है। Authorization हेडर जाँचें।
Name
402 - Payment Required
Description
उदाहरण के लिए:
- अपर्याप्त क्रेडिट: अकाउंट में इस टास्क के लिए पर्याप्त क्रेडिट नहीं हैं, या अकाउंट क्रेडिट लिमिट पर पहुँच गया है। अपना क्रेडिट बैलेंस जाँचें, फिर दोबारा कोशिश करें।
- फ़्री प्लान: टास्क बनाने के लिए पेड प्लान आवश्यक है। अपने सब्सक्रिप्शन सेटिंग्स में अपना प्लान अपग्रेड करें, फिर दोबारा कोशिश करें।
Name
403 - Forbidden
Description
input_task_id एक बास-रिलीफ मॉडल है, जिसे यह एंडपॉइंट प्रिंट नहीं कर सकता। मैसेज है This model type does not support this operation। एक अलग मॉडल भेजें।
Name
404 - Not Found
Description
input_task_id आपके किसी भी टास्क से मेल नहीं खाता। टास्क ID जाँचें, फिर रिक्वेस्ट दोबारा भेजें।
Name
429 - Too Many Requests
Description
आपने अपनी रेट लिमिट पार कर ली है। प्रतीक्षा करें, फिर दोबारा कोशिश करें। देखें रेट लिमिट्स।

GET/openapi/v1/print/multi-color/:id

मल्टी-कलर प्रिंट टास्क प्राप्त करें

यह किसी मल्टी-कलर प्रिंट टास्क को उसकी ID के आधार पर रिटर्न करता है।

Request

GET

/openapi/v1/print/multi-color/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl https://api.meshy.ai/openapi/v1/print/multi-color/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-multi-color",
  "model_urls": {
      "3mf": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.3mf?Expires=***"
},
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1700259201000,
  "task_error": null,
"consumed_credits": 10
}

पैरामीटर

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

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

मल्टी-कलर प्रिंट टास्क ऑब्जेक्ट।

DELETE/openapi/v1/print/multi-color/:id

मल्टी-कलर प्रिंट टास्क को डिलीट करें

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

Request

DELETE

/openapi/v1/print/multi-color/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/print/multi-color/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -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."
}

पाथ पैरामीटर

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

टास्क स्टेटस

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

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

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

रिटर्न

जब टास्क डिलीट हो जाता है तो 200 OK, या जब टास्क IN_PROGRESS होता है तो 409 Conflict।

GET/openapi/v1/print/multi-color

मल्टी-कलर प्रिंट टास्क की सूची प्राप्त करें

आपके मल्टी-कलर प्रिंट टास्क की एक सूची लौटाता है।

Request

GET

/openapi/v1/print/multi-color

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

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-multi-color",
    "model_urls": {
      "3mf": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.3mf?Expires=***"
    },
    "progress": 100,
    "status": "SUCCEEDED",
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000001000,
    "expires_at": 1700259201000,
    "task_error": null,
  "consumed_credits": 10
  }
]

पैरामीटर

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

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

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

GET/openapi/v1/print/multi-color/:id/stream

मल्टी-कलर प्रिंट टास्क को स्ट्रीम करें

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

Request

GET

/openapi/v1/print/multi-color/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream

curl -N https://api.meshy.ai/openapi/v1/print/multi-color/a43b5c6d-7e8f-901a-234b-567c890d1e2f/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": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "type": "print-multi-color",
  "model_urls": {
    "3mf": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/model.3mf?Expires=***"
  },
  "progress": 100,
  "status": "SUCCEEDED",
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1700259201000,
  "task_error": null,
"consumed_credits": 10
}

पैरामीटर

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

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

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

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

मल्टी-कलर प्रिंट टास्क ऑब्जेक्ट

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

The 3D Print Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-multi-color",
  "model_urls": {
      "3mf": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.3mf?Expires=***"
},
  "progress": 100,
  "status": "SUCCEEDED",
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1700259201000,
  "task_error": null,
"consumed_credits": 10
}

Name
id
Type
string
Description
टास्क ID। इसे एक अपारदर्शी (opaque) स्ट्रिंग मानें, और इसके फ़ॉर्मेट पर भरोसा न करें।
Name
type
Type
string
Description
टास्क का प्रकार, हमेशा print-multi-color।
Name
model_urls
Type
object
Description
प्रिंट किए गए मॉडल के लिए डाउनलोड URL, प्रत्येक फ़ाइल फ़ॉर्मेट के लिए एक। जिस फ़ॉर्मेट को टास्क ने जनरेट नहीं किया, उसके लिए कोई कुंजी नहीं होगी, न कि एक खाली स्ट्रिंग।
- Name
  3mf
  Type
  string
  Description
  मल्टी-कलर 3MF फ़ाइल।
Name
progress
Type
integer
Description
टास्क कितना पूरा हुआ है, प्रतिशत में। यह टास्क शुरू होने तक 0 रहता है और सफल होने पर 100 हो जाता है।
Name
status
Type
string
Description
टास्क की स्थिति, PENDING, IN_PROGRESS, SUCCEEDED, FAILED, या CANCELED में से एक।
Name
preceding_tasks
Type
integer
Description
कतार में इस टास्क से आगे मौजूद टास्कों की संख्या। यह मान केवल तभी सार्थक होता है जब टास्क PENDING हो।
Name
created_at
Type
timestamp
Description
टास्क के बनाए जाने का समय, Unix मिलीसेकंड में।
Name
started_at
Type
timestamp
Description
टास्क शुरू होने का समय, Unix मिलीसेकंड में। यह टास्क शुरू होने तक 0 रहता है।
Name
finished_at
Type
timestamp
Description
टास्क समाप्त होने का समय, Unix मिलीसेकंड में। यह टास्क समाप्त होने तक 0 रहता है।
Name
expires_at
Type
timestamp
Description
वह समय जब टास्क के परिणाम की समय-सीमा समाप्त होती है, Unix मिलीसेकंड में। यह टास्क समाप्त होने तक 0 रहता है।
Name
task_error
Type
object
Description
टास्क विफल होने पर एरर का विवरण। देखें एरर।
Name
consumed_credits
Type
integer
Description
टास्क द्वारा उपयोग किए गए क्रेडिट की संख्या। यह तब मौजूद होता है जब स्टेटस PENDING, IN_PROGRESS, या SUCCEEDED हो। FAILED टास्क के लिए यह 0 होता है, क्योंकि Meshy टास्क विफल होने पर क्रेडिट वापस कर देता है।