Retexture API

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

Cung cấp một mô hình 3D để Meshy tạo texture. Các định dạng được hỗ trợ: .glb, .gltf, .obj, .fbx, .stl.

Kích thước tệp tối đa: 400 MB đối với URL http hoặc https, 100 MB đối với data: URI.

Một tệp GLB, glTF, FBX hoặc OBJ 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 đượ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 7.1 trở lên, và tệp GLB hoặc glTF không được sử dụng nén Draco.

Có hai cách để cung cấp mô hình:

• URL truy cập công khai: Một URL có thể truy cập được từ internet công cộng.
• Data URI: Một data URI được mã hóa base64 của mô hình. Sử dụng MIME type application/octet-stream. Ví dụ: data:application/octet-stream;base64,<dữ liệu mô hình được mã hóa base64 của bạn>.

Mô tả phong cách texture mong muốn của đối tượng bằng văn bản. Tối đa 800 ký tự.

Cung cấp một hình ảnh 2D để định hướng quá trình tạo texture. Hiện tại chúng tôi hỗ trợ các định dạng .jpg, .jpeg, .png, và .webp.

Kích thước tệp tối đa: 20 MB.

Có hai cách để cung cấp hình ảnh:

• URL truy cập công khai: Một URL có thể truy cập được từ internet công cộng
• Data URI: Một data URI được mã hóa base64 của hình ảnh. Ví dụ về data URI: data:image/jpeg;base64,<dữ liệu hình ảnh được mã hóa base64 của bạn>

Cung cấp từ 1 đến 4 hình ảnh thể hiện cùng một đối tượng từ các góc nhìn khác nhau để định hướng việc tạo texture. Hình ảnh đầu tiên là góc nhìn chính (phía trước); thứ tự của các góc nhìn còn lại (trái, sau, phải) không quan trọng.

Mỗi phần tử chấp nhận cùng định dạng như image_style_url (một URL truy cập công khai hoặc một data URI base64, .jpg/.jpeg/.png/.webp).

Kích thước tệp tối đa: 20 MB cho mỗi hình ảnh.

ID của mô hình AI được sử dụng để tạo lại texture. Các giá trị khả dụng: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).

Giữ nguyên bố cục UV hiện có của mô hình thay vì tạo bố cục mới.

• Nếu bạn đang tạo lại texture cho một mô hình do Meshy tạo ra (thông qua input_task_id, hoặc một model_url trỏ đến đầu ra của Meshy), hãy đặt giá trị này thành true để tái sử dụng bố cục UV đã được tối ưu hóa của nó.
• Nếu bạn đang tạo lại texture cho một mô hình của bên thứ ba mà bạn đã tải lên, hãy đặt true khi nó đã có UV tốt mà bạn muốn giữ lại, hoặc để false để Meshy trải UV mới (tốt nhất cho các mô hình thiếu bản đồ UV phù hợp).

Tạo bản đồ PBR (metallic, roughness, normal) bên cạnh màu cơ bản. Bản đồ emission cũng được bao gồm khi ai_model là meshy-6, ngoại trừ ở texture_resolution: 8k. meshy-6-lite, meshy-7 và latest không tạo ra bản đồ emission.

Độ phân giải texture màu cơ bản. Một trong các giá trị 2k (2048×2048), 4k (4096×4096), hoặc 8k (8192×8192). Độ phân giải cao hơn sẽ nắm bắt được nhiều chi tiết bề mặt hơn.

Hãy sử dụng texture_resolution thay thế — tương đương với texture_resolution: "4k". Khi cả hai được thiết lập, texture_resolution sẽ được ưu tiên.

Loại bỏ các vùng sáng và bóng đổ khỏi texture màu cơ bản, tạo ra kết quả sạch hơn, phù hợp hơn khi sử dụng với các thiết lập ánh sáng tùy chỉnh.

Chỉ định các định dạng tệp 3D nào sẽ được bao gồm trong đầu ra. Chỉ các định dạng được yêu cầu mới được tạo ra và trả về, điều này có thể giảm thời gian hoàn thành tác vụ. Khi bỏ qua, tất cả các định dạng được hỗ trợ sẽ được bao gồm.

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

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 thường gặp:

• Thiếu tham số: Phải cung cấp model_url hoặc input_task_id.
• Thiếu kiểu dáng: Phải cung cấp một trong các tham số text_style_prompt, image_style_url hoặc multiview_image_urls.
• Đầu vào kiểu dáng xung đột: multiview_image_urls không thể kết hợp với text_style_prompt hoặc image_style_url.
• Mô hình không được hỗ trợ cho đa góc nhìn: multiview_image_urls yêu cầu phải có ai_model: "meshy-7" một cách rõ ràng.
• Mô hình không khả dụng: ai_model: "meshy-7" và ai_model: "meshy-6-lite" đang được triển khai dần dần và có thể chưa được kích hoạt cho tài khoản của bạn.
• 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, image_style_url hoặc một phần tử trong multiview_image_urls.
• 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 (data: URI).
• Quá nhiều mặt: Tệp model_url có kích thước 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.
• FBX ASCII trên 100 MB: Tệp model_url là một tệp FBX ASCII có kích thước 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: Tệp model_url có kích thước 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: Tệp model_url có kích thước trên 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, sau đó gửi lại.
• Hình ảnh quá lớn: Hình ảnh image_style_url hoặc một phần tử trong multiview_image_urls vượt quá 20 MB.

Xác thực không thành công. Vui lòng kiểm tra lại 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 độ.

Định danh duy nhất của tác vụ Retexture cần lấy thông tin.

ID của tác vụ Tạo lại texture cần xóa.

Số trang dùng cho phân trang.

Giới hạn số lượng mỗi trang. Tối đa cho phép là 100 mục.

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

Các giá trị có sẵn:

• +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 tác vụ Tạo lại texture cần stream.

Mã đị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 của 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 của tác vụ Retexture. Giá trị là retexture.

URL để tải xuống tệp model 3D đã được áp texture do Meshy tạo ra.

Đây là prompt văn bản đã được sử dụng để tạo tác vụ texturing.

Đây là đầu vào hình ảnh đã được sử dụng để tạo tác vụ texturing.

URL để tải xuống các hình ảnh tham chiếu đa góc nhìn đã được sử dụng để tạo tác vụ texturing. Chỉ xuất hiện khi tác vụ được tạo với multiview_image_urls.

URL để tải xuống ảnh thu nhỏ của tệp model.

URL để tải xuống 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ụ đã thành công, giá trị này sẽ trở thành 100.

Dấu thời gian cho biết thời điểm tác vụ 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 cho biết thời điểm tác vụ được tạo, tính bằng mili giây.

Dấu thời gian cho biết thời điểm kết quả của tác vụ hết hạn, tính bằng mili giây.

Dấu thời gian cho biết thời điểm 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.

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, CANCELED.

Một mảng các đối tượng URL texture được tạo ra từ tác vụ. Thông thường, mảng này chỉ chứa một đối tượng URL texture. Mỗi URL texture có các thuộc tính sau:

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

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

Số lượng tín dụng đã tiêu thụ bởi tác vụ này. Xuất hiện 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).