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

3D प्रिंटिंग के लिए 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
max_depth
Type
integer
डिफ़ॉल्ट 4
Description
रंग सटीकता के लिए क्वाडट्री डेप्थ। उच्च मान अधिक सूक्ष्म रंग सीमाएँ बनाते हैं, लेकिन फ़ाइल आकार बढ़ाते हैं।
मान्य रेंज: 3 से 6।

रिटर्न

रिस्पॉन्स की 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 के बीच होना चाहिए।
- अमान्य max_depth: मान 3 और 6 के बीच होना चाहिए।
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,
    "max_depth": 5
  }'

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 प्रिंट टास्क को स्थायी रूप से हटा देता है। यह कार्रवाई अपरिवर्तनीय है।

पाथ पैरामीटर

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

रिटर्न

सफलता पर 200 OK लौटाता है।

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

// Returns 200 Ok on success.

GET/openapi/v1/print/multi-color

मल्टी-कलर 3D प्रिंट कार्यों की सूची देखें

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

पैरामीटर

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

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

रिटर्न

3D प्रिंट कार्य ऑब्जेक्ट्स की पेजिनेटेड सूची लौटाता है।

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
टास्क के लिए अद्वितीय पहचानकर्ता। हालांकि हम टास्क ids के लिए कार्यान्वयन विवरण के रूप में 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
}