प्रिंट-योग्यता मरम्मत API

किसी 3D मॉडल की प्रिंट-योग्यता के लिए मरम्मत करें — नॉन-मैनिफोल्ड किनारे, डिजेनरेट फेस, छेद, और अन्य topology समस्याओं को ठीक करें ताकि मेश प्रिंट के लिए तैयार हो। वैकल्पिक रूप से, जिस आकार में आप प्रिंट करने की योजना बना रहे हैं उस पर बहुत पतली दीवारों को भी मोटा करें।

POST/openapi/v1/print/repair

प्रिंट-योग्यता मरम्मत टास्क बनाएं

यह एंडपॉइंट एक नया रीपेयर-प्रिंटेबिलिटी टास्क बनाता है। यह टास्क किसी 3D मॉडल पर topology मरम्मत चलाता है और एक वॉटरटाइट, प्रिंट-रेडी वर्शन लौटाता है।

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

आउटपुट फॉर्मेट, इनपुट फॉर्मेट से मेल खाता है। यदि आप model_url के माध्यम से .stl सबमिट करते हैं, तो रिस्पॉन्स का model_urls.stl मरम्मत किए गए मेश को रखेगा और अन्य फॉर्मेट फील्ड्स खाली रहेंगी। input_task_id पाथ हमेशा सोर्स टास्क के GLB को पढ़ता है, इसलिए आउटपुट .glb होता है।

आप जिस आकार में प्रिंट करने की योजना बना रहे हैं, उसमें बहुत पतली दीवारों को मोटा भी करने के लिए, printer_type, एक प्रिंट साइज़, या दोनों भेजें। दीवारें केवल तभी मोटी की जाती हैं जब उस प्रिंटर के लिए सतह का 5% से अधिक भाग बहुत पतला हो। मरम्मत किया गया मॉडल अपना मूल स्केल बनाए रखता है; इसे Resize API के साथ स्केल करें, जो मीटर लेता है (100 mm का मतलब है 0.1)।

पैरामीटर

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

ज्यामिति में बदलाव के कारण मरम्मत के दौरान मौजूदा टेक्सचर हटा दिए जाते हैं। टेक्सचर वापस जोड़ने के लिए, मरम्मत किए गए मॉडल पर Retexture API का उपयोग करें।

Name
input_task_id
Type
string
आवश्यक
Description
आपके स्वामित्व वाले एक सफल टास्क की ID। समर्थित टास्क प्रकार: Image to 3D, Multi-Image to 3D, Text to 3D, Remesh, Retexture, और Analyze Printability. टास्क की स्थिति SUCCEEDED होनी चाहिए और उसने एक GLB एसेट तैयार किया होना चाहिए।
एक एनालाइज़ टास्क जिसने दीवार की मोटाई जाँची थी, वह अपने प्रिंटर और साइज़ को भी आगे पास करता है, इसलिए मरम्मत, दीवार की मोटाई जाँचती है, और पतली दीवारों को मोटा करती है, भले ही आप दोनों में से कोई भी न भेजें; आपके द्वारा भेजा गया printer_type या प्रिंट साइज़ उस वैल्यू को ओवरराइड कर देता है। .stl, .fbx, या .gltf model_url से बनाए गए एनालाइज़ टास्क स्वीकार नहीं किए जाते हैं: इसके बजाय फ़ाइल को model_url के रूप में भेजें।

