API Sửa khả năng in

Sửa một mô hình 3D để sẵn sàng cho việc in. Meshy khắc phục các cạnh non-manifold, mặt suy biến, lỗ hổng và các vấn đề topology khác. Bạn cũng có thể làm dày các bức tường quá mỏng theo kích thước bạn dự định in.

POST/openapi/v1/print/repair

Create a Repair Printability task

Tạo một tác vụ Sửa khả năng in, giúp sửa topology của mô hình 3D và trả về phiên bản kín nước (watertight) sẵn sàng để in. Tác vụ chạy ở chế độ nền. Để biết thời gian xử lý thường mất bao lâu, xem Thời gian xử lý.

Mô hình đã sửa có cùng định dạng với đầu vào. Ví dụ, với một file .stl trong model_url, model_urls.stl sẽ chứa lưới đã sửa, và model_urls không có khóa định dạng nào khác. Với input_task_id, Meshy luôn sửa file GLB của tác vụ nguồn, vì vậy đầu ra là một file .glb.

Meshy loại bỏ texture của mô hình trong quá trình sửa, vì hình học thay đổi. Để thêm lại texture, hãy gửi mô hình đã sửa đến Retexture API.

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

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 bạn muốn sửa, ví dụ một tác vụ Ảnh sang 3D, Nhiều ảnh sang 3D, Văn bản sang 3D, Remesh, Tạo lại texture, hoặc Phân tích khả năng in. Tác vụ đó phải do bạn tạo bằng API, có trạng thái SUCCEEDED và có mô hình GLB.
Một tác vụ Phân tích khả năng in đã kiểm tra độ dày thành cũng sẽ truyền lại loại máy in và kích thước của nó. Việc sửa sau đó sẽ kiểm tra độ dày thành và làm dày các thành mỏng, ngay cả khi bạn không gửi cả hai. Một printer_type hoặc kích thước in mà bạn gửi sẽ thay thế giá trị từ bước phân tích. Một tác vụ Phân tích khả năng in trên file .stl, .fbx, hoặc .gltf từ model_url sẽ không hoạt động. Hãy gửi file đó dưới dạng model_url thay vì vậy.

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 sửa, dưới dạng URL công khai hoặc data URI. Nếu bạn gửi cả hai, Meshy sẽ dùng input_task_id.
Từ một URL http hoặc https, mô hình phải là file .glb, .gltf, .obj, .fbx, hoặc .stl tối đa 400 MB. Một data URI chỉ có thể chứa file GLB dạng base64 (data:model/gltf-binary;base64,...) hoặc glTF (data:model/gltf+json;base64,...) tối đa 100 MB. Hãy gửi file .obj, .fbx, hoặc .stl dưới dạng URL http hoặc https.
Một file trên 100 MB cũng phải tuân theo các quy tắc sau:
- Một file GLB, glTF, FBX, hoặc OBJ có thể có tối đa 10.000.000 mặt (face). Meshy đếm mặt dưới dạng tam giác, vì vậy một tứ giác tính là 2, và một lưới được vẽ nhiều lần tính một lần cho mỗi bản sao.
- Một file FBX phải là FBX nhị phân (binary) phiên bản 7.1 trở lên.
- Một file GLB hoặc glTF không được 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ụ đó. Đọc lại tác vụ không làm mới URL này. Với mô hình bạn tạo bằng Meshy, hãy gửi input_task_id thay vì vậy, vì nó vẫn hoạt động miễn là Meshy còn lưu giữ tác vụ nguồn (xem Lưu giữ tài nguyên). Để 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.

Name
alpha_thumbnail
Type
boolean
mặc định false
Description
Có kết xuất thêm bản xem trước với nền trong suốt (RGBA) hay không, được trả về trong alpha_thumbnail_url khi bạn lấy thông tin tác vụ. thumbnail_url không thay đổi.

