API Văn bản sang 3D

Trường này nên được đặt thành "preview" khi tạo một nhiệm vụ xem trước.

Mô tả loại đối tượng mà mô hình 3D thể hiện. Tối đa 800 ký tự.

Chỉ định loại tạo lưới 3D.

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

• standard: Tạo lưới 3D độ chi tiết cao thông thường.
• smart-topology: Chọn mô hình Smart Topology với ai_model (meshy-t2).
• lowpoly (không dùng nữa): Tạo lưới low-poly được tối ưu hóa cho các đa giác gọn hơn. Chúng tôi khuyến nghị dùng smart-topology thay thế.

ID của mô hình sẽ sử dụng. Các giá trị khả dụng phụ thuộc vào model_type.

Tạo theo chuẩn thông thường (model_type: standard):

• meshy-5, meshy-6, meshy-7, latest (Meshy 7)

Tạo theo Smart Topology (model_type: smart-topology):

• meshy-t2 (mặc định): mô hình Smart Topology — topology gọn gàng hơn, các bộ phận được tách biệt tự nhiên, đầu ra dạng tam giác, và số lượng mặt có thể thiết lập bằng target_polycount.

Bật chế độ tạo Ultra để có hình học độ trung thực cao hơn với chi tiết bề mặt tinh xảo hơn. Quá trình tạo mất nhiều thời gian hơn và tốn thêm 5 tín dụng.

Kiểm soát việc có bật giai đoạn remesh hay không. Đối với mô hình chất lượng cao nhất, chúng tôi khuyến nghị đặt should_remesh thành false.

Số đa giác (mặt) mục tiêu trong đầu ra. Số lượng thực tế có thể khác với mục tiêu tùy thuộc vào hình học.

target_polycount có tác dụng trong hai trường hợp độc lập:

• Remesh — với should_remesh: true trên một mô hình standard. Lưới được remesh (decimate) xuống xấp xỉ số lượng này. Phạm vi từ 100 đến 300.000, mặc định 30.000. Nếu decimation_mode được đặt, nó sẽ được ưu tiên và target_polycount sẽ bị bỏ qua.
• Smart Topology — với model_type: smart-topology và ai_model: meshy-t2. Mô hình được tạo trực tiếp với số lượng mặt này; không có bước remesh nào chạy và không cần should_remesh. Phạm vi từ 100 đến 15.000, mặc định 4.000.

Không dùng nữa. Tham số này không còn ảnh hưởng đến đầu ra.

Trường symmetry_mode kiểm soát hành vi đối xứng trong quá trình tạo mô hình.

Các giá trị hợp lệ là:

• off: Tắt tính năng đối xứng.
• auto: Tự động xác định và áp dụng tính đối xứng dựa trên hình học đầu vào.
• on: Bắt buộc đối xứng trong quá trình tạo.

Chỉ định pose_mode cho mô hình được tạo.

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

• a-pose: Tạo mô hình ở tư thế A.
• t-pose: Tạo mô hình ở tư thế T.
• "" (chuỗi rỗng): Không áp dụng tư thế cụ thể nào.

Hãy dùng pose_mode thay thế. Xác định có tạo mô hình ở tư thế A/T hay không.

Không được hỗ trợ bởi Meshy-6. Các yêu cầu dùng Meshy-6 sẽ bỏ qua art_style, và một số kết hợp có thể gây ra lỗi. Các giá trị khả dụng: realistic, sculpture.

Khi được đặt thành true, nội dung đầu vào sẽ tự động được kiểm duyệt để phát hiện nội dung có khả năng gây hại. Nếu phát hiện nội dung có hại, nhiệm vụ sẽ không tiếp tục tạo.

Văn bản từ prompt sẽ được kiểm duyệt.

Chỉ định các định dạng tệp 3D nào sẽ được đưa vào đầu ra. Chỉ những đị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 nhiệm vụ. Khi bỏ trống, tất cả các định dạng được hỗ trợ sẽ được đưa vào.

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

Khi được đặt thành true, nhiệm vụ sẽ đồng thời kết xuất một phiên bản xem trước có nền trong suốt (RGBA) 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.

Khi được đặt thành true, dịch vụ sẽ dùng AI vision để tự động ước tính chiều cao thực tế của đối tượng và đổi kích thước mô hình cho phù hợp. Gốc tọa độ sẽ mặc định là bottom trừ khi origin_at được đặt rõ ràng.

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

• Thiếu tham số: Thiếu một tham số bắt buộc (ví dụ: prompt, mode).
• Tham số không hợp lệ: art_style không phải là một trong các giá trị được cho phép.
• Prompt quá dài: prompt vượt quá giới hạn ký tự.

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 nhiệm vụ này.

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

