API Rigging

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 rig. Meshy hỗ trợ các mô hình hình người có texture.

Mô hình có thể có tối đa 380.000 tam giác (một tứ giác được tính là 2), và một mô hình có nhiều hơn sẽ trả về 400. Để giữ dưới giới hạn này, hãy chạy Remesh API trên đó trước với target_polycount là 300000 hoặc thấp hơn, hoặc 150000 hoặc thấp hơn với topology: quad.

Bắt buộc trừ khi bạn gửi input_task_id. Mô hình cần rig, dưới dạng URL công khai hoặc data URI. Nếu bạn gửi cả hai, Meshy sẽ sử dụng input_task_id.

Mô hình phải là một tệp GLB (.glb) có kích thước tối đa 400 MB từ URL http hoặc https, hoặc 100 MB dưới dạng data URI. Rigging hỗ trợ các mô hình hình người có texture.

Mô hình có thể có tối đa 380.000 tam giác (một tứ giác được tính là 2), và một mô hình có nhiều hơn sẽ trả về 400. Để giữ dưới giới hạn này, hãy chạy Remesh API trên đó trước với target_polycount là 300000 hoặc thấp hơn, hoặc 150000 hoặc thấp hơn với topology: quad.

Mặt của nhân vật phải hướng về trục +Z, hướng tiến chuẩn của glTF. Ước lượng tư thế sẽ thất bại đối với một mô hình hướng theo trục khác.

Một tệp trên 100 MB cũng phải tuân theo các quy tắc sau:

• Nó có thể có tối đa 10.000.000 mặt. Một tệp có nhiều hơn sẽ trả về 400. Meshy tính các mặt là tam giác, và một lưới được vẽ nhiều hơn một lần sẽ được tính một lần cho mỗi bản sao.
• Nó không được sử dụng nén Draco.

Chiều cao xấp xỉ của nhân vật, tính bằng mét. Meshy sử dụng giá trị này để tỷ lệ và rig mô hình chính xác hơn. Một giá trị âm sẽ trả về 400.

Bỏ trống khi mô hình đã có texture riêng. Nếu không có giá trị này, Meshy sẽ sử dụng các texture được nhúng trong tệp model_url, hoặc texture của tác vụ đầu vào. Nếu bạn gửi giá trị này, hình ảnh này sẽ trở thành texture duy nhất của mô hình đã rig, và mô hình sẽ mất các bản đồ PBR.

Texture màu cơ bản đã trải UV của mô hình, dưới dạng URL công khai hoặc data URI. Hình ảnh phải là tệp PNG có kích thước tối đa 20 MB. Một định dạng hình ảnh khác sẽ trả về 400.

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

• Thiếu tham số: Không có model_url hay input_task_id nào được gửi.
• Đị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ợ. Chỉ .glb đượ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 dưới dạng 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. Giảm số lượng mặt, sau đó gửi lại tệp.
• Tệp mô hình không đọc được: Tệp model_url vượt quá 100 MB, và Meshy không thể đọc tiêu đề của nó. Ví dụ, đó là một GLB đã nén Draco.
• Tiêu đề mô hình quá phức tạp: Tệp model_url vượt quá 100 MB, và tiêu đề của nó có quá nhiều lưới, node, hoặc bản ghi cần kiểm tra. Giảm số lượng đối tượng trong tệp, sau đó gửi lại.
• Hình ảnh quá lớn: Hình ảnh texture_image_url vượt quá 20 MB.
• Định dạng texture không hợp lệ: Hình ảnh texture_image_url không phải là tệp PNG.
• Chiều cao không hợp lệ: height_meters là số âm.
• Tác vụ đầu vào không hợp lệ: input_task_id không trỏ đến một tác vụ API hợp lệ.
• Tác vụ đầu vào chưa sẵn sàng: Tác vụ input_task_id chưa đạt trạng thái SUCCEEDED. Đợi cho đến khi nó thành công, sau đó thử lại.
• Vượt quá số lượng mặt: Mô hình đầu vào có nhiều hơn 380.000 tam giác (một tứ giác được tính là 2). Chạy Remesh API trên đó với target_polycount là 300000 hoặc thấp hơn, hoặc 150000 hoặc thấp hơn với topology: quad, trước khi rig mô hình.

Sửa yêu cầu, sau đó gửi lại. Xem Lỗi.

Khóa API bị thiếu hoặc không hợp lệ. 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. Kiểm tra số dư tín dụng của bạn, sau đó 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ý, sau đó thử lại.

input_task_id là một mô hình phù điêu, mà endpoint này không thể rig. Thông báo là This model type does not support this operation. Gửi một mô hình khác.

Meshy không thể tìm thấy các tệp của tác vụ input_task_id. Một trong các trường hợp sau áp dụng:

• Meshy đã xóa các tệp của tác vụ sau expires_at của nó. Tạo lại tác vụ, sau đó gửi ID của tác vụ đó.
• Tác vụ không có bất kỳ tệp nào mà rigging cần, chẳng hạn như hình ảnh xem trước, ví dụ như một tác vụ Convert. Rig tác vụ mà nó bắt nguồn từ đó, hoặc gửi mô hình dưới dạng model_url.

Ước lượng tư thế thất bại. Mô hình có thể không phải là một nhân vật hình người hợp lệ. Gửi một mô hình của nhân vật hình người. Đối với model_url, cũng hãy kiểm tra rằng nhân vật hướng về trục +Z.

Bạn đã vượt quá giới hạn tốc độ. Đợi, sau đó thử lại. Xem Giới hạn tốc độ.

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

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

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

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ó.

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

Trạng thái tác vụ, là một trong các giá trị PENDING, IN_PROGRESS, SUCCEEDED, FAILED, hoặc CANCELED.

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.

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 tệp kết quả của tác vụ hết hạn, tính bằng mili giây Unix. Sau thời điểm này, Meshy có thể xóa các tệp này.

Thông tin chi tiết về lỗi khi tác vụ thất bại. Giá trị là null trừ khi trạng thái là FAILED. Xem Lỗi.

Số lượng tín dụng mà tác vụ đã sử dụng. Có mặt 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 sẽ hoàn lại tín dụng khi một tác vụ thất bại.

Các URL tệp đầu ra. Cho đến khi tác vụ thành công, mỗi URL là một chuỗi rỗng, và basic_animations là null.

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. Trường này sẽ không xuất hiện khi giá trị là 0.