प्रिंट-योग्यता विश्लेषण API

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

POST/openapi/v1/print/analyze

प्रिंट-योग्यता विश्लेषण टास्क बनाएं

यह एंडपॉइंट एक नया analyze-printability टास्क बनाता है। यह टास्क एक 3D मॉडल का मूल्यांकन करता है और उसकी प्रिंट-योग्यता मेट्रिक्स रिपोर्ट करता है।

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

अगर इनपुट टास्क में पहले से कैश्ड प्रिंट-योग्यता मौजूद है, तो लौटाया गया टास्क तुरंत तैयार होता है और उस पर पहला GET वर्कर से गुज़रे बिना विश्लेषण परिणाम लौटाएगा।

जिस साइज़ में आप प्रिंट करने की योजना बना रहे हैं, उस पर दीवार की मोटाई भी जांचने के लिए, printer_type, एक प्रिंट साइज़, या दोनों भेजें। परिणाम printability.thin_walls में लौटाया जाता है। दीवार की मोटाई की जांच करने में अधिक समय लगता है, इसलिए टास्क आमतौर पर तुरंत तैयार नहीं होता, भले ही मॉडल का पहले विश्लेषण किया जा चुका हो।

पैरामीटर

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

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

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 डाउनलोड URL (assets.meshy.ai/…?Expires=…&Signature=…) साइन किए गए होते हैं और टास्क के expires_at पर काम करना बंद कर देते हैं; टास्क को फिर से प्राप्त करने से वे रिन्यू नहीं होते। Meshy से जनरेट किए गए मॉडल के लिए, इसके बजाय input_task_id भेजें। यह तब तक काम करता है जब तक स्रोत टास्क बरकरार रहता है (देखें एसेट रिटेंशन)। उसके बाद मॉडल का पुन: उपयोग करने के लिए, expires_at से पहले इसे डाउनलोड करें और अपनी खुद की कॉपी भेजें।

दो प्रिंट साइज़ फ़ील्ड में से अधिकतम एक भेजें। अगर आप बिना साइज़ के 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 होता है।
उपलब्ध मान:
- 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 प्रॉपर्टी में नए बनाए गए analyze-printability टास्क की 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 का उपयोग करें।
- टास्क सफल नहीं हुआ: संदर्भित टास्क अभी भी पेंडिंग, प्रगति में, या विफल है।
- अमान्य प्रिंट साइज़: 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
404 - Not Found
Description
सामान्य कारण:
- टास्क मौजूद नहीं है, हटा दिया गया है, या किसी अन्य उपयोगकर्ता के स्वामित्व में है।
- टास्क Meshy 6 से पुराने मॉडल का उपयोग करता है, या इसका mode कोई 3D एसेट उत्पन्न नहीं करता।
- अंतर्निहित मॉडल फ़ाइल अब स्टोरेज में उपलब्ध नहीं है।
Name
429 - Too Many Requests
Description
आपने अपने पेंडिंग-टास्क कोटा या रेट लिमिट को पार कर लिया है।

Request

POST

/openapi/v1/print/analyze

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

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

# Also check wall thickness for a 100 mm tall SLA print
curl https://api.meshy.ai/openapi/v1/print/analyze \
-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/analyze/:id

प्रिंट-योग्यता विश्लेषण टास्क प्राप्त करें

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

पैरामीटर

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

रिटर्न

प्रिंट-योग्यता विश्लेषण टास्क ऑब्जेक्ट। printability फ़ील्ड तब तक null रहता है जब तक टास्क SUCCEEDED स्थिति तक नहीं पहुँच जाता। जब दीवार की मोटाई की जाँच की गई हो, तो printability में intended_print और thin_walls भी शामिल होते हैं।

Request

GET

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

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

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1715725401000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "warning",
    "issue_count": 1,
    "error_count": 0,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "evaluated_at": 1700000001000
  },
  "consumed_credits": 0
}

Response (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000012000,
  "expires_at": 1715725412000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "error",
    "issue_count": 2,
    "error_count": 1,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "intended_print": {
      "printer_type": "sla",
      "height_mm": 100,
      "longest_side_mm": 118,
      "wall_thickness_mm": 0.8,
      "dimensions_mm": [118, 72.41, 99.87]
    },
    "thin_walls": {
      "thin_area_ratio": 0.083,
      "has_thin_walls": true,
      "status": "error"
    },
    "evaluated_at": 1700000012000
  },
  "consumed_credits": 0
}

DELETE/openapi/v1/print/analyze/: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/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f

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

प्रिंट-योग्यता विश्लेषण कार्यों की सूची

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

