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

3D मॉडल को मल्टी-कलर प्रिंट के लिए, 16 रंगों तक के कॉन्फ़िगर करने योग्य कलर पैलेट के साथ, मल्टी-कलर 3MF फॉर्मेट में कन्वर्ट करें।

POST/openapi/v1/print/multi-color

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

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

पैरामीटर

input_task_id या model_url में से केवल एक आवश्यक है। यदि दोनों प्रदान किए जाते हैं, तो input_task_id को प्राथमिकता मिलती है।

Name
input_task_id
Type
string
आवश्यक
Description
इनपुट के रूप में उपयोग करने के लिए किसी सफल टास्क का ID। समर्थित टास्क प्रकार: इमेज से 3D, मल्टी-इमेज से 3D, टेक्स्ट से 3D, रीमेश, और रीटेक्सचर। टास्क की स्थिति SUCCEEDED होनी चाहिए।

Name
model_url
Type
string
आवश्यक
Description
3D मॉडल की सार्वजनिक रूप से पहुँच योग्य URL या Data URI। हम वर्तमान में .glb और .fbx फ़ॉर्मेट का समर्थन करते हैं।

Name
max_colors
Type
integer
डिफ़ॉल्ट 4
Description
आउटपुट पैलेट में रंगों की अधिकतम संख्या।
मान्य सीमा: 1 से 16।
Name
style
Type
string
डिफ़ॉल्ट realistic
Description
जनरेट की गई 3MF फ़ाइल की दृश्य रंग शैली।
उपलब्ध मान:
- realistic: बारीक, फ़ोटो-रियलिस्टिक विवरण के लिए मॉडल के टेक्सचर से सीधे रंगों को सैंपल करता है। एक बड़ी फ़ाइल बनाता है।
- cartoon: स्टाइलाइज़्ड लुक के लिए रंगों को स्वच्छ, समान क्षेत्रों में समतल करता है। एक छोटी फ़ाइल बनाता है।
इनपुट में रंग होना आवश्यक है: realistic के लिए हर मेश भाग पर UV निर्देशांक वाला एकल बेस कलर टेक्सचर आवश्यक है; cartoon प्रति-वर्टेक्स रंगों को भी स्वीकार करता है। टेक्सचर रहित (सफ़ेद) मॉडल अस्वीकार कर दिए जाते हैं — देखें model_missing_texture।

रिटर्न

रिस्पॉन्स की result प्रॉपर्टी में नए बनाए गए 3D प्रिंट टास्क का id होता है।

विफलता के तरीके

Name
400 - Bad Request
Description
अनुरोध अस्वीकार्य था। सामान्य कारण:
- पैरामीटर गायब: model_url या input_task_id में से कोई एक प्रदान किया जाना चाहिए।
- अमान्य मॉडल फ़ॉर्मेट: model_url एक असमर्थित एक्सटेंशन वाली फ़ाइल की ओर इशारा करता है (केवल .glb और .fbx समर्थित हैं)।
- अनुपलब्ध URL: model_url को डाउनलोड नहीं किया जा सका।
- अमान्य इनपुट टास्क: input_task_id को एक सफल टास्क को संदर्भित करना चाहिए।
- अमान्य max_colors: मान 1 और 16 के बीच होना चाहिए।
- अमान्य style: मान realistic या cartoon होना चाहिए।
- कोई रंग स्रोत नहीं: इनपुट मॉडल में कोई बेस कलर टेक्सचर नहीं है (realistic के लिए हर मेश भाग पर UV के साथ एक की आवश्यकता होती है) और कोई वर्टेक्स रंग नहीं है (cartoon किसी भी एक को स्वीकार करता है)। पहले मॉडल को टेक्सचर करें, या वर्टेक्स-रंगीन मॉडल के लिए cartoon का उपयोग करें। .fbx अपलोड की जाँच टास्क द्वारा उन्हें सामान्य करने के बाद की जाती है और इसके बजाय model_missing_texture के साथ विफल हो जाती है।
Name
401 - Unauthorized
Description
प्रमाणीकरण विफल रहा। कृपया अपनी API की जाँचें।
Name
402 - Payment Required
Description
इस टास्क को करने के लिए अपर्याप्त क्रेडिट।
Name
429 - Too Many Requests
Description
आपने अपनी रेट लिमिट पार कर ली है।

Request

POST

/openapi/v1/print/multi-color

# Convert a 3D model to multi-color 3MF for printing
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
  }'

Response

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

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

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

यह एंडपॉइंट किसी मल्टी-कलर 3D प्रिंट टास्क को उसकी ID से प्राप्त करता है।

पैरामीटर्स

Name
id
Type
path
Description
प्राप्त किए जाने वाले 3D प्रिंट टास्क की ID।

रिटर्न

3D प्रिंट टास्क ऑब्जेक्ट।

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,
  "task_error": null,
"consumed_credits": 10
}

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

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

यह एंडपॉइंट किसी मल्टी-कलर 3D प्रिंट टास्क को, उससे जुड़े सभी मॉडल और डेटा सहित, स्थायी रूप से डिलीट कर देता है। यह क्रिया अपरिवर्तनीय (irreversible) है।

Path Parameters

Name
id
Type
path
Description
डिलीट किए जाने वाले मल्टी-कलर 3D प्रिंट टास्क की ID।

टास्क की स्थिति

जो टास्क अभी भी PENDING है उसे डिलीट कर दिया जाता है और बनाते समय खर्च हुए क्रेडिट वापस कर दिए जाते हैं।

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

टर्मिनल स्थिति (SUCCEEDED, FAILED या CANCELED) में मौजूद टास्क को बिना किसी रिफंड के डिलीट कर दिया जाता है।

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

सफल होने पर 200 OK लौटाता है, या जब टास्क IN_PROGRESS हो तो 409 Conflict लौटाता है।

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 is left 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."
}

GET/openapi/v1/print/multi-color

Multi-Color 3D प्रिंट टास्क की सूची

यह एंडपॉइंट आपको multi-color 3D प्रिंट टास्क की सूची प्राप्त करने की सुविधा देता है।

पैरामीटर्स

वैकल्पिक एट्रिब्यूट्स

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

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

The 3D Print Task Objects की एक पेजिनेटेड सूची लौटाता है।

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,
    "task_error": null,
  "consumed_credits": 10
  }
]

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

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

यह एंडपॉइंट Server-Sent Events (SSE) का उपयोग करके एक मल्टी-कलर 3D प्रिंट टास्क के लिए रीयल-टाइम अपडेट स्ट्रीम करता है।

पैरामीटर

Name
id
Type
path
Description
स्ट्रीम करने के लिए मल्टी-कलर 3D प्रिंट टास्क का यूनिक आइडेंटिफ़ायर।

रिटर्न

Server-Sent Events के रूप में 3D प्रिंट टास्क ऑब्जेक्ट्स की एक स्ट्रीम रिटर्न करता है।

PENDING या IN_PROGRESS टास्क के लिए, रिस्पॉन्स स्ट्रीम में केवल आवश्यक progress और status फ़ील्ड्स शामिल होंगे।

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.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
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,
  "task_error": null,
"consumed_credits": 10
}

द 3D प्रिंट टास्क ऑब्जेक्ट

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

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,
  "task_error": null,
"consumed_credits": 10
}