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

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

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: एक स्टाइलिश लुक के लिए रंगों को साफ, समान क्षेत्रों में समतल करता है। एक छोटी फाइल उत्पन्न करता है।

रिटर्न्स

प्रतिक्रिया की 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 के बीच होना चाहिए।
- अमान्य शैली: मान realistic या cartoon होना चाहिए।
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 प्रिंट टास्क प्राप्त करता है।

पैरामीटर्स

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

रिटर्न्स

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

अनुरोध

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}"

प्रतिक्रिया

{
  "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

एक मल्टी-कलर 3डी प्रिंट कार्य को हटाएं

यह एंडपॉइंट एक मल्टी-कलर 3डी प्रिंट कार्य को स्थायी रूप से हटाता है, जिसमें सभी संबंधित मॉडल और डेटा शामिल हैं। यह क्रिया अपरिवर्तनीय है।

पाथ पैरामीटर्स

Name
id
Type
path
Description
हटाने के लिए मल्टी-कलर 3डी प्रिंट कार्य का आईडी।

रिटर्न्स

सफलता पर 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 प्रिंट कार्य को स्ट्रीम करें

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

पैरामीटर्स

Name
id
Type
path
Description
स्ट्रीम करने के लिए मल्टी-कलर 3D प्रिंट कार्य का अद्वितीय पहचानकर्ता।

रिटर्न्स

सर्वर-सेंट इवेंट्स के रूप में 3D प्रिंट कार्य ऑब्जेक्ट्स की एक स्ट्रीम लौटाता है।

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

अनुरोध

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}"

प्रतिक्रिया स्ट्रीम

// 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
टास्क की प्रगति। यदि टास्क अभी तक शुरू नहीं हुआ है, तो यह प्रॉपर्टी 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
}