API Sửa khả năng in

Sửa một mô hình 3D để đảm bảo khả năng in — 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 để lưới sẵn sàng cho việc in. Tùy chọn, cũng có thể làm dày các thành quá mỏng ở kích thước bạn dự định in.

POST/openapi/v1/print/repair

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

Endpoint này tạo một tác vụ sửa khả năng in mới. Tác vụ này thực hiện sửa topology trên một mô hình 3D và trả về một phiên bản kín nước, 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ý.

Định dạng đầu ra khớp với định dạng đầu vào. Nếu bạn gửi một tệp .stl qua model_url, model_urls.stl trong phản hồi sẽ chứa lưới đã được sửa và các trường định dạng khác sẽ để trống. Đường dẫn input_task_id luôn đọc GLB của tác vụ nguồn, do đó đầu ra sẽ là .glb.

Để đồ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, một kích thước in, hoặc cả hai. Các thành chỉ được làm dày 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; hãy thay đổi tỷ lệ bằng API Đổi kích thước, API này nhận giá trị theo mét (100 mm là 0.1).

Tham số

Chỉ một trong hai trường input_task_id hoặc model_url là bắt buộc. Nếu cả hai đều được cung cấp, input_task_id sẽ được ưu tiên.

Các texture hiện có sẽ bị loại bỏ trong quá trình sửa do có thay đổi về hình học. Để thêm lại texture, hãy sử dụng API Tạo lại texture trên mô hình đã sửa.

Name
input_task_id
Type
string
Bắt buộc
Description
ID của một tác vụ đã thành công mà bạn sở hữu. Các loại tác vụ được hỗ trợ: Ảnh sang 3D, Nhiều ảnh sang 3D, Văn bản sang 3D, Remesh, Tạo lại texture, và Phân tích khả năng in. Tác vụ phải có trạng thái SUCCEEDED và phải đã tạo ra một tài nguyên GLB.
Một tác vụ phân tích đã kiểm tra độ dày thành cũng sẽ truyền lại thông tin máy in và kích thước của nó, do đó tác vụ sửa 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ẽ ghi đè lên giá trị đó. Các tác vụ phân tích được tạo từ một model_url dạng .stl, .fbx, hoặc .gltf sẽ không được chấp nhận: thay vào đó hãy gửi tệp đó dưới dạng model_url.

Name
model_url
Type
string
Bắt buộc
Description
URL của một mô hình 3D cần sửa. Các định dạng được hỗ trợ: .glb, .gltf, .obj, .fbx, .stl. Sử dụng URL http hoặc https, hoặc URL base64 data: cho GLB (data:model/gltf-binary;base64,...) hoặc glTF (data:model/gltf+json;base64,...). Các tệp .obj, .fbx và .stl phải được gửi dưới dạng URL http hoặc https.
Kích thước tệp tối đa: 400 MB đối với URL http hoặc https, 100 MB đối với URI data:.
Một tệp GLB, glTF, FBX hoặc OBJ có dung lượng trên 100 MB có thể có tối đa 10.000.000 mặt. Các mặt được tính theo số tam giác: một tứ giác được tính là 2, và một lưới được vẽ nhiều hơn một lần được tính một lần cho mỗi bản sao. Với dung lượng trên 100 MB, tệp FBX phải là FBX nhị phân 7.1 trở lên, và tệp GLB hoặc glTF không được sử dụng nén Draco.
Các 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 lấy lại tác vụ đó không làm gia hạn các URL này. Đối với một mô hình được tạo bởi Meshy, hãy truyền input_task_id thay thế. Nó sẽ hoạt động trong thời gian tác vụ nguồn còn được lưu giữ (xem Lưu giữ tài nguyên). Để tái sử dụng một 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
Khi được đặt thành true, tác vụ sẽ render thêm một phiên bản xem trước có nền trong suốt (RGBA) và trả về dưới dạng alpha_thumbnail_url trong phản hồi GET. Trường thumbnail_url hiện có không thay đổi.

Chỉ gửi tối đa một trong hai trường kích thước in. Nếu bạn gửi printer_type mà không có kích thước, và không có kích thước nào được tái sử dụng từ một tác vụ phân tích, kích thước mặc định sẽ là:

.glb và bất kỳ input_task_id nào: cao 150 mm.
.stl: cạnh dài nhất của chính tệp đó, được đọc theo milimét. Đối với một STL ở đơn vị khác, hãy gửi intended_print_longest_side_mm.
.obj, .fbx, .gltf: 150 mm ở cạnh dài nhất.