पैरामीटर्स

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

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: निर्माण समय के आधार पर अवरोही क्रम में सॉर्ट करें।

रिटर्न्स

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

Request

GET

/openapi/v1/print/analyze

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

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-analyze",
    "status": "SUCCEEDED",
    "progress": 100,
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000001000,
    "expires_at": 1715725401000,
    "task_error": null,
    "printability": {
      "_version": "v1",
      "status": "warning",
      "issue_count": 1,
      "error_count": 0,
      "warning_count": 1,
      "metrics": {
        "is_watertight": true,
        "volume": 1.316167354292668,
        "non_manifold_edges": 0,
        "degenerate_faces": 43242,
        "holes": 0
      },
      "evaluated_at": 1700000001000
    },
    "consumed_credits": 0
  }
]

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

Stream an Analyze Printability Task

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

पैरामीटर

Name
id
Type
path
Description
स्ट्रीम करने के लिए प्रिंट-योग्यता विश्लेषण टास्क का यूनीक आइडेंटिफायर।

रिटर्न

Server-Sent Events के रूप में Analyze Printability Task Objects की एक स्ट्रीम लौटाता है।

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

Request

GET

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

curl -N https://api.meshy.ai/openapi/v1/print/analyze/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-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1715725401000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "warning",
    "issue_count": 1,
    "error_count": 0,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "evaluated_at": 1700000001000
  },
  "consumed_credits": 0
}

प्रिंट-योग्यता विश्लेषण Task Object

Name
id
Type
string
Description
टास्क के लिए यूनीक आइडेंटिफायर। हालांकि हम टास्क आइडी के लिए इम्प्लीमेंटेशन डिटेल के रूप में k-sortable UUID का उपयोग करते हैं, आपको आइडी के फॉर्मेट के बारे में कोई भी धारणा नहीं बनानी चाहिए।
Name
type
Type
string
Description
analyze-printability टास्क का प्रकार। इसका मान print-analyze है।
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
वह टाइमस्टैंप जब टास्क का परिणाम सिस्टम से एक्सपायर हो जाएगा, मिलीसेकंड में। यदि टास्क अभी समाप्त नहीं हुआ है तो 0।
Name
task_error
Type
object
Description
यदि टास्क विफल हो गया है तो एरर जानकारी। यदि टास्क विफल नहीं हुआ है तो यह प्रॉपर्टी null है। अधिक जानकारी के लिए एरर देखें।
- Name
  message
  Type
  string
  Description
  एरर मैसेज जो बताता है कि क्या गलत हुआ।
Name
printability
Type
object
Description
प्रिंट-योग्यता मूल्यांकन परिणाम। जब तक टास्क SUCCEEDED तक नहीं पहुँचता, यह null रहता है।
- Name
  _version
  Type
  string
  Description
  प्रिंट-योग्यता परिणाम का स्कीमा वर्शन। वर्तमान में v1।
- Name
  status
  Type
  string
  Description
  समग्र स्थिति। इनमें से एक:
  
  healthy: कोई एरर और कोई चेतावनी नहीं।
  
  warning: कम से कम एक चेतावनी, कोई एरर नहीं।
  
  error: कम से कम एक एरर।
  
  unknown: मॉडल का विश्लेषण नहीं किया जा सका।
  
  जब दीवार की मोटाई की जांच की गई थी, तो यह उपरोक्त जांचों और thin_walls.status में से सबसे खराब होता है। सबसे खराब से सबसे अच्छे तक: error, warning, unknown, healthy।
- Name
  issue_count
  Type
  integer
  Description
  समस्याओं की कुल संख्या, जो error_count + warning_count के बराबर है।
- Name
  error_count
  Type
  integer
  Description
  एरर-स्तर की समस्याओं की संख्या। एरर तब उत्पन्न होती हैं जब मॉडल वॉटरटाइट नहीं है, उसका आयतन शून्य से कम या बराबर है, या उसमें नॉन-मैनिफोल्ड किनारे हैं। जब दीवार की मोटाई की जांच की गई थी, तो बहुत पतली दीवारें (thin_walls.status error है) एक और एरर के रूप में गिनी जाती हैं।
- Name
  warning_count
  Type
  integer
  Description
  चेतावनी-स्तर की समस्याओं की संख्या। चेतावनियां तब उत्पन्न होती हैं जब मॉडल में डिजेनरेट फेस या छेद होते हैं।