Để đồng thời làm dày các thành quá mỏng ở kích thước bạn dự định in, hãy gửi printer_type, kích thước in, hoặc cả hai. Meshy chỉ làm dày các thành khi hơn 5% bề mặt quá mỏng đối với máy in đó. Mô hình đã sửa giữ nguyên tỉ lệ gốc. Để thay đổi tỉ lệ, hãy dùng Resize API, với kích thước tính bằng mét, vì vậy 100 mm là 0.1.

Name
printer_type
Type
string
Description
Loại máy in bạn dự định sử dụng. Giá trị này quy định độ dày thành tối thiểu mà việc sửa hướng tới. Nếu bạn gửi kích thước in mà không có printer_type, Meshy sẽ dùng fdm, trừ khi một tác vụ Phân tích khả năng in trong input_task_id cung cấp loại máy in.
Các giá trị khả dụng:
- fdm: sợi nhựa (filament), thành tối thiểu 1.0 mm
- sla: nhựa resin, thành tối thiểu 0.8 mm
- full_color: full-color, 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ị ngoài phạm vi này 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 là GLB. Với model_url không phải là file .glb, hãy gửi intended_print_longest_side_mm thay vì vậy.
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ị ngoài phạm vi này 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, và Meshy không dùng lại kích thước nào từ một tác vụ Phân tích khả năng in, Meshy sẽ dùng kích thước in sau:

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

Với file 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.

Giá trị trả về

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

Các trường hợp thất bại

Name
400 - Bad Request
Description
Yêu cầu không thể thực hiện. Thông báo lỗi cho biết vấn đề đã phát hiện. Ví dụ:
- Thiếu tham số: Không gửi cả input_task_id lẫn model_url.
- UUID không hợp lệ: input_task_id không phải là UUID hợp lệ.
- URL mô hình không hợp lệ: model_url có định dạng sai, dùng scheme không được hỗ trợ, hoặc có phần mở rộng file không được hỗ trợ.
- File mô hình quá lớn: File model_url vượt quá 400 MB khi dùng URL http hoặc https, hoặc vượt quá 100 MB khi dùng data URI.
- Quá nhiều mặt: File model_url là file GLB, glTF, FBX, hoặc OBJ trên 100 MB với hơn 10.000.000 mặt. Hãy giảm số lượng mặt rồi gửi lại file.
- FBX ASCII trên 100 MB: File model_url là FBX dạng ASCII trên 100 MB. Hãy gửi nó dưới dạng FBX nhị phân hoặc GLB.
- File mô hình không đọc được: File model_url trên 100 MB, và Meshy không đọc được header của nó. Ví dụ, đó là file GLB hoặc glTF nén Draco, hoặc file FBX nhị phân cũ hơn phiên bản 7.1.
- Header mô hình quá phức tạp: File model_url trên 100 MB, và header của nó có quá nhiều lưới, nút, hoặc bản ghi để kiểm tra. Hãy giảm số lượng đối tượng trong file rồi gửi lại.
- Không thể tải xuống file 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. Đọ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 file của riêng bạn, hoặc gửi input_task_id trong khi Meshy vẫn còn lưu giữ tác vụ nguồn.
- Tác vụ chưa thành công: Tác vụ input_task_id vẫn đang chờ xử lý, đang xử lý, hoặc đã thất bại.
- Thiếu GLB: Tác vụ input_task_id không có mô hình GLB để sửa.
- 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.
- 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ô hình không phải GLB: Yêu cầu có intended_print_height_mm và model_url không phải là file .glb. Hãy gửi intended_print_longest_side_mm thay vì vậy.
- Không thể định kích thướ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 xác định được kích thước của nó. Hãy gửi intended_print_longest_side_mm thay vì vậy. Với model_url dạng .glb và một số tác vụ input_task_id, Meshy chỉ phát hiện được điều này sau khi tác vụ bắt đầu, và khi đó tác vụ sẽ kết thúc với trạng thái FAILED.
- 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 đọc được cạnh dài nhất của chính file .stl, hoặc giá trị đó nằm ngoài khoảng 1 đến 1.000 mm. Hãy gửi intended_print_longest_side_mm.
Sửa lại yêu cầu rồi 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
402 - Payment Required
Description
Ví dụ:
- Không đủ tín dụng: Tài khoản không có đủ tín dụng cho tác vụ này, hoặc tài khoản đã đạt giới hạn tín dụng. Hãy kiểm tra số dư tín dụng của bạn rồi thử lại.
- Gói miễn phí: Việc tạo tác vụ yêu cầu gói trả phí. Hãy nâng cấp gói của bạn trong cài đặt đăng ký rồi thử lại.
Name
403 - Forbidden
Description
input_task_id là một mô hình bas-relief, mà endpoint này không thể sửa. 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
Tác vụ input_task_id không tồn tại hoặc thuộc về người dùng khác. Hãy kiểm tra ID, và dùng khóa API của tài khoản đã tạo tác vụ đó.
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 rồi thử lại. Xem Giới hạn tốc độ.

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

