Auto Split API

ID dari tugas yang berhasil yang modelnya ingin dipisah. Jenis tugas yang didukung: Gambar ke 3D, Multi-Gambar ke 3D, Teks ke 3D (preview), Remesh, Konversi, dan Ubah ukuran. Tugas tersebut harus berstatus 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.

Cara model dibagi menjadi beberapa bagian.

Nilai yang tersedia:

• auto: Meshy yang menentukan pemotongan. prompt diabaikan.
• by_parts: Memotong sesuai dengan bagian struktural yang Anda sebutkan dalam prompt, seperti kepala, lengan, dan badan.
• by_color: Memotong sesuai dengan wilayah 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 adalah objek terpisah dalam setiap format. glb selalu dihasilkan dan dikembalikan dalam model_urls; cantumkan format lain yang Anda inginkan sebagai tambahan.

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

3mf ditulis untuk slicer: satu objek per bagian, masing-masing pada slot filamen sendiri, sehingga Bambu Studio membuka file tersebut sebagai bagian-bagian yang berwarna secara individual dan dapat dipilih secara terpisah (arsip tersebut membawa konfigurasi proyek Bambu Studio; slicer lain membaca geometrinya). Seperti format cetak Meshy lainnya, satuannya dalam milimeter dan, karena endpoint ini tidak menerima ukuran target, seluruh model diskalakan sehingga sisi terpanjangnya menjadi 150 mm — batas yang sama yang digunakan oleh ekspor format cetak lainnya, dipilih agar sesuai dengan semua build plate mainstream. Dengan layout: "on_plate", batas tersebut berlaku untuk keseluruhan plate yang sudah ditata, sehingga file siap untuk di-slice; dengan assembled, bagian-bagian tersebut tetap berada di posisi seperti pada model sumber dan Anda mengaturnya sendiri di slicer.

Cara bagian-bagian diatur dalam setiap format output, dan dalam thumbnail.

Nilai yang tersedia:

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

Pada kedua layout tersebut, file yang diekspor hanya berisi satu objek per bagian dan tidak ada yang lain: potongan tipis atau bagian menyerupai titik yang tersisa dari suatu pemotongan akan dihapus sebelum ekspor, sehingga setiap objek yang Anda temukan dalam file tersebut dapat dicetak.

Menambahkan konektor mortise-and-tenon pada setiap pemotongan sehingga bagian-bagian yang dicetak dapat saling terpasang.

Permintaan tidak dapat diterima. Penyebab umum:

• Prompt tidak ada: prompt diperlukan ketika mode adalah by_parts atau by_color.
• Prompt menyebutkan kurang dari dua bagian: by_parts / by_color memerlukan setidaknya dua bagian bernama (misalnya head, torso, base); instruksi generik seperti split into individual parts akan ditolak. Tidak ada biaya yang dikenakan.
• Tugas input tidak didukung: input_task_id harus merujuk pada tugas yang berhasil dengan 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 0.1 hingga 0.8.

Autentikasi gagal. Silakan periksa kunci API Anda.

Kredit tidak mencukupi untuk melakukan tugas ini.

input_task_id tidak ditemukan atau tidak dimiliki oleh akun Anda.

Anda telah melampaui batas laju Anda. Permintaan by_parts dan by_color juga berbagi batas parsing 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 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.

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

Tipe dari task tersebut. Nilainya adalah print-split.

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

URL yang dapat diunduh untuk pratinjau hasil render model split, dengan setiap bagian dalam warna berbeda, sesuai layout yang diminta.

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

Jumlah bagian yang dapat dicetak dalam model hasil split — satu per objek dalam file yang diekspor. Serpihan-serpihan kecil yang tidak dapat diubah menjadi bagian yang dapat dicetak oleh segmentasi akan dihapus dari file sebelum diekspor dan tidak dihitung.

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

Status dari task tersebut. Nilai yang mungkin 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 bernilai 0.

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

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

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