lowpoly sẽ ngừng hoạt động vào 30 thg 10, 2026. Hãy chuyển sang mô hình khác trước các ngày này để tránh lỗi yêu cầu. Xem tất cả mục ngừng hỗ trợ

Auto Split API

Chia một mô hình 3D thành các phần bạn có thể in riêng biệt. Meshy chọn các đường cắt, hoặc cắt theo các phần hoặc vùng màu mà bạn chỉ định, và có thể thêm các đầu nối. Meshy luôn gia cố các vùng mỏng mà một đường cắt để lại, để mỗi phần đều in được chắc chắn.

Theo mặc định, mô hình đã chia không giữ lại texture của đầu vào. Bạn có thể chia một mô hình đã có texture, nên bạn không cần tạo lại nó với should_texture: false. Meshy dựng lại các phần đã cắt và gán cho mỗi phần một màu đỉnh (vertex color) phẳng. Để giữ texture trên mọi phần, hãy gửi keep_texture: true.

POST/openapi/v1/print/split

Tạo một tác vụ Auto Split

Tạo một tác vụ Auto Split. Tác vụ này cắt mô hình của một tác vụ trước đó thành các phần bạn có thể in riêng biệt. Nó trả về mô hình đã chia, với mỗi phần là một đối tượng riêng trong tệp.

Tác vụ chạy ở chế độ nền. Để biết thời gian một tác vụ thường mất, xem Thời gian xử lý.

Request

POST
/openapi/v1/print/split
# Simple request: let Meshy choose the cuts
curl https://api.meshy.ai/openapi/v1/print/split \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

# Advanced request: name the parts, keep the texture, add connectors, export glb and obj
curl https://api.meshy.ai/openapi/v1/print/split \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "mode": "by_parts",
    "prompt": "split into the figure and the base",
    "target_formats": ["glb", "obj"],
    "layout": "on_plate",
    "keep_texture": true,
    "connectors": true,
    "connector_type": "cylinder",
    "connector_size": 0.4
  }'

Response

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

Tham số

  • Name
    input_task_id
    Type
    string
    Bắt buộc
    Description

    ID của tác vụ có mô hình cần chia. Tác vụ phải có trạng thái SUCCEEDED. Các loại tác vụ sau hoạt động được:

    Mô hình phải được tạo bằng Meshy 6 hoặc Meshy 7, nghĩa là với ai_model được đặt thành meshy-6-lite, meshy-6, meshy-7, meshy-7.1, hoặc latest. Các mô hình Smart Topology (meshy-t2 và meshy-t2.5) không được hỗ trợ. Đối với tác vụ refine, Tạo lại texture, Remesh, Chuyển đổi, hoặc Đổi kích thước, quy tắc này áp dụng cho mô hình mà tác vụ đó bắt đầu từ đó. Một tác vụ Tạo lại texture, Remesh, Chuyển đổi, hoặc Đổi kích thước được tạo từ một mô hình đã tải lên sẽ trả về 400.

    Mô hình có thể có tối đa 8.000.000 mặt (faces). Một mô hình có nhiều mặt hơn sẽ trả về 400. Trong trường hợp đó, hãy chạy một tác vụ Remesh trên mô hình đó trước, rồi gửi ID của tác vụ Remesh thay vào đó.

    Bạn có thể chia một mô hình có texture. Để giữ texture trên các phần, hãy gửi keep_texture: true.

  • Name
    mode
    Type
    string
    mặc định auto
    Description

    Cách chia mô hình thành các phần.

    Các giá trị khả dụng:

    • auto: Meshy tự chọn các đường cắt và bỏ qua prompt. Một prompt vượt quá 600 ký tự vẫn trả về 400.
    • by_parts: Meshy cắt theo các bộ phận cấu trúc bạn nêu trong prompt, ví dụ như đầu, tay và thân.
    • by_color: Meshy cắt theo các vùng màu bạn nêu trong prompt. Meshy tìm các vùng này trong ảnh nguồn, không phải trong texture của mô hình đầu vào. Đầu vào phải được tạo từ một ảnh đã tải lên, bằng Ảnh sang 3D hoặc Nhiều ảnh sang 3D. Các đầu vào khác trả về 400. Đối với Nhiều ảnh sang 3D, Meshy sử dụng ảnh nguồn đầu tiên.