Name
model_url
Type
string
आवश्यक
Description
मरम्मत किए जाने वाले 3D मॉडल का URL। समर्थित फॉर्मेट: .glb, .gltf, .obj, .fbx, .stl. एक http या https URL का उपयोग करें, या GLB (data:model/gltf-binary;base64,...) या glTF (data:model/gltf+json;base64,...) के लिए एक base64 data: URL का उपयोग करें। .obj, .fbx और .stl फ़ाइलें अवश्य http या https URL के रूप में भेजी जानी चाहिए।
अधिकतम फ़ाइल आकार: http या https URL के लिए 400 MB, data: URI के लिए 100 MB.
100 MB से बड़ी GLB, glTF, FBX या OBJ फ़ाइल में अधिकतम 10,000,000 फेस हो सकते हैं। फेस को ट्राएंगल के रूप में गिना जाता है: एक क्वाड को 2 गिना जाता है, और एक से अधिक बार ड्रॉ किया गया मेश प्रत्येक कॉपी के लिए एक बार गिना जाता है। 100 MB से अधिक पर, एक FBX फ़ाइल बाइनरी FBX 7.1 या उससे नई होनी चाहिए, और GLB या glTF फ़ाइल Draco कम्प्रेशन का उपयोग नहीं करनी चाहिए।
Meshy डाउनलोड URLs (assets.meshy.ai/…?Expires=…&Signature=…) साइन किए गए होते हैं और टास्क के expires_at पर काम करना बंद कर देते हैं; टास्क को फिर से फ़ेच करने से वे रिन्यू नहीं होते। Meshy के साथ जनरेट किए गए मॉडल के लिए, इसके बजाय input_task_id पास करें। यह तब तक काम करता है जब तक सोर्स टास्क बना रहता है (देखें Asset Retention)। उसके बाद मॉडल को फिर से उपयोग करने के लिए, expires_at से पहले इसे डाउनलोड करें और अपनी खुद की कॉपी भेजें।

Name
alpha_thumbnail
Type
boolean
डिफ़ॉल्ट false
Description
जब true पर सेट किया जाता है, तो टास्क अतिरिक्त रूप से प्रीव्यू का एक पारदर्शी-बैकग्राउंड (RGBA) वर्शन रेंडर करता है और इसे GET रिस्पॉन्स पर alpha_thumbnail_url के रूप में लौटाता है। मौजूदा thumbnail_url फील्ड अपरिवर्तित रहती है।

दो प्रिंट साइज़ फील्ड्स में से अधिकतम एक ही भेजें। यदि आप साइज़ के बिना printer_type भेजते हैं, और किसी एनालाइज़ टास्क से कोई साइज़ पुनः उपयोग नहीं की जाती है, तो डिफ़ॉल्ट साइज़ है:

.glb और कोई भी input_task_id: ऊंचाई 150 mm.
.stl: फ़ाइल का स्वयं का सबसे लंबा साइड, मिलीमीटर के रूप में पढ़ा गया। अन्य यूनिट्स में STL के लिए, intended_print_longest_side_mm भेजें।
.obj, .fbx, .gltf: सबसे लंबे साइड पर 150 mm.

Name
printer_type
Type
string
Description
वह प्रिंटर जिसका आप उपयोग करने की योजना बना रहे हैं। यह न्यूनतम दीवार की मोटाई सेट करता है जिसका लक्ष्य मरम्मत करती है। जब आप बिना इसके प्रिंट साइज़ भेजते हैं तो डिफ़ॉल्ट fdm होता है, जब तक कि input_task_id के रूप में पास किया गया एनालाइज़ टास्क प्रिंटर की जानकारी न दे।
उपलब्ध वैल्यू:
- fdm: फिलामेंट, 1.0 mm न्यूनतम दीवार।
- sla: रेजिन, 0.8 mm न्यूनतम दीवार।
- full_color: फुल-कलर, 2.0 mm न्यूनतम दीवार।
Name
intended_print_height_mm
Type
number
Description
प्रिंट की ऊंचाई, मिलीमीटर में। सीमा: [1, 1000]. निकटतम मिलीमीटर पर राउंड किया जाता है। केवल GLB इनपुट के लिए।
Name
intended_print_longest_side_mm
Type
number
Description
प्रिंट के सबसे लंबे साइड की लंबाई, मिलीमीटर में। सीमा: [1, 1000]. निकटतम मिलीमीटर पर राउंड किया जाता है। यह हर इनपुट फॉर्मेट के साथ काम करता है।

रिटर्न

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

विफलता मोड

