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

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

POST/openapi/v1/print/multi-color

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

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

यह टास्क बैकग्राउंड में चलता है। इसमें आमतौर पर कितना समय लगता है, यह जानने के लिए देखें Processing Times।

पैरामीटर

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

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

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

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

रिटर्न

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

फेल्योर मोड्स

Name
400 - Bad Request
Description
अनुरोध स्वीकार्य नहीं था। सामान्य कारण:
- पैरामीटर गुम: model_url या input_task_id में से कोई एक अवश्य दिया जाना चाहिए।
- अमान्य मॉडल फ़ॉर्मेट: model_url ऐसी फ़ाइल की ओर इशारा करता है जिसका एक्सटेंशन समर्थित नहीं है (केवल .glb और .fbx समर्थित हैं)।
- अनरीचेबल URL: model_url को डाउनलोड नहीं किया जा सका।
- मॉडल फ़ाइल बहुत बड़ी है: model_url फ़ाइल 400 MB (http या https URL) या 100 MB (data: URI) से अधिक है।
- बहुत अधिक फेस: model_url फ़ाइल 100 MB से बड़ी है और इसमें 8,000,000 से अधिक फेस हैं। फेस की संख्या कम करें, फिर फ़ाइल को दोबारा भेजें।
- ASCII FBX 100 MB से बड़ी: model_url फ़ाइल 100 MB से बड़ी ASCII FBX है। इसे बाइनरी FBX या GLB के रूप में भेजें।
- अपठनीय मॉडल फ़ाइल: model_url फ़ाइल 100 MB से बड़ी है और इसका हेडर पढ़ा नहीं जा सकता, उदाहरण के लिए Draco-कम्प्रेस्ड GLB, या 7.1 से पुरानी बाइनरी FBX।
- मॉडल हेडर बहुत जटिल है: model_url फ़ाइल 100 MB से बड़ी है और इसके हेडर में जाँचने के लिए बहुत अधिक मेश, नोड या रिकॉर्ड हैं। फ़ाइल में ऑब्जेक्ट की संख्या कम करें, फिर इसे दोबारा भेजें।
- अमान्य इनपुट टास्क: input_task_id को किसी सफल टास्क को संदर्भित करना चाहिए।
- अमान्य max_colors: मान 1 और 16 के बीच होना चाहिए।
- अमान्य style: मान realistic या cartoon होना चाहिए।
- अमान्य max_depth: मान 3 और 6 के बीच होना चाहिए।
- अमान्य printer_brand: मान ऊपर सूचीबद्ध ब्रांड्स में से एक होना चाहिए।
- कोई कलर सोर्स नहीं: इनपुट मॉडल में कोई बेस कलर टेक्सचर नहीं है (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 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"
}

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

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

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

पैरामीटर्स

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

रिटर्न

3D Print Task ऑब्जेक्ट।

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 प्रिंट टास्क को स्थायी रूप से डिलीट कर देता है, जिसमें सभी संबंधित मॉडल और डेटा शामिल हैं। यह क्रिया अपरिवर्तनीय है।

पाथ पैरामीटर

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

बहु-रंगीन 3D प्रिंट टास्क सूचीबद्ध करें

यह एंडपॉइंट आपको बहु-रंगीन 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 के रूप में The 3D Print Task Objects की एक स्ट्रीम रिटर्न करता है।

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 का उपयोग करते हैं, आपको id के फ़ॉर्मेट के बारे में कोई भी धारणा नहीं बनानी चाहिए।
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
}