API Phân tích khả năng in

Kiểm tra một mô hình 3D để phát hiện các vấn đề khi in bằng cách đo độ kín nước, thể tích, lỗ hổng, cạnh non-manifold và mặt suy biến của mô hình. Bạn cũng có thể kiểm tra độ dày thành ở kích thước mà bạn dự định in.

POST/openapi/v1/print/analyze

Tạo một tác vụ Phân tích khả năng in

Tạo một tác vụ Phân tích khả năng in, tác vụ này đánh giá một mô hình 3D và báo cáo các chỉ số khả năng in của nó. Tác vụ chạy ở chế độ nền. Để biết một tác vụ thường mất bao lâu, xem Thời gian xử lý.

Khi Meshy đã có kết quả khả năng in cho tác vụ input_task_id, tác vụ mới sẽ sẵn sàng ngay lập tức. Lệnh GET đầu tiên của bạn trên tác vụ đó sẽ trả về kết quả.

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

Tham số

Name
input_task_id
Type
string
Bắt buộc
Description
Bắt buộc trừ khi bạn gửi model_url. ID của tác vụ có mô hình mà bạn muốn phân tích. Tác vụ phải có trạng thái SUCCEEDED, và phải là của bạn hoặc thuộc một không gian làm việc mà bạn là thành viên.
Nó có thể là một trong các loại tác vụ sau, sử dụng Meshy 6 trở lên, bao gồm cả Meshy 7:
Một tác vụ Sửa khả năng in cũng hoạt động được.

Name
model_url
Type
string
Bắt buộc
Description
Bắt buộc trừ khi bạn gửi input_task_id. Mô hình cần phân tích, dưới dạng một URL công khai hoặc một Data URI. Nếu bạn gửi cả hai, Meshy sẽ sử dụng input_task_id.
Từ một URL http hoặc https, mô hình phải là tệp .glb, .gltf, .obj, .fbx, hoặc .stl có dung lượng tối đa 400 MB. Một Data URI chỉ có thể chứa tệp GLB base64 (data:model/gltf-binary;base64,...) hoặc glTF (data:model/gltf+json;base64,...) với dung lượng tối đa 100 MB. Hãy gửi tệp .obj, .fbx, hoặc .stl dưới dạng URL http hoặc https.
Một tệp trên 100 MB cũng phải tuân theo các quy tắc sau:
- Tệp GLB, glTF, FBX, hoặc OBJ có thể có tối đa 10.000.000 mặt. Meshy đếm số mặt theo tam giác, vì vậy một tứ giác được tính là 2, và một lưới được vẽ nhiều lần được tính một lần cho mỗi bản sao.
- Tệp FBX phải là FBX nhị phân phiên bản 7.1 trở lên.
- Tệp GLB hoặc glTF không được sử dụng nén Draco.
Một URL tải xuống của Meshy (assets.meshy.ai/…?Expires=…&Signature=…) đã được ký và sẽ ngừng hoạt động vào thời điểm expires_at của tác vụ đó. Việc đọc lại tác vụ không làm gia hạn URL này. Đối với một mô hình bạn đã tạo bằng Meshy, hãy gửi input_task_id thay vào đó, cách này sẽ hoạt động miễn là Meshy vẫn còn lưu giữ tác vụ gốc (xem Lưu giữ tài nguyên). Để sử dụng mô hình sau thời điểm đó, hãy tải nó xuống trước expires_at và gửi bản sao của riêng bạn.

Để kiểm tra thêm độ dày thành ở kích thước bạn dự định in, hãy gửi printer_type, một kích thước in, hoặc cả hai. Kết quả nằm trong printability.thin_walls. Việc kiểm tra độ dày thành mất nhiều thời gian hơn, vì vậy tác vụ thường không sẵn sàng ngay lập tức, ngay cả khi Meshy đã phân tích mô hình trước đó.

Name
printer_type
Type
string
Description
Máy in bạn dự định sử dụng. Nó thiết lập độ dày thành tối thiểu cho việc kiểm tra độ dày thành. Nếu bạn gửi một kích thước in mà không có printer_type, Meshy sẽ sử dụng fdm.
Các giá trị khả dụng:
- fdm: sợi nhựa, độ dày thành tối thiểu 1,0 mm
- sla: nhựa resin, độ dày thành tối thiểu 0,8 mm
- full_color: in đa màu, độ dày thành tối thiểu 2,0 mm
Bất kỳ giá trị nào khác sẽ trả về 400.
Name
intended_print_height_mm
Type
number
Description
Chiều cao của bản in, tính bằng milimét, từ 1 đến 1000. Giá trị nằm ngoài phạm vi sẽ trả về 400. Gửi tham số này hoặc intended_print_longest_side_mm, không gửi cả hai.
Nó chỉ hoạt động với đầu vào GLB. Đối với model_url không phải là tệp .glb, hãy gửi intended_print_longest_side_mm thay vào đó.
Name
intended_print_longest_side_mm
Type
number
Description
Chiều dài cạnh dài nhất của bản in, tính bằng milimét, từ 1 đến 1000. Giá trị nằm ngoài phạm vi sẽ trả về 400. Nó hoạt động với mọi định dạng đầu vào.