Chỉ áp dụng khi mode = by_parts or by_color
  • Name
    prompt
    Type
    string
    Bắt buộc
    Description

    Các phần để chia mô hình thành, bằng bất kỳ ngôn ngữ nào, tối đa 600 ký tự. Văn bản dài hơn sẽ trả về 400, ngay cả khi mode là auto.

    Meshy đọc từ 1 đến 10 tên bộ phận từ prompt, vì vậy hãy nêu tên các bộ phận thay vì mô tả mô hình. Ví dụ, split into the figure and the base hoặc head, torso, left arm, right arm, legs. Bạn có thể nêu tên một bộ phận duy nhất. Mọi thứ bạn không nêu tên sẽ trở thành một phần nữa, vì vậy the head sẽ chia mô hình thành phần đầu và phần còn lại, giống như trong ứng dụng web.

    Một prompt yêu cầu không chia tách, hoặc nêu tên hơn 10 bộ phận, sẽ trả về 400, và Meshy không tính phí cho yêu cầu đó.

    Nếu Meshy không thể đọc được bất kỳ tên bộ phận nào từ prompt, nó sẽ sử dụng ảnh tham chiếu của mô hình thay thế. Nó chia theo các bộ phận mà nó tìm thấy ở đó, theo mode bạn đã chọn. Tác vụ vẫn chạy, Meshy vẫn tính phí cho tác vụ đó, và tác vụ sẽ có prompt_ignored: true. Nếu mô hình không có ảnh tham chiếu, hoặc Meshy tìm thấy ít hơn 2 bộ phận trong đó, yêu cầu sẽ trả về 400, và Meshy không tính phí cho yêu cầu đó.

  • Name
    target_formats
    Type
    array
    mặc định ["glb"]
    Description

    Các định dạng tệp cần tạo. Meshy luôn tạo glb và trả về trong model_urls, cùng với các định dạng khác mà bạn liệt kê.

    Các giá trị khả dụng:

    • glb
    • obj
    • fbx
    • stl
    • usdz
    • blend
    • 3mf

    Mọi định dạng trừ stl đều hỗ trợ các đối tượng cảnh và giữ mỗi phần như một đối tượng riêng biệt. Một tệp STL không thể chứa các đối tượng riêng biệt, vì vậy Meshy hợp nhất các phần thành một khối đặc duy nhất, được sắp xếp theo layout. Để có được các phần bạn có thể chọn riêng trong phần mềm cắt lớp, hãy yêu cầu 3mf.

    Với keep_texture: true, các định dạng sau giữ texture:

    • glb, fbx, usdz, và blend: Texture nằm trong tệp.
    • obj: Texture nằm trong tệp vật liệu, mà model_urls trả về dưới mtl.
    • stl và 3mf: Tệp chỉ chứa hình học, không có texture.
  • Name
    layout
    Type
    string
    mặc định assembled
    Description

    Cách Meshy sắp xếp các phần, trong mọi định dạng tệp và trong ảnh thu nhỏ.

    Các giá trị khả dụng:

    • assembled: Meshy giữ nguyên vị trí các phần như trong mô hình nguồn.
    • on_plate: Meshy đặt các phần nằm phẳng và trải chúng ra trên bàn in, sẵn sàng để cắt lớp. Đây là cách sắp xếp giống với chế độ xem On Plate trong ứng dụng web.

    Trong cả hai cách sắp xếp, Meshy loại bỏ bất kỳ mảnh vụn sụp đổ hoặc mảnh giống như điểm mà một đường cắt để lại trước khi xuất, để mỗi phần bạn nhận được đều có thể in được. Các định dạng hỗ trợ đối tượng cảnh giữ một đối tượng cho mỗi phần, và stl hợp nhất các phần thành một khối đặc duy nhất.

  • Name
    keep_texture
    Type
    boolean
    mặc định false
    Description

    Có giữ texture của mô hình đầu vào trên các phần hay không. true cho mỗi phần texture của đầu vào, và tác vụ trả về các map trong texture_urls. false cho mỗi phần một màu đỉnh (vertex color) phẳng.

    Với true, tác vụ mất khoảng gấp đôi thời gian, và chi phí tín dụng không thay đổi. Một đầu vào không có texture sẽ chia theo cùng cách như với false. Nếu Meshy không thể giữ texture, tác vụ sẽ thất bại với mã lỗi textured_split_refused. Xem Lỗi.

  • Name
    connectors
    Type
    boolean
    mặc định false
    Description

    Có thêm các khớp nối mộng (mortise-and-tenon) tại mỗi đường cắt hay không, để các phần in khớp với nhau.

