Multi-Color Print API

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

In nhiều màu đọc file GLB của tác vụ, file này có thể có tối đa 8.000.000 mặt. 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ắt buộc trừ khi bạn gửi input_task_id. Mô hình cần in, dưới dạng một URL công khai hoặc một Data URI. Nếu bạn gửi cả hai, Meshy sẽ dùng input_task_id.

Một URL http hoặc https phải trỏ đến một file .glb hoặc .fbx có dung lượng tối đa 400 MB. Một Data URI phải chứa một file GLB dạng base64 có dung lượng tối đa 100 MB. Hãy dùng data:model/gltf-binary;base64,. Gửi file .fbx dưới dạng URL http hoặc https.

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

• Có thể có tối đa 8.000.000 mặt. Meshy tính mặt theo tam giác, nên 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.
• Một file FBX phải là FBX nhị phân phiên bản 7.1 trở lên.
• Một file GLB không được dùng nén Draco.

Số lượng màu tối đa trong bảng màu đầu ra, từ 1 đến 16. Để dùng giá trị mặc định, hãy bỏ qua tham số này thay vì gửi 0.

Kiểu màu của file 3MF.

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

• realistic: lấy mẫu màu trực tiếp từ texture của mô hình để có chi tiết tinh tế, chân thực như ảnh chụp, và tạo ra file lớn hơn.
• cartoon: làm phẳng màu thành các vùng đồng nhất, rõ ràng để tạo phong cách cách điệu, và tạo ra file nhỏ hơn.

Mô hình phải có màu. realistic cần một texture màu nền duy nhất, với UV trên mọi phần của lưới, còn cartoon cũng chấp nhận màu đỉnh (vertex colors). Meshy sẽ từ chối một mô hình không có texture (màu trắng). Xem model_missing_texture.

Độ sâu phân chia (subdivision depth) mà Meshy dùng để lấy mẫu màu texture lên lưới, từ 3 đến 6. 0 tương đương với việc bỏ qua tham số này. Giá trị cao hơn sẽ nắm bắt chi tiết màu tinh tế hơn, và tạo ra file lớn hơn. Chỉ kiểu realistic sử dụng tham số này, còn cartoon sẽ bỏ qua nó.

Thương hiệu máy in mà Meshy ghi cấu hình phần mềm cắt lớp (slicer preset) tương ứng vào file 3MF. Sau đó file này mở được trong phần mềm cắt lớp của thương hiệu đó với một máy in, sợi in (filament), và hồ sơ quy trình (process profile) phù hợp. Cấu hình này dùng máy in mặc định của thương hiệu, với đầu phun 0.4 mm.

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

• bambu
• anycubic
• creality
• elegoo
• flashforge
• prusa
• qidi
• snapmaker
• ankermake

Bất kỳ giá trị nào khác sẽ trả về 400.

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

• Thiếu tham số: Không có model_url lẫn input_task_id được gửi.
• Định dạng mô hình không hợp lệ: File model_url không phải là file .glb hoặc .fbx.
• URL không thể truy cập: Meshy không thể tải file model_url.
• File mô hình quá lớn: File model_url vượt quá 400 MB khi là URL http hoặc https, hoặc vượt quá 100 MB khi là Data URI.
• Quá nhiều mặt: File model_url vượt quá 100 MB và có hơn 8.000.000 mặt. Hãy giảm số lượng mặt, rồi gửi lại file.
• FBX dạng ASCII vượt quá 100 MB: File model_url là file FBX dạng ASCII vượt quá 100 MB. Hãy gửi dưới dạng FBX nhị phân hoặc GLB.
• File mô hình không đọc được: File model_url vượt quá 100 MB, và Meshy không thể đọc header của nó. Ví dụ, đó là một file GLB nén Draco, hoặc một file FBX nhị phân cũ hơn phiên bản 7.1.
• Header mô hình quá phức tạp: File model_url vượt quá 100 MB, và 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 file, rồi gửi lại.
• Tác vụ đầu vào không hợp lệ: input_task_id không phải là một tác vụ thành công.
• Quá nhiều mặt trong tác vụ đầu vào: Mô hình của input_task_id có hơn 8.000.000 mặt. Hãy chạy một tác vụ Remesh trên mô hình đó, rồi gửi ID của tác vụ Remesh thay vào đó.
• max_colors không hợp lệ: max_colors là số âm hoặc vượt quá 16.
• style không hợp lệ: style không phải là realistic hoặc cartoon.
• max_depth không hợp lệ: max_depth nằm ngoài khoảng 3 đến 6, và không phải là 0.
• printer_brand không hợp lệ: printer_brand không phải là một trong các giá trị khả dụng.
• Không có nguồn màu: Mô hình thiếu màu mà style yêu cầu. realistic cần một texture màu nền duy nhất, có UV, trên mọi phần của lưới. cartoon chấp nhận một texture màu nền hoặc màu đỉnh. Hãy tạo texture cho mô hình trước, hoặc dùng cartoon cho mô hình có màu đỉnh. Meshy chỉ kiểm tra một file .fbx được tải lên sau khi tác vụ chuẩn hóa nó, nên tác vụ sẽ thất bại với lỗi model_missing_texture thay vào đó.

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

Khóa API bị thiếu hoặc 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í: Việc tạo tác vụ yêu cầu một 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ột mô hình phù điêu (bas-relief), mà endpoint này không thể in. 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 chờ, rồi thử lại. Xem Giới hạn tốc độ.

ID 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ề. Số trang bắt đầu từ 1.

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 tác vụ.

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

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

URL tải xuống cho mô hình đã in, 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ì có một chuỗi rỗng.

Tác vụ đã hoàn thành bao nhiêu, 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 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.

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. 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 tác vụ thất bại.