Lấy một tác vụ Sửa khả năng in

Trả về một tác vụ Sửa khả năng in theo ID của nó.

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": {
    "stl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.stl?Expires=***"
  },
  "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=***"
  },
  "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
  }
}

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ụ Sửa khả năng in. Trường model_urls của nó sẽ trống cho đến khi tác vụ ở trạng thái SUCCEEDED. Sau đó, nó chỉ chứa khóa khớp với định dạng đầu vào. Một tác vụ sửa độ dày thành bao gồm intended_print ngay từ đầu, và print_repair_report sau khi tác vụ hoàn thành thành công.

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

Xóa một tác vụ Sửa khả năng in

Xóa vĩnh viễn một tác vụ Sửa khả năng in, bao gồm cả mô hình đã được sửa của nó. Bạn không thể hoàn tác việc xóa.

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 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ụ 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ụ 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 tín dụng cho một tác vụ đã bắt đầu, 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ụ ở trạng thái cuối cùng (SUCCEEDED, FAILED, hoặc CANCELED) sẽ không hoàn lại tín dụng của tác vụ đó.

Giá trị trả về

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

GET/openapi/v1/print/repair

List Repair Printability tasks

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

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=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
    "texture_urls": [],
    "consumed_credits": 10
  }
]

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

Giá trị trả về

Một danh sách có phân trang gồm các đối tượng tác vụ Sửa khả năng in.

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

Stream một tác vụ Sửa khả năng in

Stream các cập nhật của một tác vụ Sửa khả năng in dưới dạng Server-Sent Events (SSE).

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 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-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=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

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ề

Một luồng các đối tượng tác vụ Sửa khả năng in dưới dạng Server-Sent Events.

Mỗi sự kiện chứa toàn bộ đối tượng tác vụ, có cùng cấu trúc như endpoint Get trả về. Trong khi tác vụ đ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. model_urls là một đối tượng rỗng cho đến khi tác vụ ở trạng thái SUCCEEDED.

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

Một đối tượng tác vụ Sửa khả năng in mô tả một lần sửa của một mô hình 3D. Nó lưu trữ trạng thái, progress, và mô hình đã được sửa khi tác vụ thành công.

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=***"
  },
  "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=***"
  },
  "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
  }
}

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-repair.
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à là 100 khi tác vụ 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
Thông tin chi tiết về 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ề lỗi đã xảy ra.
Name
model_urls
Type
object
Description
URL tải xuống cho mô hình đã được sửa. Đối tượng này chỉ có khóa khớp với định dạng đầu vào. Một định dạng mà tác vụ không tạo ra sẽ không có khóa tương ứng, thay vì có một chuỗi rỗng.
- Name
  glb
  Type
  string
  Description
  Tệp GLB đã được sửa. Được thiết lập khi đầu vào là tệp GLB hoặc khi bạn gửi input_task_id.
- Name
  gltf
  Type
  string
  Description
  Tệp glTF đã được sửa. Được thiết lập khi đầu vào là tệp glTF.