- Name
  metrics
  Type
  object
  Description
  एवेल्युएटर द्वारा लौटाए गए रॉ ज्यामिति मेट्रिक्स।
  Name
  is_watertight
  Type
  boolean
  Description
  true जब मेश में कोई बाउंड्री किनारे नहीं हैं (यानी, बंद है)।
  Name
  volume
  Type
  number
  Description
  मॉडल का आयतन क्यूबिक मीटर में।
  Name
  non_manifold_edges
  Type
  integer
  Description
  नॉन-मैनिफोल्ड किनारों की संख्या।
  Name
  degenerate_faces
  Type
  integer
  Description
  डिजेनरेट फेस (ज़ीरो-एरिया या अमान्य फेस) की संख्या।
  Name
  holes
  Type
  integer
  Description
  मेश में छेद (बाउंड्री लूप) की संख्या।
- Name
  intended_print
  Type
  object
  Description
  दीवार की मोटाई की जांच में उपयोग किए गए प्रिंटर और साइज़। केवल तब मौजूद होता है जब दीवार की मोटाई की जांच की गई थी।
  Name
  printer_type
  Type
  string
  Description
  fdm, sla, या full_color।
  Name
  height_mm
  Type
  number
  Description
  प्रिंट की ऊंचाई मिलीमीटर में, यदि प्रिंट को ऊंचाई के अनुसार साइज़ किया गया था। अन्यथा null।
  Name
  longest_side_mm
  Type
  number
  Description
  प्रिंट की सबसे लंबी भुजा मिलीमीटर में। जब ऊंचाई के अनुसार साइज़ किया जाता है, तो इसकी गणना मॉडल के अनुपात से की जाती है।
  Name
  wall_thickness_mm
  Type
  number
  Description
  printer_type के लिए न्यूनतम दीवार की मोटाई, मिलीमीटर में। इससे पतली दीवारों को बहुत पतला बताया जाता है।
  Name
  dimensions_mm
  Type
  array
  Description
  प्रिंट की [width, depth, height] मिलीमीटर में। ऊंचाई height_mm से एक मिलीमीटर के अंश से भिन्न हो सकती है। non-GLB इनपुट के लिए null, या यदि मॉडल का साइज़ निर्धारित नहीं किया जा सकता।
- Name
  thin_walls
  Type
  object
  Description
  दीवार-मोटाई का परिणाम। केवल तब मौजूद होता है जब दीवार की मोटाई की जांच की गई थी।
  Name
  thin_area_ratio
  Type
  number
  Description
  सतह का वह हिस्सा, 0 से 1 तक, जो intended_print.wall_thickness_mm से पतला है। यदि मॉडल को मापा नहीं जा सका तो null।
  Name
  has_thin_walls
  Type
  boolean
  Description
  true यदि सतह का कोई भी हिस्सा बहुत पतला है। अकेले तीखे कोने भी इसे सेट कर सकते हैं, इसलिए यह तय करने के लिए कि दीवारों को मोटा करने की आवश्यकता है या नहीं, status का उपयोग करें। यदि मॉडल को मापा नहीं जा सका तो null।
  Name
  status
  Type
  string
  Description
  दीवार-मोटाई का निर्णय। इनमें से एक:
  
  healthy: सतह का 5% या उससे कम हिस्सा बहुत पतला है।
  
  error: सतह का 5% से अधिक हिस्सा बहुत पतला है। दीवारों को मोटा करने के लिए, इस टास्क की id को input_task_id के रूप में प्रिंट-योग्यता मरम्मत को पास करें (.stl, .fbx, या .gltf model_url के लिए, इसके बजाय फ़ाइल को model_url के रूप में भेजें)।
  
  unknown: मॉडल को मापा नहीं जा सका। यदि दीवार-मोटाई की जांच स्वयं विफल हो जाती है, तो टास्क FAILED के साथ समाप्त होता है।
- Name
  evaluated_at
  Type
  timestamp
  Description
  वह टाइमस्टैंप जब विश्लेषण की गणना की गई थी, epoch के बाद से मिलीसेकंड में।
Name
consumed_credits
Type
integer
Description
हमेशा 0। यह एंडपॉइंट मुफ्त है।

The Analyze Printability Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1715725401000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "warning",
    "issue_count": 1,
    "error_count": 0,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "evaluated_at": 1700000001000
  },
  "consumed_credits": 0
}

The Analyze Printability Task Object (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000012000,
  "expires_at": 1715725412000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "error",
    "issue_count": 2,
    "error_count": 1,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "intended_print": {
      "printer_type": "sla",
      "height_mm": 100,
      "longest_side_mm": 118,
      "wall_thickness_mm": 0.8,
      "dimensions_mm": [118, 72.41, 99.87]
    },
    "thin_walls": {
      "thin_area_ratio": 0.083,
      "has_thin_walls": true,
      "status": "error"
    },
    "evaluated_at": 1700000012000
  },
  "consumed_credits": 0
}