Remesh API

Bắt buộc trừ khi bạn gửi model_url. ID của tác vụ mà bạn muốn remesh mô hình của nó, ví dụ như tác vụ Văn bản sang 3D, Ảnh sang 3D, Tạo lại texture, hoặc Remesh. Tác vụ đó phải là tác vụ bạn đã tạo bằng API và có trạng thái SUCCEEDED.

Bắt buộc trừ khi bạn gửi input_task_id. Mô hình cần remesh, 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.

Mô hình phải là tệp GLB, glTF, OBJ, FBX, hoặc STL có dung lượng tối đa 400 MB từ URL http hoặc https, hoặc 100 MB nếu là data URI. Đối với data URI, hãy dùng MIME type application/octet-stream.

Tệp lớn hơn 100 MB còn 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 tính mặt theo tam giác, vì vậy một 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 7.1 trở lên.
• Tệp GLB hoặc glTF không được dùng nén Draco.

Các định dạng tệp cần tạo.

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

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

Loại mặt của mô hình đã remesh.

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

• quad: lưới chủ yếu gồm mặt tứ giác
• triangle: lưới tam giác đã giảm mặt

Số lượng mặt mục tiêu, từ 100 đến 300000. Kết quả có thể khác với mục tiêu, tùy thuộc vào hình học của mô hình. Giá trị ngoài phạm vi này sẽ trả về 400.

Số lượng mặt thích ứng, theo cấp độ. Khi bạn đặt tham số này, Meshy sẽ bỏ qua target_polycount.

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

• 1: siêu cao (ultra)
• 2: cao (high)
• 3: trung bình (medium)
• 4: thấp (low)

Hãy dùng Resize API thay thế. Chiều cao để đổi kích thước mô hình, tính bằng mét. Chỉ gửi tối đa một trong các tham số resize_height, resize_longest_side, và auto_size.

Hãy dùng Resize API thay thế. Độ dài để đổi kích thước cạnh dài nhất của hộp bao mô hình, tính bằng mét. Chỉ gửi tối đa một trong các tham số resize_height, resize_longest_side, và auto_size.

Hãy dùng Resize API thay thế. Có ước tính chiều cao thực tế của vật thể bằng AI thị giác và đổi kích thước mô hình theo đó hay không. Chỉ gửi tối đa một trong các tham số resize_height, resize_longest_side, và auto_size.

Hãy dùng Resize API thay thế. Vị trí đặt gốc tọa độ của mô hình, bottom hoặc center. Giá trị mặc định áp dụng khi bạn gửi resize_height, resize_longest_side, hoặc auto_size. Nếu không gửi một trong các tham số đó, Meshy chỉ di chuyển gốc tọa độ nếu bạn gửi origin_at.

Hãy dùng Convert API thay thế. Có chỉ chuyển đổi mô hình sang target_formats hay không. Khi là true, Meshy bỏ qua topology, target_polycount, decimation_mode, resize_height, resize_longest_side, và auto_size, nhưng vẫn kiểm tra giá trị của chúng, nên giá trị không hợp lệ sẽ trả về 400. Với convert_format_only: true, target_formats rỗng hoặc null sẽ trả về 400.

Có đồng thời render một 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 tác vụ. thumbnail_url không thay đổi.

Yêu cầu không thể chạy. Thông báo lỗi cho biết vấn đề mà hệ thống phát hiện. Ví dụ:

• Thiếu tham số: Không gửi model_url cũng không gửi input_task_id.
• Tác vụ đầu vào không hợp lệ: input_task_id không phải là một tác vụ API thành công, hoặc mô hình AI của nó không hỗ trợ remesh.
• Định dạng mô hình không hợp lệ: Tệp model_url có phần mở rộng không được hỗ trợ.
• URL không thể truy cập: Meshy không thể tải xuống tệp model_url.
• 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 nếu là data URI.
• Quá nhiều mặt: Tệp model_url vượt quá 100 MB và có nhiều hơn 10.000.000 mặt. Hãy giảm số lượng mặt, rồi gửi lại tệp.
• ASCII FBX vượt quá 100 MB: Tệp model_url là ASCII FBX vượt quá 100 MB. Hãy gửi dưới dạng FBX nhị phân hoặc GLB.
• Tệp mô hình không đọc được: Tệp model_url vượt quá 100 MB, và Meshy không thể đọc phần header của nó. Ví dụ, đó là GLB hoặc glTF đã nén Draco, hoặc FBX nhị phân cũ hơn 7.1.
• Header mô hình quá phức tạp: Tệp model_url vượt quá 100 MB, và phần 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, rồi gửi lại.
• Topology không hợp lệ: topology không phải là quad hoặc triangle.
• Tham số loại trừ lẫn nhau: Yêu cầu có nhiều hơn một trong các tham số auto_size, resize_height, và resize_longest_side. Chỉ gửi một tham số.

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

Thiếu khóa API hoặc khóa API không hợp lệ. Hãy kiểm tra header Authorization.

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í: 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.

input_task_id là mô hình chạm nổi (bas-relief), mà endpoint này không thể remesh. Thông báo là This model type does not support this operation. Hãy gửi một mô hình khác.

input_task_id không khớp với bất kỳ tác vụ nào của bạn. Hãy kiểm tra ID tác vụ, rồi gửi lại yêu cầu.

Bạn đã vượt quá giới hạn tốc độ. Hãy đợi, rồi thử lại. Xem Giới hạn tốc độ.

ID của tác vụ từ phản hồi tạo.

ID của tác vụ cần xóa.

Số trang cần trả về, tối đa 255. Giá trị lớn hơn sẽ trả về lỗi 400.

Số lượng tác vụ trên mỗi trang, tối đa 100.

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

ID tác vụ từ phản hồi tạo.

ID của tác vụ. Hãy coi nó như một chuỗi không minh bạch, và đừng phụ thuộc vào định dạng của nó.

Loại tác vụ, luôn là remesh.

URL tải xuống cho mô hình đã remesh, mỗi URL ứng với một định dạng tệp. 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ì là một chuỗi rỗng.

URL tải xuống cho hình ảnh xem trước của mô hình đã remesh.

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.

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.

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.

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.

Thời điểm tác vụ được tạo, tính bằng mili giây Unix.

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.

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.

Thời điểm các URL tải xuống 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.

URL tải xuống cho các texture map của mô hình, khi tác vụ thành công: một mảng các đối tượng, mỗi đối tượng ứng với một bộ texture. Mỗi đối tượng có một URL base_color, và cũng có thể có các URL metallic, roughness, normal, emission, và metallic_roughness. Giá trị là null cho đến khi tác vụ thành công, và là một mảng rỗng khi mô hình không có texture map nào.

Chi tiết lỗi khi tác vụ thất bại. Xem Lỗi.

Số tín dụng mà tác vụ đã sử dụng. Xuất hiện khi trạng thái là PENDING, IN_PROGRESS, hoặc SUCCEEDED. Giá trị là 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.