Name
400 - Bad Request
Description
अनुरोध अस्वीकार्य था। सामान्य कारण:
- पैरामीटर गायब: न तो input_task_id और न ही model_url दिया गया था।
- अमान्य UUID: input_task_id एक मान्य UUID नहीं है।
- अमान्य मॉडल URL: model_url ठीक से फॉर्मेट नहीं है, एक असमर्थित स्कीम का उपयोग करता है, या इसका फ़ाइल एक्सटेंशन असमर्थित है।
- मॉडल फ़ाइल बहुत बड़ी है: model_url बॉडी 400 MB (http या https URL) या 100 MB (data: URI) से अधिक हो गई।
- बहुत अधिक फेस: model_url एक GLB, glTF, FBX या OBJ फ़ाइल है जो 100 MB से बड़ी है और इसमें 10,000,000 से अधिक फेस हैं। फेस की संख्या कम करें, फिर फ़ाइल को फिर से भेजें।
- 100 MB से अधिक ASCII FBX: model_url एक ASCII FBX है जो 100 MB से बड़ी है। इसे बाइनरी FBX या GLB के रूप में भेजें।
- अपठनीय मॉडल फ़ाइल: model_url 100 MB से बड़ी है और इसका हेडर पढ़ा नहीं जा सकता, उदाहरण के लिए एक Draco-कम्प्रेस्ड GLB या glTF, या 7.1 से पुरानी बाइनरी FBX।
- मॉडल हेडर बहुत जटिल है: model_url 100 MB से बड़ी है और इसके हेडर में जाँचने के लिए बहुत सारे मेश, नोड्स या रिकॉर्ड हैं। फ़ाइल में ऑब्जेक्ट्स की संख्या कम करें, फिर इसे फिर से भेजें।
- मॉडल फ़ाइल डाउनलोड नहीं की जा सकी: model_url ने एक त्रुटि लौटाई, अक्सर इसलिए क्योंकि एक साइन किया गया Meshy डाउनलोड URL एक्सपायर हो चुका है। टास्क को फिर से फ़ेच करने पर वही URL उसी एक्सपायरी के साथ लौटता है, इसलिए फ़ाइल की अपनी खुद की कॉपी भेजें, या जब तक सोर्स टास्क अभी भी बना हुआ है, input_task_id का उपयोग करें।
- टास्क सफल नहीं हुआ: संदर्भित टास्क अभी भी पेंडिंग, प्रगति में, या असफल है।
- GLB गायब: संदर्भित टास्क के पास मरम्मत के लिए कोई GLB एसेट नहीं है।
- अमान्य प्रिंट साइज़: intended_print_height_mm या intended_print_longest_side_mm [1, 1000] के बाहर है, या दोनों भेजे गए थे।
- अज्ञात प्रिंटर प्रकार: printer_type fdm, sla, या full_color में से कोई नहीं है।
- नॉन-GLB मॉडल पर ऊंचाई: intended_print_height_mm एक model_url के साथ भेजा गया था जो .glb नहीं है। इसके बजाय intended_print_longest_side_mm का उपयोग करें।
- ऊंचाई के अनुसार इस मॉडल का आकार तय नहीं किया जा सकता: अनुरोधित ऊंचाई (या डिफ़ॉल्ट 150 mm) पर, मॉडल का सबसे लंबा साइड [1, 1000] mm के बाहर होगा, मॉडल फ्लैट है, या इसका आकार निर्धारित नहीं किया जा सकता। इसके बजाय intended_print_longest_side_mm का उपयोग करें। एक .glb model_url और कुछ input_task_id टास्क के लिए, यह टास्क शुरू होने के बाद ही पता चलता है, और टास्क इसके बजाय FAILED पर समाप्त होता है।
- STL साइज़ अनुपयोगी: printer_type बिना साइज़ के भेजा गया था, और .stl का स्वयं का सबसे लंबा साइड पढ़ा नहीं जा सकता या [1, 1000] mm के बाहर है। intended_print_longest_side_mm भेजें।
Name
401 - Unauthorized
Description
प्रमाणीकरण विफल हुआ। कृपया अपनी API की जाँच करें।
Name
402 - Payment Required
Description
सामान्य कारण:
- फ्री प्लान: टास्क बनाने के लिए एक पेड प्लान आवश्यक है। subscription page पर अपग्रेड करें।
- अपर्याप्त क्रेडिट: वर्कस्पेस क्रेडिट लिमिट तक पहुँच गई थी।
Name
404 - Not Found
Description
संदर्भित टास्क मौजूद नहीं है या किसी अन्य उपयोगकर्ता के स्वामित्व में है।
Name
429 - Too Many Requests
Description
आपने अपने पेंडिंग-टास्क कोटा या रेट लिमिट को पार कर लिया है।