Nếu bạn gửi printer_type mà không có kích thước, Meshy sẽ sử dụng kích thước in sau:

Tệp .glb hoặc bất kỳ input_task_id nào: cao 150 mm
Tệp .stl: cạnh dài nhất của chính tệp đó, được đọc theo đơn vị milimét
Tệp .obj, .fbx, hoặc .gltf: 150 mm ở cạnh dài nhất

Đối với tệp STL dùng đơn vị khác, hãy gửi intended_print_longest_side_mm.

Meshy làm tròn cả hai kích thước in đến milimét gần nhất.

Kết quả trả về

Trường result của phản hồi chứa ID của tác vụ Phân tích khả năng in mới.

Các chế độ lỗi

Name
400 - Bad Request
Description
Yêu cầu không thể chạy. Thông báo lỗi cho biết vấn đề nào đã được phát hiện. Ví dụ:
- Thiếu tham số: Không có input_task_id lẫn model_url nào được gửi.
- UUID không hợp lệ: input_task_id không phải là một UUID hợp lệ.
- URL mô hình không hợp lệ: model_url không đúng định dạng, sử dụng một lược đồ không được hỗ trợ, hoặc có phần mở rộng tệp không được hỗ trợ.
- Tệp mô hình quá lớn: Tệp model_url vượt quá 400 MB từ URL http hoặc https, hoặc vượt quá 100 MB dưới dạng Data URI.
- Quá nhiều mặt: Tệp model_url là tệp GLB, glTF, FBX, hoặc OBJ trên 100 MB có nhiều hơn 10.000.000 mặt. Hãy giảm số lượng mặt, sau đó gửi lại tệp.
- FBX ASCII trên 100 MB: Tệp model_url là tệp FBX dạng ASCII trên 100 MB. Hãy gửi nó dưới dạng FBX nhị phân hoặc GLB.
- Tệp mô hình không đọc được: Tệp model_url trên 100 MB, và Meshy không thể đọc header của nó. Ví dụ, đó là tệp GLB hoặc glTF được nén Draco, hoặc tệp FBX nhị phân cũ hơn phiên bản 7.1.
- Header mô hình quá phức tạp: Tệp model_url trên 100 MB, và header của nó có quá nhiều lưới, node, hoặc bản ghi để kiểm tra. Hãy giảm số lượng đối tượng trong tệp, sau đó gửi lại.
- Không thể tải xuống tệp mô hình: model_url trả về lỗi, thường là do URL tải xuống đã ký của Meshy đã hết hạn. Việc đọc lại tác vụ sẽ trả về cùng một URL với cùng thời hạn hết hạn đó. Hãy gửi bản sao của riêng bạn về tệp, hoặc gửi input_task_id trong khi Meshy vẫn còn lưu giữ tác vụ gốc.
- Tác vụ chưa thành công: Tác vụ input_task_id vẫn đang chờ xử lý, đang tiến hành, hoặc đã thất bại.
- Kích thước in không hợp lệ: intended_print_height_mm hoặc intended_print_longest_side_mm nằm ngoài khoảng 1 đến 1000, hoặc yêu cầu có cả hai tham số.
- Loại máy in không xác định: printer_type không phải là fdm, sla, hoặc full_color.
- Chiều cao trên một mô hình không phải GLB: Yêu cầu có intended_print_height_mm và một model_url không phải là tệp .glb. Hãy gửi intended_print_longest_side_mm thay vào đó.
- Không thể định cỡ mô hình này theo chiều cao: Ở chiều cao được yêu cầu, hoặc mặc định 150 mm, cạnh dài nhất của mô hình sẽ nằm ngoài khoảng 1 đến 1.000 mm. Điều này cũng xảy ra khi mô hình phẳng, hoặc khi Meshy không thể xác định kích thước của nó. Hãy gửi intended_print_longest_side_mm thay vào đó. Đối với một model_url dạng .glb và một số tác vụ input_task_id, Meshy chỉ phát hiện điều này sau khi tác vụ bắt đầu, và tác vụ sẽ kết thúc với trạng thái FAILED thay vì thành công.
- Kích thước STL không sử dụng được: Yêu cầu có printer_type mà không có kích thước, và Meshy không thể đọc được cạnh dài nhất của chính tệp .stl, hoặc nó nằm ngoài khoảng 1 đến 1.000 mm. Hãy gửi intended_print_longest_side_mm.
Hãy sửa yêu cầu, sau đó gửi lại. Xem Lỗi.
Name
401 - Unauthorized
Description
Thiếu khóa API hoặc khóa API không hợp lệ. Hãy kiểm tra header Authorization.
Name
403 - Forbidden
Description
input_task_id là một mô hình phù điêu (bas-relief), mà endpoint này không thể phân tích. Thông báo là This model type does not support this operation. Hãy gửi một mô hình khác.
Name
404 - Not Found
Description
Meshy không thể tìm thấy mô hình để phân tích cho input_task_id. Ví dụ:
- Tác vụ không tồn tại, đã bị xóa, hoặc không phải của bạn hay thuộc một không gian làm việc mà bạn là thành viên.
- Tác vụ sử dụng một mô hình cũ hơn Meshy 6, hoặc loại tác vụ đó không tạo ra mô hình 3D.
- Tệp mô hình của tác vụ không còn trong bộ lưu trữ.
Hãy kiểm tra xem input_task_id có phải là một tác vụ được hỗ trợ và là của bạn hoặc thuộc một trong các không gian làm việc của bạn hay không, hoặc gửi mô hình dưới dạng model_url.
Name
429 - Too Many Requests
Description
Bạn đã vượt quá giới hạn tốc độ, hoặc bạn có quá nhiều tác vụ đang chờ xử lý. Hãy đợi, sau đó thử lại. Xem Giới hạn tốc độ.

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