Name
printer_type
Type
string
Description
Máy in bạn dự định sử dụng. Nó quy định độ dày thành tối thiểu mà quá trình sửa hướng tới. Mặc định là fdm khi bạn gửi một kích thước in mà không kèm theo nó, trừ khi một tác vụ phân tích được truyền vào dưới dạng input_task_id cung cấp thông tin máy in.
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: toàn màu, độ dày thành tối thiểu 2.0 mm.
Name
intended_print_height_mm
Type
number
Description
Chiều cao của bản in, tính bằng milimét. Phạm vi: [1, 1000]. Được làm tròn đến milimét gần nhất. Chỉ áp dụng cho đầu vào GLB.
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. Phạm vi: [1, 1000]. Được làm tròn đến milimét gần nhất. Hoạt động với mọi định dạng đầu vào.

Giá trị trả về

Thuộc tính result của phản hồi chứa id của tác vụ sửa khả năng in vừa được tạo.

Các trường hợp lỗi

Name
400 - Bad Request
Description
Yêu cầu không hợp lệ. Các nguyên nhân phổ biến:
- Thiếu tham số: không có input_task_id lẫn model_url được cung cấp.
- 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 có định dạng sai, sử dụng giao thứ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: nội dung model_url vượt quá 400 MB (URL http hoặc https) hoặc 100 MB (URI data:).
- Quá nhiều mặt: model_url là một tệp GLB, glTF, FBX hoặc OBJ có dung lượng trên 100 MB với hơn 10.000.000 mặt. Hãy giảm số lượng mặt, sau đó gửi lại tệp.
- FBX dạng ASCII trên 100 MB: model_url là một tệp FBX dạng ASCII có dung lượng trên 100 MB. Hãy gửi dưới dạng FBX nhị phân hoặc GLB.
- Tệp mô hình không thể đọc được: model_url có dung lượng trên 100 MB và phần header của nó không thể đọc được, ví dụ một tệp GLB hoặc glTF được nén Draco, hoặc một tệp FBX nhị phân cũ hơn phiên bản 7.1.
- Header mô hình quá phức tạp: model_url có dung lượng trên 100 MB và phần 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 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, phổ biến nhất là do một URL tải xuống đã được ký của Meshy đã hết hạn. Việc lấy lại tác vụ sẽ trả về cùng một URL với cùng thời hạn, vì vậy hãy gửi bản sao của riêng bạn của tệp đó, hoặc sử dụng input_task_id trong khi tác vụ nguồn vẫn còn được lưu giữ.
- Tác vụ chưa thành công: tác vụ được tham chiếu vẫn đang chờ xử lý, đang xử lý, hoặc đã thất bại.
- Thiếu GLB: tác vụ được tham chiếu không có tài nguyên GLB nào để 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, 1000], hoặc cả hai đều được gửi.
- 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: intended_print_height_mm được gửi cùng với một model_url không phải là .glb. Hãy sử dụng intended_print_longest_side_mm thay thế.
- Không thể xác đị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, 1000] mm, mô hình bị phẳng, hoặc không thể xác định kích thước của nó. Hãy sử dụng intended_print_longest_side_mm thay thế. Đối với model_url dạng .glb và một số tác vụ input_task_id, điều này chỉ được phát hiện 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ì tiếp tục.
- Kích thước STL không sử dụng được: printer_type được gửi mà không có kích thước, và cạnh dài nhất của chính tệp .stl không thể đọc được hoặc nằm ngoài khoảng [1, 1000] mm. Hãy gửi intended_print_longest_side_mm.
Name
401 - Unauthorized
Description
Xác thực thất bại. Vui lòng kiểm tra lại khóa API của bạn.
Name
402 - Payment Required
Description
Các nguyên nhân phổ biến:
- Gói miễn phí: việc tạo tác vụ yêu cầu một gói trả phí. Hãy nâng cấp tại trang đăng ký.
- Không đủ tín dụng: đã đạt đến giới hạn tín dụng của không gian làm việc.
Name
404 - Not Found
Description
Tác vụ được tham chiếu không tồn tại hoặc thuộc sở hữu của một người dùng khác.
Name
429 - Too Many Requests
Description
Bạn đã vượt quá hạn ngạch tác vụ đang chờ xử lý hoặc giới hạn tốc độ của mình.

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

Retrieve a Repair Printability Task

Endpoint này truy xuất một tác vụ sửa khả năng in theo ID của nó.

Tham số

Name
id
Type
path
Description
ID của tác vụ sửa khả năng in cần truy xuất.

Giá trị trả về