Chỉ áp dụng khi connectors = true
  • Name
    connector_type
    Type
    string
    mặc định cube
    Description

    Hình dạng của khớp nối tại mỗi bề mặt cắt, cube hoặc cylinder.

  • Name
    connector_size
    Type
    number
    mặc định 0.5
    Description

    Kích thước của khớp nối, tương ứng với bề mặt cắt, từ 0.1 đến 0.8. Một giá trị ngoài phạm vi này trả về 400, ngay cả khi connectors là false.

  • Name
    connector_height
    Type
    number
    mặc định 0.1
    Description

    Khớp nối nhô ra khỏi bề mặt cắt bao xa, tương ứng với bề mặt cắt, từ 0.1 đến 0.8. Một giá trị ngoài phạm vi này trả về 400, ngay cả khi connectors là false.

Giá trị trả về

Trường result của phản hồi chứa ID của tác vụ Auto Split mới.

Các trường hợp thất bạ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 prompt: mode là by_parts hoặc by_color, và prompt bị thiếu.
    • Prompt mô tả không chia tách, hoặc quá nhiều phần: Prompt yêu cầu giữ mô hình thành một khối duy nhất, hoặc nêu tên hơn 10 phần. by_parts và by_color chấp nhận từ 1 đến 10 phần được nêu tên. Meshy không tính phí cho yêu cầu này.
    • Tác vụ đầu vào không được hỗ trợ: input_task_id không phải là một tác vụ đã thành công thuộc loại được hỗ trợ, được tạo bằng Meshy 6 hoặc Meshy 7.
    • Không có ảnh tham chiếu: mode là by_color, và đầu vào không được tạo từ một ảnh đã tải lên.
    • Khớp nối ngoài phạm vi: connector_size hoặc connector_height nằm ngoài khoảng 0.1 đến 0.8.

    Sửa yêu cầu, rồi gửi lại. Xem Lỗi.

  • Name
    401 - Unauthorized
    Description

    Khóa API bị thiếu hoặc không hợp lệ. 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 đến giới hạn tín dụng. Kiểm tra số dư tín dụng của bạn, rồi thử lại.
    • Gói miễn phí: Tạo một tác vụ yêu cầu gói trả phí. Nâng cấp gói của bạn trong cài đặt đăng ký của bạn, rồi thử lại.
  • Name
    403 - Forbidden
    Description

    Một trong những điều sau áp dụng:

    • Kiểm duyệt nội dung đã chặn prompt. Thông báo là explicit content hoặc prohibited content. Thay đổi prompt, rồi thử lại.
    • input_task_id là một mô hình phù điêu (bas-relief), mà endpoint này không thể chia. Thông báo là This model type does not support this operation. Gửi một mô hình khác.
  • Name
    404 - Not Found
    Description

    input_task_id không tồn tại hoặc không thuộc về tài khoản của bạn. Kiểm tra ID, và sử dụng khóa API từ 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 độ. Chờ, rồi thử lại. Xem Giới hạn tốc độ.

    Các yêu cầu by_parts và by_color cũng chia sẻ giới hạn đọc prompt là 12 yêu cầu mỗi phút cho mỗi tài khoản.

  • Name
    503 - Service Unavailable
    Description

    Chia theo prompt (by_parts và by_color) tạm thời không khả dụng. Thử lại sau, hoặc gửi mode: "auto", vẫn hoạt động được. Meshy không tính phí cho yêu cầu này.

GET/openapi/v1/print/split/:id

Lấy thông tin tác vụ Auto Split

Trả về một tác vụ Auto Split theo ID của nó.

Request

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

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-split",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0_metallic.png?Expires=***",
      "normal": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0_normal.png?Expires=***",
      "roughness": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0_roughness.png?Expires=***"
    }
  ],
  "part_count": 4,
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000082000,
  "task_error": null,
  "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ề

Đối tượng tác vụ Auto Split.