Lấy một tác vụ Phân tích khả năng in

Trả về một tác vụ Phân tích khả năng in dựa trên ID của nó.

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
}

Tham số

Name
id
Type
path
Description
ID tác vụ từ phản hồi tạo tác vụ.

Giá trị trả về

Đối tượng tác vụ Phân tích khả năng in. Trường printability của nó không xuất hiện cho đến khi tác vụ ở trạng thái SUCCEEDED. Khi Meshy đã kiểm tra độ dày thành, printability cũng bao gồm intended_print và thin_walls.

DELETE/openapi/v1/print/analyze/:id

Xóa một tác vụ Phân tích khả năng in

Xóa vĩnh viễn một tác vụ Phân tích khả năng in, bao gồm cả kết quả đã lưu trong bộ nhớ đệm. Bạn không thể hoàn tác việc xóa.

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

Tham số đường dẫn

Name
id
Type
path
Description
ID của tác vụ cần xóa.

Trạng thái tác vụ

Xóa một tác vụ đang ở trạng thái PENDING sẽ hoàn lại số tín dụng đã sử dụng khi bạn tạo tác vụ đó.

Một tác vụ đang ở trạng thái IN_PROGRESS không thể bị xóa. Yêu cầu sẽ trả về 409 Conflict, và tác vụ vẫn tiếp tục chạy. Meshy không hoàn lại tín dụng cho một tác vụ đã bắt đầu chạy, vì vậy việc xóa nó sẽ khiến bạn mất cả tín dụng lẫn kết quả. Hãy đợi cho đến khi tác vụ đạt trạng thái SUCCEEDED, FAILED, hoặc CANCELED, rồi mới xóa nó.

Xóa một tác vụ đang ở trạng thái cuối cùng (SUCCEEDED, FAILED, hoặc CANCELED) sẽ không hoàn lại tín dụng.

Giá trị trả về

200 OK khi tác vụ được xóa thành công, hoặc 409 Conflict khi tác vụ đang ở trạng thái IN_PROGRESS.

GET/openapi/v1/print/analyze

List Analyze Printability tasks

Trả về danh sách các tác vụ Phân tích khả năng in của bạn.

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

Tham số

Name
page_num
Type
integer
mặc định 1
Description
Số trang cần trả về, bắt đầu từ 1.
Name
page_size
Type
integer
mặc định 10
Description
Số lượng tác vụ trên mỗi trang, tối đa 100.
Name
sort_by
Type
string
Description
Thứ tự sắp xếp.
Các giá trị khả dụng:
- +created_at: cũ nhất trước
- -created_at: mới nhất trước