Request

POST

/openapi/v1/print/repair

# Repair an existing task
curl https://api.meshy.ai/openapi/v1/print/repair \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

# Or repair a model URL directly
curl https://api.meshy.ai/openapi/v1/print/repair \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "model_url": "https://example.com/model.stl"
  }'

# Also thicken walls that are too thin for a 100 mm tall SLA print
curl https://api.meshy.ai/openapi/v1/print/repair \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "printer_type": "sla",
    "intended_print_height_mm": 100
  }'

Response

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

GET/openapi/v1/print/repair/:id

प्रिंट-योग्यता मरम्मत टास्क प्राप्त करें

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

पैरामीटर

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

रिटर्न

रिपेयर प्रिंटेबिलिटी टास्क ऑब्जेक्ट। model_urls ब्लॉक तब तक खाली रहता है जब तक टास्क SUCCEEDED स्थिति तक नहीं पहुँच जाता। केवल इनपुट फॉर्मैट से मेल खाने वाला model_urls फील्ड ही भरा जाता है। दीवार की मोटाई की मरम्मत में शुरुआत से ही intended_print शामिल होता है, और टास्क सफल होने पर print_repair_report भी शामिल किया जाता है।

Request

GET

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

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

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.stl?Expires=***",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

Response (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000090000,
  "expires_at": 1715725490000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10,
  "intended_print": {
    "printer_type": "sla",
    "height_mm": 100,
    "longest_side_mm": 118,
    "wall_thickness_mm": 0.8,
    "dimensions_mm": [118, 72.41, 99.87]
  },
  "print_repair_report": {
    "route": "thin_wall",
    "applied": true,
    "faces_before": 243112,
    "faces_after": 251870,
    "thin_area_ratio_before": 0.083,
    "thin_area_ratio_after": 0.004
  }
}

DELETE/openapi/v1/print/repair/:id

प्रिंट-योग्यता मरम्मत टास्क हटाएँ

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

पाथ पैरामीटर

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

टास्क स्थिति

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

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

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

रिटर्न

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

Request

DELETE

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

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/print/repair/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/repair

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

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

पैरामीटर

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

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

रिटर्न

प्रिंट-योग्यता मरम्मत टास्क ऑब्जेक्ट्स की एक पेजिनेटेड सूची लौटाता है।

Request

GET

/openapi/v1/print/repair

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

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-repair",
    "status": "SUCCEEDED",
    "progress": 100,
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000030000,
    "expires_at": 1715725401000,
    "task_error": null,
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
      "gltf": "",
      "fbx": "",
      "obj": "",
      "stl": "",
      "usdz": "",
      "3mf": "",
      "mtl": ""
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
    "texture_urls": [],
    "consumed_credits": 10
  }
]

GET/openapi/v1/print/repair/:id/stream

प्रिंट-योग्यता मरम्मत टास्क को स्ट्रीम करें

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

पैरामीटर

Name
id
Type
path
Description
स्ट्रीम करने के लिए repair-printability टास्क का यूनिक पहचानकर्ता।

रिटर्न

Repair Printability Task Objects की एक स्ट्रीम को Server-Sent Events के रूप में रिटर्न करता है।

हर फ्रेम उस चरण के लिए पूरा टास्क ऑब्जेक्ट लेकर आता है — ठीक उसी रूप में जो Get एंडपॉइंट रिटर्न करता है — इसलिए जब तक टास्क PENDING या IN_PROGRESS है, आउटपुट फ़ील्ड्स बस अभी भरे नहीं गए होते (null, [] या {}) और finished_at null होता है। model_urls ब्लॉक तभी भेजा जाता है जब टास्क SUCCEEDED स्थिति तक पहुँचता है।

Request

GET

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

curl -N https://api.meshy.ai/openapi/v1/print/repair/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.
// Every frame is the full task object; fields not yet populated are null / empty.
// The PENDING frame below is abbreviated to the fields that change.
event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

प्रिंट-योग्यता मरम्मत Task ऑब्जेक्ट