Đối tượng Tác vụ Sửa khả năng in. Khối model_urls sẽ trống cho đến khi tác vụ đạt trạng thái SUCCEEDED. Chỉ trường model_urls khớp với định dạng đầu vào mới được điền giá trị. Một tác vụ sửa độ dày thành sẽ bao gồm intended_print ngay từ đầu, và print_repair_report khi tác vụ hoàn thành thành công.

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

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

endpoint này xóa vĩnh viễn một tác vụ sửa khả năng in cùng với kết quả đầu ra đã sửa của nó. Hành động này không thể hoàn tác.

Tham số đường dẫn (Path Parameters)

Name
id
Type
path
Description
ID của tác vụ sửa khả năng in cần xóa.

Trạng thái tác vụ

Một tác vụ vẫn đang ở trạng thái PENDING sẽ được xóa và số tín dụng đã tiêu tốn tại thời điểm tạo sẽ được hoàn lại.

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

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

Giá trị trả về

Trả về 200 OK khi thành công, hoặc 409 Conflict khi tác vụ đang ở trạng thái IN_PROGRESS.

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

List Repair Printability Tasks

endpoint này cho phép bạn truy xuất danh sách các tác vụ Sửa khả năng in.

Tham số

Thuộc tính tùy chọn

Name
page_num
Type
integer
Description
Số trang dùng cho phân trang. Bắt đầu và mặc định là 1.
Name
page_size
Type
integer
Description
Giới hạn số lượng mỗi trang. Mặc định là 10 mục. Tối đa cho phép là 100 mục.
Name
sort_by
Type
string
Description
Trường dùng để sắp xếp. Các giá trị khả dụng:
- +created_at: Sắp xếp theo thời gian tạo tăng dần.
- -created_at: Sắp xếp theo thời gian tạo giảm dần.

Giá trị trả về

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

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

Stream a Repair Printability Task

Endpoint này truyền trực tuyến các cập nhật theo thời gian thực cho một tác vụ sửa khả năng in bằng Server-Sent Events (SSE).

Tham số

Name
id
Type
path
Description
Mã định danh duy nhất của tác vụ sửa khả năng in cần truyền trực tuyến.

Giá trị trả về

Trả về một luồng Đối tượng Tác vụ Sửa Khả năng In dưới dạng Server-Sent Events.

Mỗi khung dữ liệu mang theo toàn bộ đối tượng tác vụ cho giai đoạn đó — cùng cấu trúc mà endpoint Get trả về — vì vậy khi tác vụ đang ở trạng thái PENDING hoặc IN_PROGRESS, các trường đầu ra đơn giản là chưa được điền (null, [] hoặc {}) và finished_at là null. Khối model_urls chỉ được gửi khi tác vụ đạt trạng thái 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
}

Đối tượng Task Sửa khả năng in

Name
id
Type
string
Description
Mã định danh duy nhất cho task. Mặc dù chúng tôi sử dụng UUID có thể sắp xếp theo k (k-sortable UUID) cho id của task như một chi tiết triển khai, bạn không nên đưa ra bất kỳ giả định nào về định dạng của id.
Name
type
Type
string
Description
Loại của task sửa khả năng in. Giá trị là print-repair.
Name
status
Type
string
Description
Trạng thái của task. Các giá trị có thể là một trong các giá trị PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
progress
Type
integer
Description
Tiến độ của task. Nếu task chưa bắt đầu, thuộc tính này sẽ là 0. Khi task đã thành công, giá trị này sẽ trở thành 100.
Name
preceding_tasks
Type
integer
Description
Số lượng các task đứng trước.
Giá trị của trường này chỉ có ý nghĩa nếu trạng thái task là PENDING.
Name
created_at
Type
timestamp
Description
Dấu thời gian khi task được tạo, tính bằng mili giây.
Name
started_at
Type
timestamp
Description
Dấu thời gian khi task bắt đầu, tính bằng mili giây. Nếu task chưa bắt đầu, thuộc tính này sẽ là 0.
Name
finished_at
Type
timestamp
Description
Dấu thời gian khi task kết thúc, tính bằng mili giây. Nếu task chưa kết thúc, thuộc tính này sẽ là 0.
Name
expires_at
Type
timestamp
Description
Dấu thời gian khi kết quả của task sẽ hết hạn khỏi hệ thống, tính bằng mili giây. 0 nếu task chưa kết thúc.
Name
task_error
Type
object
Description
Thông tin lỗi nếu task đã thất bại. Thuộc tính này là null nếu task chưa thất bại. Xem Lỗi để biết thêm chi tiết.
- Name
  message
  Type
  string
  Description
  Thông báo lỗi mô tả vấn đề đã xảy ra.