Trả về

Một danh sách phân trang các đối tượng tác vụ Phân tích khả năng in.

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

Stream một task Phân tích khả năng in

Truyền trực tuyến các cập nhật của task Phân tích khả năng in dưới dạng Server-Sent Events (SSE).

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 following PENDING frame 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
}

Tham số

Name
id
Type
path
Description
ID của task từ phản hồi tạo task.

Giá trị trả về

Một luồng đối tượng task Phân tích khả năng in dưới dạng Server-Sent Events.

Mỗi sự kiện chứa toàn bộ đối tượng task, có cùng cấu trúc với những gì endpoint Get trả về. Trong khi task đang ở trạng thái PENDING hoặc IN_PROGRESS, các trường đầu ra của nó sẽ trống (null, [], hoặc {}), và finished_at là 0. Meshy chỉ gửi trường printability sau khi task đạt trạng thái SUCCEEDED.

Đối tượng tác vụ Analyze Printability

Đối tượng tác vụ Analyze Printability mô tả một lần phân tích của một mô hình 3D. Nó lưu giữ trạng thái, progress, và kết quả khả năng in khi tác vụ thành công.

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
}

Name
id
Type
string
Description
ID của tác vụ. Hãy coi đây là một chuỗi không minh bạch (opaque), và đừng phụ thuộc vào định dạng của nó.
Name
type
Type
string
Description
Loại tác vụ, luôn là print-analyze.
Name
status
Type
string
Description
Trạng thái của tác vụ, là một trong các giá trị PENDING, IN_PROGRESS, SUCCEEDED, FAILED, hoặc CANCELED.
Name
progress
Type
integer
Description
Mức độ hoàn thành của tác vụ, tính theo phần trăm. Giá trị này là 0 cho đến khi tác vụ bắt đầu và 100 khi nó thành công.
Name
preceding_tasks
Type
integer
Description
Số lượng tác vụ đứng trước tác vụ này trong hàng đợi. Giá trị này chỉ có ý nghĩa khi tác vụ đang ở trạng thái PENDING.
Name
created_at
Type
timestamp
Description
Thời điểm tác vụ được tạo, tính bằng mili giây Unix.
Name
started_at
Type
timestamp
Description
Thời điểm tác vụ bắt đầu, tính bằng mili giây Unix. Giá trị này là 0 cho đến khi tác vụ bắt đầu.
Name
finished_at
Type
timestamp
Description
Thời điểm tác vụ kết thúc, tính bằng mili giây Unix. Giá trị này là 0 cho đến khi tác vụ kết thúc.
Name
expires_at
Type
timestamp
Description
Thời điểm kết quả của tác vụ hết hạn, tính bằng mili giây Unix. Giá trị này là 0 cho đến khi tác vụ kết thúc.
Name
task_error
Type
object
Description
Chi tiết lỗi khi tác vụ thất bại. Giá trị này là null nếu tác vụ chưa thất bại. Xem Lỗi.
- Name
  message
  Type
  string
  Description
  Mô tả về vấn đề đã xảy ra.
Name
printability
Type
object
Description
Kết quả của việc phân tích. Trường này không xuất hiện cho đến khi tác vụ đạt trạng thái SUCCEEDED.
- Name
  _version
  Type
  string
  Description
  Phiên bản schema của kết quả khả năng in. Giá trị là v1.
- Name
  status
  Type
  string
  Description
  Kết luận tổng thể, là một trong các giá trị:
  
  healthy: không có lỗi và không có cảnh báo
  
  warning: có ít nhất một cảnh báo, và không có lỗi
  
  error: có ít nhất một lỗi
  
  unknown: Meshy không thể phân tích mô hình
  
  Khi Meshy kiểm tra độ dày thành, đây là giá trị tệ hơn giữa các kiểm tra lưới và thin_walls.status. Theo thứ tự từ tệ nhất đến tốt nhất là error, warning, unknown, và healthy.
- Name
  issue_count
  Type
  integer
  Description
  Tổng số vấn đề, bằng error_count + warning_count.
- Name
  error_count
  Type
  integer
  Description
  Số lượng vấn đề ở mức lỗi. Meshy tính một lỗi cho mỗi trường hợp sau:
  
  Mô hình không kín nước (watertight) và có nhiều hơn 8 lỗ.
  
  Mô hình có nhiều hơn 8 lỗ.
  
  Thể tích bằng 0 hoặc nhỏ hơn.
  
  Mô hình có nhiều hơn 50 cạnh non-manifold.
  
  Khi Meshy kiểm tra độ dày thành, các thành quá mỏng (thin_walls.status là error) được tính là thêm một lỗi.
