Auto Split API

ID dari tugas yang berhasil (succeeded) yang modelnya akan dipisah. Jenis tugas yang didukung: Gambar ke 3D, Multi-Gambar ke 3D, Teks ke 3D (preview), Remesh, Konversi, dan Ubah ukuran. Tugas tersebut harus memiliki status SUCCEEDED, dan modelnya harus dihasilkan dengan Meshy 6 atau Meshy 7 (ai_model meshy-6, meshy-7, meshy-7.1, atau latest). Model low-poly dan Smart Topology (meshy-t2) tidak didukung. Model bertekstur diterima, dan teksturnya tidak dibawa ke hasil akhir.

Bagaimana model dibagi menjadi beberapa bagian.

Nilai yang tersedia:

• auto: Meshy memilih potongannya. prompt diabaikan.
• by_parts: Potong sesuai bagian struktural yang Anda sebutkan di prompt, seperti kepala, lengan, dan badan.
• by_color: Potong sesuai wilayah warna yang Anda sebutkan di prompt. Membutuhkan input yang dihasilkan dari gambar yang diunggah (Gambar ke 3D atau Multi-Gambar ke 3D); input lain akan ditolak dengan 400. Batas wilayah warna berasal dari gambar sumber, bukan dari tekstur model input. Untuk Multi-Gambar ke 3D, Auto Split menggunakan gambar sumber pertama.

Format untuk mengekspor model yang telah dipisah. Format yang mendukung objek adegan (glb, obj, fbx, usdz, blend, 3mf) membawa setiap bagian sebagai objek terpisah; stl tidak memiliki konsep objek terpisah, sehingga menyatukan setiap bagian menjadi satu benda padat yang disusun berdasarkan layout (minta 3mf untuk bagian yang dapat dipilih secara terpisah di slicer). glb selalu dihasilkan dan dikembalikan dalam model_urls; cantumkan format lain yang Anda inginkan sebagai tambahan.

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

Bagaimana bagian-bagian disusun di setiap format output, dan di thumbnail.

Nilai yang tersedia:

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

Pada kedua layout, potongan tipis atau bagian menyerupai titik yang tersisa dari sebuah pemotongan akan dihapus sebelum diekspor, sehingga setiap bagian yang Anda dapatkan dapat dicetak. Format yang mendukung objek adegan menampung satu objek per bagian; stl menyatukannya menjadi satu benda padat.

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

Permintaan tidak dapat diterima. Penyebab umum:

• Prompt tidak ada: prompt diperlukan saat mode adalah by_parts atau by_color.
• Prompt tidak meminta pemisahan, atau terlalu banyak bagian: by_parts / by_color menerima 1 hingga 10 bagian yang disebutkan namanya. Deskripsi yang meminta model tetap satu bagian, atau menyebutkan lebih dari 10 bagian, akan ditolak. Tidak ada biaya yang dikenakan.
• Tugas input tidak didukung: input_task_id harus merujuk pada tugas yang berhasil (succeeded) dengan jenis yang didukung, yang dihasilkan dengan Meshy 6 atau Meshy 7.
• Tidak ada gambar referensi: by_color membutuhkan input yang dihasilkan dari gambar yang diunggah.
• 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 tugas 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 sebanyak 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 ingin diambil.

ID dari Auto Split task yang akan dihapus.

Nomor halaman untuk paginasi. Dimulai dan default-nya adalah 1.

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

Kolom untuk diurutkan. Nilai yang tersedia:

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

Pengenal unik untuk tugas Auto Split yang akan di-streaming.

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

Jenis task. Nilainya adalah print-split.

URL yang dapat diunduh untuk model yang telah dipisah, satu per format yang diminta. Format yang mendukung objek adegan menyimpan setiap bagian sebagai objek terpisah; stl menyatukannya menjadi satu solid. Properti untuk suatu 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 berbeda, dalam layout yang diminta.

true ketika prompt pada permintaan by_parts atau by_color tidak menyebutkan nama bagian mana pun, sehingga Meshy melakukan split model secara otomatis — nama bagian pada hasilnya adalah milik Meshy, bukan milik Anda. Ada mulai dari PENDING. Dihilangkan untuk task auto dan setiap kali prompt tersebut diikuti.

Jumlah bagian yang dapat dicetak yang dihasilkan dari split. Format yang mendukung objek adegan membawa satu objek per bagian; stl menyatukannya menjadi satu solid, dan jumlahnya tetap melaporkan jumlah bagian tersebut. Serpihan-serpihan runtuh yang tidak dapat diubah oleh segmentasi menjadi bagian yang dapat dicetak dihapus dari berkas sebelum diekspor dan tidak dihitung.

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

Status dari task tersebut. Kemungkinan nilainya adalah salah satu dari PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Jumlah task yang mendahului.

Stempel waktu saat task dibuat, dalam milidetik.

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

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

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

Jumlah kredit yang dikonsumsi oleh task ini. Selalu ada: 10 setelah task diterima, dan 0 untuk task FAILED karena biayanya dikembalikan (refund) jika gagal. Menghapus task saat masih PENDING juga akan mengembalikan (refund) biayanya.