DELETE/openapi/v1/print/split/:id

Xóa một tác vụ Auto Split

Xóa vĩnh viễn một tác vụ Auto Split, bao gồm các mô hình và dữ liệu của nó. Bạn không thể hoàn tác việc xóa.

Request

DELETE
/openapi/v1/print/split/a43b5c6d-7e8f-901a-234b-567c890d1e2f
curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/print/split/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ụ

Việc 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 lại 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 nó đạt trạng thái SUCCEEDED, FAILED, hoặc CANCELED, rồi mới xóa.

Việc 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.

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/split

Danh sách tác vụ Auto Split

Trả về danh sách các tác vụ Auto Split của bạn.

Request

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

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-split",
    "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=***",
    "part_count": 4,
    "progress": 100,
    "status": "SUCCEEDED",
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000082000,
    "task_error": null,
    "consumed_credits": 10
  }
]

Tham số

  • Name
    page_num
    Type
    integer
    Description

    Số trang cần trả về. Bắt đầu từ và mặc định là 1.

  • Name
    page_size
    Type
    integer
    Description

    Số lượng tác vụ trên mỗi trang, tối đa 100. Mặc định là 10. Meshy sẽ coi giá trị lớn hơn là 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 phân trang các đối tượng tác vụ Auto Split.

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

Stream một tác vụ Auto Split

Stream các cập nhật của tác vụ Auto Split dưới dạng Server-Sent Events (SSE).

Request

GET
/openapi/v1/print/split/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream
curl -N https://api.meshy.ai/openapi/v1/print/split/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 (other task fields omitted here for brevity;
// each frame is the full task object).
event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "type": "print-split",
  "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=***",
  "part_count": 4,
  "progress": 100,
  "status": "SUCCEEDED",
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000082000,
  "task_error": null,
  "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 đối tượng tác vụ Auto Split dưới dạng Server-Sent Events.

Mỗi sự kiện message chứa toàn bộ đối tượng tác vụ, giống với đối tượng mà Lấy thông tin một tác vụ Auto Split trả về. Điều này bao gồm consumed_credits, các dấu thời gian và prompt_ignored. Trong khi tác vụ đang ở trạng thái PENDING hoặc IN_PROGRESS, các trường thay đổi giữa các sự kiện là progress, status, started_at, và preceding_tasks. model_urls và thumbnail_url sẽ nhận giá trị, và part_count sẽ xuất hiện, khi tác vụ đạt trạng thái SUCCEEDED.

Một sự kiện error chỉ chứa status_code và message, vì vậy hãy kiểm tra tên sự kiện trước khi đọc status.

The Auto Split task object

Một đối tượng tác vụ Auto Split mô tả một lần phân tách mô hình 3D. Nó lưu giữ trạng thái, progress, và các tệp phần khi tác vụ thành công.

Nó không bao gồm các trường prompt của các đối tượng tác vụ khác, chẳng hạn như name, object_prompt, và texture_prompt. Nó cũng không có một model_url duy nhất. thumbnail_url, model_urls, và các dấu thời gian sẽ được điền vào khi tác vụ chạy. Chúng luôn hiện diện, và trống cho đến khi có giá trị.