Name
id
Type
string
Description
टास्क के लिए यूनीक पहचानकर्ता। हालांकि हम टास्क आईडी के लिए एक k-sortable UUID को इम्प्लीमेंटेशन डिटेल के रूप में उपयोग करते हैं, आपको id के फॉर्मेट के बारे में कोई धारणा नहीं बनानी चाहिए।
Name
type
Type
string
Description
प्रिंट-योग्यता मरम्मत टास्क का प्रकार। इसका मान print-repair है।
Name
status
Type
string
Description
टास्क की स्थिति। संभावित मान PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED में से एक है।
Name
progress
Type
integer
Description
टास्क की progress। यदि टास्क अभी शुरू नहीं हुआ है, तो यह प्रॉपर्टी 0 होगी। एक बार टास्क सफल हो जाने पर, यह 100 हो जाएगी।
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
expires_at
Type
timestamp
Description
टास्क का परिणाम सिस्टम से कब expire होगा, इसका टाइमस्टैंप, मिलीसेकंड में। यदि टास्क अभी समाप्त नहीं हुआ है तो 0।
Name
task_error
Type
object
Description
यदि टास्क विफल हो गया है तो एरर जानकारी। यदि टास्क विफल नहीं हुआ है तो यह प्रॉपर्टी null है। अधिक जानकारी के लिए एरर देखें।
- Name
  message
  Type
  string
  Description
  यह बताने वाला एरर संदेश कि क्या गलत हुआ।
Name
model_urls
Type
object
Description
मरम्मत किए गए 3D मॉडल के डाउनलोड योग्य URL। केवल इनपुट फॉर्मेट से मेल खाने वाली फ़ील्ड ही भरी जाती है; अन्य फॉर्मेट फ़ील्ड खाली स्ट्रिंग होती हैं।
- Name
  glb
  Type
  string
  Description
  मरम्मत किए गए GLB का डाउनलोड योग्य URL। यह तब भरा जाता है जब इनपुट GLB था या जब input_task_id का उपयोग किया गया था।
- Name
  gltf
  Type
  string
  Description
  मरम्मत किए गए GLTF का डाउनलोड योग्य URL। यह तब भरा जाता है जब इनपुट एक GLTF अपलोड था।
- Name
  fbx
  Type
  string
  Description
  मरम्मत किए गए FBX का डाउनलोड योग्य URL। यह तब भरा जाता है जब इनपुट एक FBX अपलोड था।
- Name
  obj
  Type
  string
  Description
  मरम्मत किए गए OBJ का डाउनलोड योग्य URL। यह तब भरा जाता है जब इनपुट एक OBJ अपलोड था।
- Name
  stl
  Type
  string
  Description
  मरम्मत किए गए STL का डाउनलोड योग्य URL। यह तब भरा जाता है जब इनपुट एक STL अपलोड था।
- Name
  usdz
  Type
  string
  Description
  USDZ आउटपुट के लिए आरक्षित। प्रिंट-योग्यता मरम्मत टास्क के लिए हमेशा खाली स्ट्रिंग।
- Name
  3mf
  Type
  string
  Description
  3MF आउटपुट के लिए आरक्षित। प्रिंट-योग्यता मरम्मत टास्क के लिए हमेशा खाली स्ट्रिंग।
- Name
  mtl
  Type
  string
  Description
  MTL आउटपुट के लिए आरक्षित। प्रिंट-योग्यता मरम्मत टास्क के लिए हमेशा खाली स्ट्रिंग।
Name
thumbnail_url
Type
string
Description
मरम्मत किए गए मॉडल से रेंडर की गई प्रिव्यू इमेज का URL।
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url के पारदर्शी-बैकग्राउंड (RGBA) संस्करण का डाउनलोड योग्य URL। यह केवल तभी मौजूद होता है जब टास्क alpha_thumbnail: true के साथ बनाया गया था और पारदर्शी प्रिव्यू सफलतापूर्वक रेंडर हुआ था; अन्यथा यह फ़ील्ड छोड़ दी जाती है।
Name
texture_urls
Type
array
Description
हमेशा एक खाली array। मरम्मत केवल इनपुट ज्यामिति को संरक्षित करती है और टेक्सचर को फिर से बेक नहीं करती है।
Name
consumed_credits
Type
integer
Description
इस टास्क द्वारा उपभोग किए गए क्रेडिट की संख्या। टास्क के SUCCEEDED तक पहुंचने पर 10। FAILED टास्क के लिए 0 रिटर्न करता है (विफलता पर क्रेडिट वापस कर दिए जाते हैं)।
Name
intended_print
Type
object
Description
वह प्रिंटर और आकार जिसका मरम्मत में उपयोग किया गया, चाहे वह भेजा गया हो या किसी analyze टास्क से पुन: उपयोग किया गया हो। यह एक दीवार की मोटाई मरम्मत पर शुरुआत से (PENDING) मौजूद होता है; जो मान अभी तक ज्ञात नहीं हैं वे null हैं।
- Name
  printer_type
  Type
  string
  Description
  fdm, sla, या full_color।