Trường này nên được đặt là "refine" khi tạo một tác vụ refine.

ID của tác vụ preview tương ứng.

Trạng thái của tác vụ preview đã cho phải là SUCCEEDED.

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

Độ phân giải texture base color. 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 ghi lại nhiều chi tiết bề mặt hơn. Chỉ áp dụng cho mode refine.

Sử dụng texture_resolution thay thế — tương đương với texture_resolution: "4k". Khi cả hai được đặt, texture_resolution sẽ được ưu tiên.

Cung cấp một prompt văn bản bổ sung để định hướng quá trình tạo texture. Tối đa 800 ký tự.

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

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ề một data URI: data:image/jpeg;base64,<your base64-encoded image data>

ID của model được sử dụng để refine. Các giá trị khả dụng: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

Khi được đặt là true, nội dung đầu vào sẽ tự động được kiểm duyệt để phát hiện nội dung có khả năng gây hại. Nếu phát hiện nội dung có hại, tác vụ sẽ không tiếp tục quá trình tạo.

Cả văn bản từ texture_prompt và hình ảnh từ texture_image_url đều sẽ được kiểm duyệt.

Loại bỏ các điểm sáng và bóng đổ khỏi texture base color, tạo ra kết quả sạch hơn, hoạt động tốt hơn dướ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 và trả về, điều này có thể giảm thời gian hoàn thành tác vụ. Khi bị 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 là true, tác vụ sẽ tạo thêm một phiên bản nền trong suốt (RGBA) của bản preview 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.

Khi được đặt là true, dịch vụ sẽ sử dụng AI vision để tự động ước tính chiều cao thực tế của đối tượng và thay đổi kích thước mô hình cho phù hợp. Gốc tọa độ sẽ mặc định là bottom trừ khi origin_at được thiết lập rõ ràng.

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

• ID tác vụ không hợp lệ: preview_task_id không hợp lệ hoặc không tồn tại.
• Tác vụ chưa sẵn sàng: Tác vụ preview chưa thành công.
• Không khớp model: AI model của tác vụ preview không tương thích với model refine được yêu cầu.

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.

Không tìm thấy tác vụ preview được chỉ định bởi preview_task_id.

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

Định danh duy nhất cho nhiệm vụ Văn bản sang 3D cần truy xuất.

ID của nhiệm vụ Văn bản sang 3D cần xóa.

Số trang cho phân trang.

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

Trườ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 cho nhiệm vụ Văn bản sang 3D để truyền tải.

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

Loại nhiệm vụ Văn bản sang 3D. Các giá trị có thể là text-to-3d-preview cho các nhiệm vụ giai đoạn preview và text-to-3d-refine cho các nhiệm vụ giai đoạn refine.

URL có thể tải xuống cho tệp mô hình 3D có 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 thay vì trả về một chuỗi rỗng.

Đây là prompt không thay đổi đã được sử dụng để tạo nhiệm vụ.

Duy trì để tương thích ngược. Trường này không có tác động chức năng đến các mô hình được tạo ra.

art_style không thay đổi đã được sử dụng để tạo nhiệm vụ preview. Không được hỗ trợ bởi Meshy-6.

Duy trì để tương thích ngược. Trường này không có tác động chức năng đến các mô hình được tạo ra.

Prompt văn bản bổ sung được cung cấp để hướng dẫn quá trình tạo texture trong giai đoạn refine.

Phản ánh giá trị ultra_mode mà nhiệm vụ preview được tạo ra. Chỉ có mặt cho các nhiệm vụ preview meshy-7 (hoặc latest) mà đã đặt ultra_mode rõ ràng; nếu không thì bị bỏ qua.

URL có thể tải xuống cho hình ảnh texture đã được sử dụng để hướng dẫn quá trình tạo texture.

URL có thể tải xuống cho ảnh thu nhỏ của tệp mô hình.

URL có thể tải xuống cho phiên bản nền trong suốt (RGBA) của thumbnail_url. Chỉ có khi nhiệm 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 thì trường này bị bỏ qua.

URL có thể tải xuống cho video preview. Sẽ bị loại bỏ trong bản phát hành tương lai.

Tiến độ của nhiệm vụ. Nếu nhiệm vụ chưa bắt đầu, thuộc tính này sẽ là 0. Khi nhiệm vụ đã thành công, điều này sẽ trở thành 100.

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

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

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

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

Một mảng các đối tượng URL texture được tạo ra từ nhiệm vụ. Thông thường, điều 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 nhiệm vụ trước đó.

Chi tiết lỗi cho các nhiệm vụ thất bại. Xem Lỗi để tham khảo đầy đủ đối tượng task_error.

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