The Auto Split Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-split",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0_metallic.png?Expires=***",
      "normal": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0_normal.png?Expires=***",
      "roughness": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0_roughness.png?Expires=***"
    }
  ],
  "part_count": 4,
  "progress": 100,
  "status": "SUCCEEDED",
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000082000,
  "task_error": null,
  "consumed_credits": 10
}
  • 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, và đừng dựa vào định dạng của nó.

  • Name
    type
    Type
    string
    Description

    Loại tác vụ, luôn là print-split.

  • Name
    model_urls
    Type
    object
    Description

    URL tải xuống cho mô hình đã phân tách, mỗi định dạng bạn đã yêu cầu một URL. Một định dạng bạn không yêu cầu sẽ không có khóa. Các định dạng hỗ trợ đối tượng cảnh giữ mỗi phần là một đối tượng riêng biệt, và stl hợp nhất các phần thành một khối rắn duy nhất.

    • Name
      glb
      Type
      string
      Description

      Tệp GLB.

    • Name
      obj
      Type
      string
      Description

      Tệp OBJ.

    • Name
      mtl
      Type
      string
      Description

      Tệp MTL. Xuất hiện cùng với tệp OBJ khi keep_texture là true và mô hình đầu vào có texture.

    • Name
      fbx
      Type
      string
      Description

      Tệp FBX.

    • Name
      stl
      Type
      string
      Description

      Tệp STL, với tất cả các phần được hợp nhất thành một khối rắn duy nhất. Để có các phần bạn có thể chọn riêng, hãy yêu cầu 3mf.

    • Name
      usdz
      Type
      string
      Description

      Tệp USDZ.

    • Name
      blend
      Type
      string
      Description

      Tệp Blender.

    • Name
      3mf
      Type
      string
      Description

      Tệp 3MF.

  • Name
    thumbnail_url
    Type
    string
    Description

    URL tải xuống cho hình ảnh xem trước của mô hình đã phân tách, theo layout bạn đã yêu cầu. Khi các phần giữ texture, bản xem trước sẽ hiển thị texture đó. Nếu không, mỗi phần sẽ có màu riêng.

  • Name
    texture_urls
    Type
    array
    Description

    Các bản đồ texture của mô hình đã phân tách, dưới dạng một mảng chứa một đối tượng. Tất cả các phần dùng chung các bản đồ này. Chỉ xuất hiện khi keep_texture là true và mô hình đầu vào có texture.

    • Name
      base_color
      Type
      string
      Description

      URL tải xuống cho bản đồ màu nền (base color).

    • Name
      metallic
      Type
      string
      Description

      URL tải xuống cho bản đồ metallic. Không có khi đầu vào không có bản đồ metallic.

    • Name
      normal
      Type
      string
      Description

      URL tải xuống cho bản đồ normal. Không có khi đầu vào không có bản đồ normal.

    • Name
      roughness
      Type
      string
      Description

      URL tải xuống cho bản đồ roughness. Không có khi đầu vào không có bản đồ roughness.

  • Name
    alpha_thumbnail_url
    Type
    string
    Description

    URL tải xuống cho phiên bản của thumbnail_url có nền trong suốt (RGBA). Chỉ xuất hiện sau khi tác vụ thành công, khi Meshy đã dựng bản xem trước trong suốt.

  • Name
    prompt_ignored
    Type
    boolean
    Description

    Liệu Meshy có bỏ qua prompt hay không. Giá trị là true khi prompt của một yêu cầu by_parts hoặc by_color không nêu tên phần nào, nên Meshy đã tự động phân tách mô hình thay vào đó. Khi đó, tên các phần trong kết quả là do Meshy đặt, không phải của bạn. Xuất hiện từ trạng thái PENDING trở đi. Meshy bỏ qua trường này đối với các tác vụ auto và bất cứ khi nào nó đã tuân theo prompt.

  • Name
    part_count
    Type
    integer
    Description

    Số lượng phần có thể in được mà việc phân tách tạo ra. Các định dạng hỗ trợ đối tượng cảnh chứa một đối tượng cho mỗi phần. stl hợp nhất các phần thành một khối rắn duy nhất, nhưng part_count vẫn đếm chúng. Trước khi xuất, Meshy loại bỏ các mảnh vụn bị sụp không thể trở thành một phần có thể in, và không tính chúng.

  • 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ị là 0 cho đến khi tác vụ bắt đầu và 100 khi tác vụ thành công.

  • 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
    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ị 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ị 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ị 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. Xem Lỗi.

    Nếu một kiểm tra an toàn từ chối mô hình đầu vào, tác vụ sẽ thất bại với task_error.type được đặt thành invalid_input và task_error.code được đặt thành provider_content_refused. Hãy gửi một mô hình khác. Xem Lỗi.

    Với keep_texture: true, nếu Meshy không thể giữ texture, tác vụ sẽ thất bại với task_error.code được đặt thành textured_split_refused. Xem Lỗi.

  • Name
    consumed_credits
    Type
    integer
    Description

    Số tín dụng mà tác vụ đã sử dụng. Trường này luôn hiện diện. Giá trị là 10 sau khi Meshy chấp nhận tác vụ, và 0 đối với tác vụ FAILED, vì Meshy hoàn lại tín dụng khi một tác vụ thất bại. Việc xóa một tác vụ PENDING cũng sẽ hoàn lại tín dụng.