API Auto Split

ID dari task yang berhasil (succeeded) yang modelnya akan dipisah. Jenis task yang didukung: Gambar ke 3D, Multi-Gambar ke 3D, Teks ke 3D (pratinjau), Remesh, Konversi, dan Ubah ukuran. Task tersebut harus memiliki status SUCCEEDED, dan modelnya harus dihasilkan dengan Meshy 6 atau Meshy 7 (ai_model meshy-6, meshy-7, atau latest). Model low-poly dan Smart Topology (meshy-t2) tidak didukung.

Bagaimana model dibagi menjadi beberapa bagian.

Nilai yang tersedia:

• auto: Meshy yang menentukan potongannya. prompt diabaikan.
• by_parts: Potong berdasarkan bagian struktural yang Anda sebutkan dalam prompt, seperti kepala, lengan, dan tubuh.
• by_color: Potong berdasarkan area warna yang Anda sebutkan dalam prompt. Memerlukan input yang dihasilkan dari gambar yang diunggah (Gambar ke 3D atau Multi-Gambar ke 3D); input lain akan ditolak dengan 400.

Format untuk mengekspor model yang telah dipisah. Setiap bagian menjadi objek terpisah di setiap format. glb selalu dihasilkan dan dikembalikan dalam model_urls; sebutkan format lain yang Anda inginkan sebagai tambahan.

Nilai yang tersedia: glb, obj, fbx, usdz, blend, 3mf.

Bagaimana bagian-bagian diatur di setiap format output, dan di dalam thumbnail.

Nilai yang tersedia:

• assembled: Bagian-bagian tetap berada di posisi asalnya seperti pada model sumber.
• on_plate: Bagian-bagian diletakkan rata dan disebar di atas build plate, siap untuk diiris (slice) — susunan yang sama seperti tampilan On Plate di aplikasi web.

Pada kedua tata letak tersebut, file yang diekspor hanya berisi satu objek per bagian dan tidak ada yang lain: potongan tipis yang menyusut atau berbentuk seperti titik yang tersisa dari sebuah pemotongan akan dihapus sebelum diekspor, sehingga setiap objek yang Anda temukan dalam file tersebut dapat dicetak.

Menambahkan konektor mortise-and-tenon di setiap potongan agar bagian-bagian yang dicetak dapat saling pas.

Permintaan tidak dapat diterima. Penyebab umum:

• Prompt tidak ada: prompt wajib diisi ketika mode adalah by_parts atau by_color.
• Prompt menyebutkan kurang dari dua bagian: by_parts / by_color memerlukan setidaknya dua bagian yang disebutkan (misalnya head, torso, base); instruksi umum seperti split into individual parts akan ditolak. Tidak ada biaya yang dikenakan.
• Task input tidak didukung: input_task_id harus merujuk pada task yang berhasil (succeeded) dari jenis yang didukung, yang dihasilkan dengan Meshy 6 atau Meshy 7.
• Input bertekstur: Model input memiliki texture. Untuk saat ini, hanya model tanpa texture yang didukung.
• Tidak ada gambar referensi: by_color memerlukan input yang dihasilkan dari gambar yang diunggah.
• Format tidak didukung: target_formats berisi stl.
• Konektor di luar rentang: connector_size atau connector_height berada di luar rentang 0.1 hingga 0.8.

Autentikasi gagal. Silakan periksa kunci API Anda.

Kredit tidak cukup untuk melakukan task ini.

input_task_id tidak ada atau bukan milik akun Anda.

Anda telah melampaui batas laju Anda. Permintaan by_parts dan by_color juga berbagi batas penguraian prompt sebesar 12 permintaan per menit per akun.

Pemisahan berbasis prompt (by_parts dan by_color) untuk sementara tidak tersedia. Coba lagi nanti, atau gunakan mode: "auto", yang tidak terpengaruh. Tidak ada biaya yang dikenakan.

ID dari task Auto Split yang akan diambil.

ID dari tugas Auto Split yang akan dihapus.

Nomor halaman untuk paginasi. Dimulai dan defaultnya adalah 1.

Batas ukuran halaman. Defaultnya 10 item. Maksimum yang diizinkan adalah 100 item; nilai yang lebih besar akan dibatasi menjadi 100.

Kolom untuk pengurutan. Nilai yang tersedia:

• +created_at: Urutkan berdasarkan waktu pembuatan secara ascending.
• -created_at: Urutkan berdasarkan waktu pembuatan secara descending.

Pengidentifikasi unik untuk tugas Auto Split yang akan di-stream.

Pengidentifikasi unik untuk tugas ini. Meskipun kami menggunakan UUID yang dapat diurutkan-k (k-sortable) sebagai detail implementasi untuk id tugas, Anda tidak boleh membuat asumsi apa pun tentang format id tersebut.

Jenis tugas. Nilainya adalah print-split.

URL yang dapat diunduh untuk model yang telah dipisah, satu per format yang diminta. Setiap bagian merupakan objek terpisah dalam file. Properti untuk sebuah format akan dihilangkan jika format tersebut tidak diminta.

URL yang dapat diunduh untuk pratinjau hasil render dari model yang telah dipisah, dengan setiap bagian dalam warna yang berbeda, dalam layout yang diminta.

true ketika prompt dari permintaan by_parts atau by_color tidak menyebutkan nama bagian apa pun, sehingga Meshy memisahkan model secara otomatis — nama-nama bagian dalam hasil adalah milik Meshy, bukan milik Anda. Hadir mulai dari PENDING. Dihilangkan untuk tugas auto dan setiap kali prompt tersebut diikuti.

Jumlah bagian yang dapat dicetak dalam model yang telah dipisah — satu per objek dalam file yang diekspor. Serpihan tipis yang menyatu (collapsed slivers) yang tidak dapat diubah oleh segmentasi menjadi bagian yang dapat dicetak dihapus dari file sebelum diekspor dan tidak dihitung.

Progress dari tugas ini. Jika tugas belum dimulai, properti ini akan bernilai 0. Setelah tugas berhasil, ini akan menjadi 100.

Status dari tugas ini. Nilai yang mungkin adalah salah satu dari PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Jumlah tugas yang mendahului.

Stempel waktu saat tugas dibuat, dalam milidetik.

Stempel waktu saat tugas dimulai, dalam milidetik. Jika tugas belum dimulai, properti ini akan bernilai 0.

Stempel waktu saat tugas selesai, dalam milidetik. Jika tugas belum selesai, properti ini akan bernilai 0.

Detail kesalahan untuk tugas yang gagal. Lihat Kesalahan untuk referensi lengkap objek task_error.

Jumlah kredit yang digunakan oleh tugas ini. Selalu ada: 10 setelah tugas diterima, dan 0 untuk tugas FAILED karena biaya dikembalikan saat gagal. Menghapus tugas ketika masih PENDING juga akan mengembalikan biayanya.