- Name
  warning_count
  Type
  integer
  Description
  Số lượng vấn đề ở mức cảnh báo. Meshy tính một cảnh báo cho mỗi trường hợp sau:
  
  Mô hình không kín nước và có từ 8 lỗ trở xuống.
  
  Mô hình có từ 1 đến 8 lỗ.
  
  Mô hình có từ 1 đến 50 cạnh non-manifold.
  
  Mô hình có mặt suy biến.
- Name
  metrics
  Type
  object
  Description
  Các số liệu đo hình học thô của mô hình.
  Name
  is_watertight
  Type
  boolean
  Description
  true khi lưới không có cạnh biên, tức là khi nó khép kín.
  Name
  volume
  Type
  number
  Description
  Thể tích của mô hình, tính bằng mét khối.
  Name
  non_manifold_edges
  Type
  integer
  Description
  Số lượng cạnh non-manifold.
  Name
  degenerate_faces
  Type
  integer
  Description
  Số lượng mặt suy biến, là những mặt có diện tích bằng 0 hoặc là mặt không hợp lệ.
  Name
  holes
  Type
  integer
  Description
  Số lượng lỗ trong lưới, được đếm dưới dạng các vòng biên.
- Name
  intended_print
  Type
  object
  Description
  Máy in và kích thước mà quá trình kiểm tra độ dày thành đã sử dụng. Chỉ xuất hiện khi Meshy kiểm tra độ dày thành.
  Name
  printer_type
  Type
  string
  Description
  Loại máy in, fdm, sla, hoặc full_color.
  Name
  height_mm
  Type
  number
  Description
  Chiều cao bản in, tính bằng milimét, khi bản in được định kích thước theo chiều cao. Nếu không, giá trị này là null.
  Name
  longest_side_mm
  Type
  number
  Description
  Chiều dài cạnh dài nhất của bản in, tính bằng milimét. Khi bản in được định kích thước theo chiều cao, Meshy tính giá trị này dựa trên tỷ lệ của mô hình.
  Name
  wall_thickness_mm
  Type
  number
  Description
  Độ dày thành tối thiểu cho printer_type, tính bằng milimét. Meshy báo cáo những thành mỏng hơn mức này là quá mỏng.
  Name
  dimensions_mm
  Type
  array
  Description
  [chiều rộng, chiều sâu, chiều cao] của bản in, tính bằng milimét. Chiều cao có thể khác height_mm một phần nhỏ của milimét. Giá trị này là null đối với đầu vào không phải GLB, hoặc khi Meshy không thể xác định kích thước của mô hình.
- Name
  thin_walls
  Type
  object
  Description
  Kết quả của việc kiểm tra độ dày thành. Chỉ xuất hiện khi Meshy kiểm tra độ dày thành.
  Name
  thin_area_ratio
  Type
  number
  Description
  Tỷ lệ phần bề mặt mỏng hơn intended_print.wall_thickness_mm, từ 0 đến 1. Giá trị này là null khi Meshy không thể đo mô hình.
  Name
  has_thin_walls
  Type
  boolean
  Description
  true nếu bất kỳ phần nào của bề mặt quá mỏng. Chỉ riêng các góc sắc nhọn cũng có thể khiến giá trị này là true, vì vậy hãy dùng status để quyết định liệu các thành có cần được làm dày hơn hay không. Giá trị này là null khi Meshy không thể đo mô hình.
  Name
  status
  Type
  string
  Description
  Kết luận về độ dày thành, là một trong các giá trị:
  
  healthy: 5% hoặc ít hơn bề mặt quá mỏng.
  
  error: hơn 5% bề mặt quá mỏng. Để làm dày các thành, hãy gửi id của tác vụ này đến Sửa khả năng in dưới dạng input_task_id. Nếu tác vụ này đã phân tích một tệp .stl, .fbx, hoặc .gltf từ model_url, hãy gửi tệp đó dưới dạng model_url thay thế.
  
  unknown: Meshy không thể đo mô hình. Nếu bản thân việc kiểm tra độ dày thành thất bại, tác vụ sẽ kết thúc với trạng thái FAILED.
- Name
  evaluated_at
  Type
  timestamp
  Description
  Thời điểm Meshy tính toán việc phân tích, tính bằng mili giây Unix.
Name
consumed_credits
Type
integer
Description
Số lượng tín dụng mà tác vụ đã sử dụng. Giá trị này luôn là 0, vì việc phân tích là miễn phí.