Name
model_urls
Type
object
Description
URL có thể tải xuống của mô hình 3D đã được sửa. Chỉ trường tương ứng với định dạng đầu vào được điền giá trị; các trường định dạng khác là chuỗi rỗng.
- Name
  glb
  Type
  string
  Description
  URL có thể tải xuống của GLB đã được sửa. Được điền giá trị khi đầu vào là GLB hoặc khi input_task_id được sử dụng.
- Name
  gltf
  Type
  string
  Description
  URL có thể tải xuống của GLTF đã được sửa. Được điền giá trị khi đầu vào là tệp GLTF được tải lên.
- Name
  fbx
  Type
  string
  Description
  URL có thể tải xuống của FBX đã được sửa. Được điền giá trị khi đầu vào là tệp FBX được tải lên.
- Name
  obj
  Type
  string
  Description
  URL có thể tải xuống của OBJ đã được sửa. Được điền giá trị khi đầu vào là tệp OBJ được tải lên.
- Name
  stl
  Type
  string
  Description
  URL có thể tải xuống của STL đã được sửa. Được điền giá trị khi đầu vào là tệp STL được tải lên.
- Name
  usdz
  Type
  string
  Description
  Dành riêng cho đầu ra USDZ. Luôn là chuỗi rỗng đối với các task sửa khả năng in.
- Name
  3mf
  Type
  string
  Description
  Dành riêng cho đầu ra 3MF. Luôn là chuỗi rỗng đối với các task sửa khả năng in.
- Name
  mtl
  Type
  string
  Description
  Dành riêng cho đầu ra MTL. Luôn là chuỗi rỗng đối với các task sửa khả năng in.
Name
thumbnail_url
Type
string
Description
URL của ảnh xem trước được render từ mô hình đã được sửa.
Name
alpha_thumbnail_url
Type
string
Description
URL có thể tải xuống của phiên bản nền trong suốt (RGBA) của thumbnail_url. Chỉ xuất hiện khi task được tạo với alpha_thumbnail: true và ảnh xem trước trong suốt đã được render thành công; nếu không, trường này sẽ bị bỏ qua.
Name
texture_urls
Type
array
Description
Luôn là một mảng rỗng. Việc sửa chỉ giữ nguyên hình học đầu vào và không tái tạo texture.
Name
consumed_credits
Type
integer
Description
Số lượng tín dụng đã tiêu thụ bởi task này. 10 khi task đã đạt trạng thái SUCCEEDED. Trả về 0 đối với các task FAILED (tín dụng được hoàn lại khi 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ù được gửi hay được tái sử dụng từ một task phân tích. Có mặt ngay từ đầu (PENDING) đối với sửa độ dày thành; các giá trị chưa được biết là null.
- Name
  printer_type
  Type
  string
  Description
  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, nếu bản in được định kích thước theo chiều cao. Nếu không thì là null.
- Name
  longest_side_mm
  Type
  number
  Description
  Cạnh dài nhất của bản in tính bằng milimét. Khi được định kích thước theo chiều cao, giá trị này được tính từ tỷ lệ của mô hình, và là null cho đến khi mô hình được đo.
- 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
  Kích thước [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 với height_mm một phần nhỏ của milimét. Là null cho đến khi task 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. Có mặt khi một lần sửa độ dày thành đã thành công.
- Name
  route
  Type
  string
  Description
  Loại sửa nào đã chạy. Một trong các giá trị sau:
  
  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 applied).
  
  topology: các thành đủ dày; chỉ việc sửa topology đã chạy.
  
  topology_unmeasured: không thể đo được các thành; 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ỉ có mặt khi route là thin_wall.
- Name
  faces_before
  Type
  integer
  Description
  Số lượng mặt của lưới đầu vào. Chỉ có mặt khi route là thin_wall.
- Name
  faces_after
  Type
  integer
  Description
  Số lượng mặt của lưới đã được sửa. Chỉ có mặt khi route là thin_wall.
- Name
  thin_area_ratio_before
  Type
  number
  Description
  Tỷ lệ bề mặt của đầu vào, từ 0 đến 1, mỏng hơn intended_print.wall_thickness_mm. Bị bỏ qua nếu đầu vào không thể đo được.
- Name
  thin_area_ratio_after
  Type
  number
  Description
  Tỷ lệ tương tự, được đo trên mô hình đã sửa. Bị bỏ qua nếu không thể đo được; task vẫn 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=***",
    "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
  }
}