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 (pratinjau), 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, meshy-t2.5) tidak didukung. Model bertekstur dapat diterima, dan teksturnya tidak akan dibawa ke hasil akhir.

Bagaimana model dibagi menjadi beberapa bagian.

Nilai yang tersedia:

• auto: Meshy memilih sendiri titik potongnya. prompt diabaikan.
• by_parts: Potong sesuai bagian struktural yang Anda sebutkan di prompt, seperti kepala, lengan, dan torso.
• by_color: Potong sesuai wilayah warna yang Anda sebutkan di prompt. Memerlukan input yang dihasilkan dari gambar yang diunggah (Gambar ke 3D atau Multi-Gambar ke 3D); input lainnya 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 mengenal konsep objek terpisah, sehingga menyatukan setiap bagian menjadi satu benda padat yang disusun berdasarkan layout (minta 3mf untuk mendapatkan bagian yang dapat dipilih secara terpisah di slicer). glb selalu dihasilkan dan dikembalikan dalam model_urls; sebutkan 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 aslinya seperti pada model sumber.
• on_plate: Bagian-bagian diletakkan rata dan disebar di atas build plate, siap untuk di-slice — susunan yang sama seperti tampilan On Plate di aplikasi web.

Pada kedua tata letak tersebut, irisan tipis yang kolaps atau potongan seperti titik yang tersisa dari sebuah potongan akan dihapus sebelum diekspor, sehingga setiap bagian yang Anda dapatkan dapat dicetak. Format yang mendukung objek adegan menyimpan satu objek per bagian; stl menyatukannya menjadi satu benda padat.

Menambahkan konektor mortise-and-tenon di setiap potongan sehingga bagian-bagian hasil cetakan dapat dipasangkan bersama.

Permintaan tidak dapat diterima. Penyebab umum:

• Prompt tidak ada: prompt diperlukan saat mode bernilai by_parts atau by_color.
• Prompt tidak meminta pemisahan, atau terlalu banyak bagian: by_parts / by_color menerima 1 hingga 10 nama bagian. Deskripsi yang meminta model tetap utuh, 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 dari jenis yang didukung, yang dihasilkan dengan Meshy 6 atau Meshy 7.
• Tidak ada gambar referensi: by_color memerlukan 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 tidak termasuk dalam akun Anda.

Anda telah melebihi 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 akan diambil.

ID dari tugas Auto Split yang akan dihapus.

Nomor halaman untuk paginasi. Dimulai dan defaultnya adalah 1.

Batas ukuran halaman. Defaultnya adalah 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.

Pengenal unik untuk task Auto Split yang akan di-stream.

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

Jenis task. Nilainya adalah print-split.

URL yang dapat diunduh untuk model split, satu per format yang diminta. Format yang mendukung objek adegan menyimpan setiap bagian sebagai objek terpisah; stl menyatukannya menjadi satu objek padat. Properti untuk suatu format akan dihilangkan jika format tersebut tidak diminta.

URL yang dapat diunduh untuk pratinjau render dari model split, 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 melakukan split model secara otomatis — nama bagian dalam hasil adalah milik Meshy, bukan milik Anda. Ada sejak PENDING. Dihilangkan untuk task auto dan setiap kali prompt diikuti.

Jumlah bagian yang dapat dicetak yang dihasilkan oleh split. Format yang mendukung objek adegan membawa satu objek per bagian; stl menyatukannya menjadi satu objek padat, dan hitungannya tetap melaporkan jumlah bagian. Pecahan kecil yang runtuh yang tidak dapat diubah oleh segmentasi menjadi bagian yang dapat dicetak akan dihapus dari file sebelum diekspor dan tidak dihitung.

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

Status dari task. 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. Jika pemeriksaan keamanan penyedia model menolak model input, task gagal dengan task_error.type invalid_input dan code provider_content_refused. Lihat Kesalahan.

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