- Name
  fbx
  Type
  string
  Description
  Tệp FBX đã được sửa. Được thiết lập khi đầu vào là tệp FBX.
- Name
  obj
  Type
  string
  Description
  Tệp OBJ đã được sửa. Được thiết lập khi đầu vào là tệp OBJ.
- Name
  stl
  Type
  string
  Description
  Tệp STL đã được sửa. Được thiết lập khi đầu vào là tệp STL.
Name
thumbnail_url
Type
string
Description
URL tải xuống cho ảnh xem trước của mô hình đã được sửa.
Name
alpha_thumbnail_url
Type
string
Description
URL tải xuống cho một phiên bản của thumbnail_url với nền trong suốt (RGBA). Chỉ xuất hiện khi bạn tạo tác vụ với alpha_thumbnail: true và Meshy đã render ảnh xem trước trong suốt.
Name
texture_urls
Type
array
Description
Luôn là một mảng rỗng. Repair chỉ giữ lại hình học của đầu vào và không bake lại texture.
Name
consumed_credits
Type
integer
Description
Số lượng tín dụng mà tác vụ đã sử dụng. Giá trị này là 10 khi tác vụ ở trạng thái SUCCEEDED, và là 0 đối với tác vụ FAILED, vì Meshy hoàn lại tín dụng khi tác vụ thất bại.
Name
intended_print
Type
object
Description
Máy in và kích thước mà quá trình sửa đã sử dụng, cho dù bạn đã gửi chúng hay Meshy tái sử dụng chúng từ một tác vụ Phân tích khả năng in. Xuất hiện ngay từ đầu đối với một lần sửa độ dày thành, kể cả khi tác vụ đang ở trạng thái PENDING. Một giá trị mà Meshy chưa biết sẽ là null.
- 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 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. Nếu không, giá trị này là null.
- Name
  longest_side_mm
  Type
  number
  Description
  Độ 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, và giá trị này là null cho đến khi Meshy đo 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.
- Name
  dimensions_mm
  Type
  array
  Description
  [width, depth, height] của bản in, tính bằng milimét. Chiều cao có thể khác với height_mm một phần nhỏ của milimét. Giá trị này là null cho đến khi tác vụ thành công, và luôn là null đối với đầu vào không phải GLB.
Name
print_repair_report
Type
object
Description
Những gì quá trình sửa độ dày thành đã thực hiện. Xuất hiện sau khi quá trình sửa độ dày thành thành công.
- Name
  route
  Type
  string
  Description
  Thao tác sửa nào đã chạy, là một trong:
  
  thin_wall: hơn 5% bề mặt quá mỏng, vì vậy việc làm dày thành cũng đã chạy. Để xem liệu nó có thay đổi lưới hay không, hãy kiểm tra applied.
  
  topology: các thành đã đủ dày, vì vậy chỉ việc sửa topology đã chạy.
  
  topology_unmeasured: Meshy không thể đo các thành, vì vậy chỉ việc sửa topology đã chạy.
- Name
  applied
  Type
  boolean
  Description
  Liệu việc làm dày thành có thay đổi lưới hay không. Chỉ xuất hiện khi route là thin_wall.
- Name
  faces_before
  Type
  integer
  Description
  Số lượng mặt của lưới đầu vào. Chỉ xuất hiện khi route là thin_wall.
- Name
  faces_after
  Type
  integer
  Description
  Số lượng mặt của lưới đã được sửa. Chỉ xuất hiện khi route là thin_wall.
- Name
  thin_area_ratio_before
  Type
  number
  Description
  Tỷ lệ phần bề mặt của đầu vào mỏng hơn intended_print.wall_thickness_mm, từ 0 đến 1. Bị bỏ qua khi Meshy không thể đo đầu vào.
- Name
  thin_area_ratio_after
  Type
  number
  Description
  Cùng một tỷ lệ đó, được đo trên mô hình đã được sửa. Bị bỏ qua khi Meshy không thể đo nó. Tác vụ vẫn thành công.