- Name
  height_mm
  Type
  number
  Description
  मिलीमीटर में प्रिंट की ऊंचाई, यदि प्रिंट का आकार ऊंचाई के अनुसार निर्धारित किया गया था। अन्यथा null।
- Name
  longest_side_mm
  Type
  number
  Description
  मिलीमीटर में प्रिंट की सबसे लंबी भुजा। जब ऊंचाई के अनुसार आकार निर्धारित किया जाता है, तो इसकी गणना मॉडल के अनुपात से की जाती है, और जब तक मॉडल को मापा नहीं जाता तब तक यह null रहता है।
- Name
  wall_thickness_mm
  Type
  number
  Description
  printer_type के लिए न्यूनतम दीवार की मोटाई, मिलीमीटर में।
- Name
  dimensions_mm
  Type
  array
  Description
  मिलीमीटर में प्रिंट का [width, depth, height]। ऊंचाई height_mm से एक मिलीमीटर के अंश से भिन्न हो सकती है। टास्क के सफल होने तक null, और non-GLB इनपुट के लिए हमेशा null।
Name
print_repair_report
Type
object
Description
दीवार की मोटाई मरम्मत ने क्या किया। यह एक बार दीवार की मोटाई मरम्मत के सफल होने के बाद मौजूद होता है।
- Name
  route
  Type
  string
  Description
  कौन सी मरम्मत चली। इनमें से एक:
  
  thin_wall: सतह के 5% से अधिक हिस्से बहुत पतले थे, इसलिए दीवार मोटा करने की प्रक्रिया भी चली (applied देखें)।
  
  topology: दीवारें पर्याप्त रूप से मोटी थीं; केवल topology मरम्मत चली।
  
  topology_unmeasured: दीवारों को मापा नहीं जा सका; केवल topology मरम्मत चली।
- Name
  applied
  Type
  boolean
  Description
  क्या दीवार मोटा करने की प्रक्रिया ने मेश को बदला। यह केवल तभी मौजूद होता है जब route thin_wall हो।
- Name
  faces_before
  Type
  integer
  Description
  इनपुट मेश की फेस संख्या। यह केवल तभी मौजूद होता है जब route thin_wall हो।
- Name
  faces_after
  Type
  integer
  Description
  मरम्मत किए गए मेश की फेस संख्या। यह केवल तभी मौजूद होता है जब route thin_wall हो।
- Name
  thin_area_ratio_before
  Type
  number
  Description
  इनपुट की सतह का वह हिस्सा, 0 से 1 तक, जो intended_print.wall_thickness_mm से पतला था। यदि इनपुट को मापा नहीं जा सका तो इसे छोड़ दिया जाता है।
- Name
  thin_area_ratio_after
  Type
  number
  Description
  वही हिस्सा, मरम्मत किए गए मॉडल पर मापा गया। यदि इसे मापा नहीं जा सका तो इसे छोड़ दिया जाता है; टास्क फिर भी सफल होता है।

The Repair Printability Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

The Repair Printability Task Object (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000090000,
  "expires_at": 1715725490000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10,
  "intended_print": {
    "printer_type": "sla",
    "height_mm": 100,
    "longest_side_mm": 118,
    "wall_thickness_mm": 0.8,
    "dimensions_mm": [118, 72.41, 99.87]
  },
  "print_repair_report": {
    "route": "thin_wall",
    "applied": true,
    "faces_before": 243112,
    "faces_after": 251870,
    "thin_area_ratio_before": 0.083,
    "thin_area_ratio_after": 0.004
  }
}