Remesh API

ID của tác vụ Ảnh sang 3D hoặc Văn bản sang 3D đã hoàn thành mà bạn muốn remesh. Tác vụ này phải là một trong các loại tác vụ sau: Text to 3D Preview, Text to 3D Refine, Image to 3D hoặc Retexture. Ngoài ra, tác vụ đó phải có trạng thái là SUCCEEDED.

Vui lòng cung cấp một mô hình 3D để Meshy remesh thông qua một URL công khai hoặc data URI. Các định dạng được hỗ trợ: .glb, .gltf, .obj, .fbx, .stl.

Đối với Data URI, hãy sử dụng MIME type: application/octet-stream.

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 dưới dạng tam giác: một tứ giác được tính là 2, và một lưới được vẽ nhiều lần sẽ được tính một lần cho mỗi bản sao. Trên 100 MB, tệp FBX phải là FBX nhị phân phiên bản 7.1 trở lên, và tệp GLB hoặc glTF không được sử dụng nén Draco.

Danh sách các định dạng đích cho mô hình đã remesh. Khi bỏ trống, chỉ GLB được tạo.

Các giá trị khả dụng: glb, fbx, obj, usdz, blend, stl, 3mf.

Chỉ định topology của mô hình được tạo.

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

• quad: Tạo một lưới chủ yếu là tứ giác.
• triangle: Tạo một lưới tam giác đã giảm số đa giác.

Chỉ định số đa giác mục tiêu trong mô hình được tạo. Số đa giác thực tế có thể lệch so với mục tiêu tùy thuộc vào độ phức tạp của hình học.

Phạm vi hợp lệ là từ 100 đến 300.000 (bao gồm cả hai đầu).

Bật chế độ giảm số đa giác thích ứng bằng cách thiết lập một mức số đa giác. Khi được thiết lập, target_polycount sẽ bị bỏ qua.

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

• 1: Thích ứng — số đa giác siêu cao.
• 2: Thích ứng — số đa giác cao.
• 3: Thích ứng — số đa giác trung bình.
• 4: Thích ứng — số đa giác thấp.

Đổi kích thước mô hình theo một chiều cao nhất định tính bằng mét. Chúng tôi khuyến nghị sử dụng Resize API chuyên dụng thay thế.

Đổi kích thước mô hình sao cho chiều dài nhất của hộp bao bằng giá trị được chỉ định tính bằng mét. Chúng tôi khuyến nghị sử dụng Resize API chuyên dụng thay thế.

Khi được đặt thành true, dịch vụ sẽ sử dụng AI vision để tự động ước tính chiều cao thực tế của vật thể và đổi kích thước mô hình tương ứng. Chúng tôi khuyến nghị sử dụng Resize API chuyên dụng thay thế.

Nếu true, dịch vụ sẽ chỉ thay đổi định dạng của tệp mô hình đầu vào, bỏ qua các đầu vào khác như topology, resize_height, và target_polycount. Chúng tôi khuyến nghị sử dụng Convert API chuyên dụng thay thế.

Khi được đặt thành true, tác vụ sẽ render thêm một phiên bản nền trong suốt (RGBA) của bản xem trước 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.

Yêu cầu không được chấp nhận. Các nguyên nhân phổ biến:

• Thiếu tham số: Phải cung cấp model_url hoặc input_task_id.
• Tác vụ đầu vào không hợp lệ: input_task_id phải tham chiếu đến một tác vụ thành công từ một mô hình được hỗ trợ.
• Định dạng mô hình không hợp lệ: model_url trỏ đến một tệp có phần mở rộng không được hỗ trợ.
• URL không thể truy cập: Không thể tải xuống model_url.
• Tệp mô hình quá lớn: Tệp model_url vượt quá 400 MB (URL http hoặc https) hoặc 100 MB (URI data:).
• Quá nhiều mặt: Tệp model_url có dung lượng trên 100 MB và có hơn 10.000.000 mặt. Hãy giảm số lượng mặt, sau đó gửi lại tệp.
• ASCII FBX trên 100 MB: Tệp 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: Tệp model_url có dung lượng trên 100 MB và không thể đọc được phần header của nó, ví dụ như 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: 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.
• Topology không hợp lệ: Tham số topology không hợp lệ.
• Các tham số loại trừ lẫn nhau: auto_size và resize_height không thể cùng được thiết lập.

Xác thực thất bại. Vui lòng kiểm tra khóa API của bạn.

Không đủ tín dụng để thực hiện tác vụ này.

Bạn đã vượt quá giới hạn tốc độ.

ID của remesh task cần lấy thông tin.

ID của remesh task cần xóa.

Số trang cho việc phân trang.

Giới hạn kích thước trang. Tối đa cho phép là 100 mục.

Trường để sắp xếp theo.

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

• +created_at: Sắp xếp theo thời gian tạo theo thứ tự tăng dần.
• -created_at: Sắp xếp theo thời gian tạo theo thứ tự giảm dần.

Định danh duy nhất của Remesh task cần stream.

Định danh duy nhất cho tác vụ. Mặc dù chúng tôi sử dụng UUID có thể sắp xếp theo k (k-sortable) làm chi tiết triển khai cho id tác vụ, bạn không nên đưa ra bất kỳ giả định nào về định dạng của id.

Loại tác vụ Remesh. Giá trị là remesh.

URL có thể tải xuống cho tệp mô hình 3D đã áp texture được tạo bởi Meshy. Thuộc tính cho một định dạng sẽ bị bỏ qua nếu định dạng đó không được tạo ra, thay vì trả về chuỗi rỗng.

URL có thể tải xuống cho hình ảnh xem trước được render từ mô hình đã remesh.

URL có thể tải xuống cho phiên bản nền trong suốt (RGBA) của thumbnail_url. Chỉ xuất hiện khi tác vụ được tạo với alpha_thumbnail: true và bản xem trước trong suốt được render thành công; nếu không, trường này sẽ bị bỏ qua.

Tiến trình của tác vụ. Nếu tác vụ chưa bắt đầu, thuộc tính này sẽ là 0. Khi tác vụ đã hoàn thành, giá trị này sẽ trở thành 100.

Trạng thái của tác vụ. Các giá trị có thể là một trong các giá trị PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

Số lượng tác vụ đứng trước.

Dấu thời gian khi tác vụ được tạo, tính bằng mili giây.

Dấu thời gian khi tác vụ được bắt đầu, tính bằng mili giây. Nếu tác vụ chưa bắt đầu, thuộc tính này sẽ là 0.

Dấu thời gian khi tác vụ hoàn thành, tính bằng mili giây. Nếu tác vụ chưa hoàn thành, thuộc tính này sẽ là 0.

Chi tiết lỗi cho các tác vụ thất bại. Xem Lỗi để biết đầy đủ tham chiếu về đối tượng task_error.

Số lượng tín dụng đã tiêu thụ bởi tác vụ này. Có mặt khi trạng thái tác vụ là PENDING, IN_PROGRESS, hoặc SUCCEEDED. Trả về 0 đối với các tác vụ FAILED (tín dụng sẽ được hoàn lại khi thất bại).