Auto Split API

ID tugas yang modelnya akan dipecah. Tugas tersebut harus berstatus SUCCEEDED. Jenis tugas berikut dapat digunakan:

• Gambar ke 3D
• Multi-Gambar ke 3D
• Teks ke 3D, tugas preview atau refine
• Retexture
• Remesh
• Konversi
• Ubah ukuran

Model harus dibuat dengan Meshy 6 atau Meshy 7, yaitu dengan ai_model diatur ke meshy-6-lite, meshy-6, meshy-7, meshy-7.1, atau latest. Model Smart Topology (meshy-t2 dan meshy-t2.5) tidak didukung. Untuk tugas refine, Retexture, Remesh, Konversi, atau Ubah ukuran, aturan ini berlaku pada model asal tugas tersebut. Tugas Retexture, Remesh, Konversi, atau Ubah ukuran yang dibuat dari model yang diunggah akan mengembalikan 400.

Model dapat memiliki maksimum 8.000.000 face. Model dengan jumlah face lebih banyak akan mengembalikan 400. Dalam kasus tersebut, jalankan dulu tugas Remesh pada model tersebut, lalu kirim ID tugas Remesh sebagai gantinya.

Anda dapat memecah model bertekstur. Untuk mempertahankan teksturnya pada tiap bagian, kirim keep_texture: true.

Cara membagi model menjadi beberapa bagian.

Nilai yang tersedia:

• auto: Meshy memilih sendiri titik potongnya dan mengabaikan prompt. prompt yang lebih dari 600 karakter tetap mengembalikan 400.
• by_parts: Meshy memotong mengikuti bagian struktural yang Anda sebutkan dalam prompt, misalnya kepala, lengan, dan badan.
• by_color: Meshy memotong mengikuti wilayah warna yang Anda sebutkan dalam prompt. Meshy menemukan wilayah tersebut dari gambar sumber, bukan dari tekstur model input. Input harus dibuat dari gambar yang diunggah, dengan Gambar ke 3D atau Multi-Gambar ke 3D. Input lain akan mengembalikan 400. Untuk Multi-Gambar ke 3D, Meshy menggunakan gambar sumber pertama.

Format file yang akan dihasilkan. Meshy selalu menghasilkan glb dan mengembalikannya dalam model_urls, ditambah format lain yang Anda daftarkan.

Nilai yang tersedia:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

Setiap format kecuali stl mendukung objek adegan dan menyimpan setiap bagian sebagai objek terpisah. File STL tidak dapat menyimpan objek terpisah, sehingga Meshy menggabungkan bagian-bagian tersebut menjadi satu solid, yang disusun berdasarkan layout. Untuk mendapatkan bagian yang bisa dipilih secara terpisah di slicer, minta format 3mf.

Dengan keep_texture: true, format berikut menyimpan tekstur:

• glb, fbx, usdz, dan blend: Tekstur berada di dalam file.
• obj: Tekstur berada di dalam file material, yang dikembalikan model_urls di bawah mtl.
• stl dan 3mf: File hanya menyimpan geometri, tanpa tekstur.

Cara Meshy menyusun bagian-bagian, di setiap format file dan di thumbnail.

Nilai yang tersedia:

• assembled: Meshy mempertahankan posisi bagian-bagian seperti pada model sumber.
• on_plate: Meshy meratakan bagian-bagian dan menyebarkannya di atas build plate, siap untuk di-slice. Susunan ini sama dengan tampilan On Plate di aplikasi web.

Pada kedua layout tersebut, Meshy menghapus pecahan tipis atau bagian menyerupai titik yang tersisa dari potongan sebelum ekspor, sehingga setiap bagian yang Anda dapatkan siap dicetak. Format yang mendukung objek adegan menyimpan satu objek per bagian, dan stl menggabungkan bagian-bagian menjadi satu solid.

Apakah akan mempertahankan tekstur model input pada setiap bagian. true memberikan tekstur input ke setiap bagian, dan tugas mengembalikan peta-peta tekstur dalam texture_urls. false memberikan warna vertex datar pada setiap bagian.

Dengan true, tugas memakan waktu kira-kira dua kali lebih lama, dan biaya kredit tidak berubah. Input tanpa tekstur dipecah dengan cara yang sama seperti dengan false. Jika Meshy tidak dapat mempertahankan tekstur, tugas gagal dengan kode kesalahan textured_split_refused. Lihat Kesalahan.

Apakah akan menambahkan konektor mortise-and-tenon pada setiap titik potong, sehingga bagian-bagian hasil cetak dapat disatukan.

Permintaan tidak dapat dijalankan. Pesan kesalahan menunjukkan masalah apa yang ditemukan. Misalnya:

• Prompt hilang: mode adalah by_parts atau by_color, dan prompt tidak ada.
• Prompt tidak meminta pemisahan, atau menyebutkan terlalu banyak bagian: Prompt meminta model tetap utuh dalam satu bagian, atau menyebutkan lebih dari 10 bagian. by_parts dan by_color menerima 1 hingga 10 nama bagian. Meshy tidak mengenakan biaya untuk permintaan ini.
• Tugas input tidak didukung: input_task_id bukan tugas yang berhasil dari jenis yang didukung, yang dibuat dengan Meshy 6 atau Meshy 7.
• Tidak ada gambar referensi: mode adalah by_color, dan input tidak dibuat dari gambar yang diunggah.
• Konektor di luar rentang: connector_size atau connector_height berada di luar rentang 0.1 hingga 0.8.

Perbaiki permintaan, lalu kirim ulang. Lihat Kesalahan.

Kunci API tidak ada atau tidak valid. Periksa header Authorization.

Misalnya:

• Kredit tidak cukup: Akun tidak memiliki cukup kredit untuk tugas ini, atau akun telah mencapai batas kredit. Periksa saldo kredit Anda, lalu coba lagi.
• Paket gratis: Membuat tugas memerlukan paket berbayar. Tingkatkan paket Anda di pengaturan langganan, lalu coba lagi.

Salah satu dari berikut ini berlaku:

• Moderasi konten memblokir prompt. Pesannya adalah explicit content atau prohibited content. Ubah prompt, lalu coba lagi.
• input_task_id adalah model relief, yang tidak dapat dipecah oleh endpoint ini. Pesannya adalah This model type does not support this operation. Kirim model lain.

input_task_id tidak ada atau bukan milik akun Anda. Periksa ID-nya, dan gunakan kunci API dari akun yang membuat tugas tersebut.

Anda melampaui batas laju Anda. Tunggu, lalu coba lagi. Lihat Batas laju.

Permintaan by_parts dan by_color juga berbagi batas pembacaan prompt sebesar 12 permintaan per menit per akun.

Pemecahan berdasarkan prompt (by_parts dan by_color) sedang tidak tersedia untuk sementara. Coba lagi nanti, atau kirim mode: "auto", yang tetap berfungsi. Meshy tidak mengenakan biaya untuk permintaan ini.

ID tugas dari respons pembuatan.

ID tugas yang akan dihapus.

Nomor halaman yang akan dikembalikan. Dimulai dari dan secara default 1.

Jumlah tugas per halaman, hingga 100. Secara default 10. Meshy akan memperlakukan nilai yang lebih besar sebagai 100.

Urutan pengurutan.

Nilai yang tersedia:

• +created_at: terlama lebih dulu
• -created_at: terbaru lebih dulu

ID tugas dari respons pembuatan.

ID tugas. Perlakukan sebagai string buram, dan jangan mengandalkan formatnya.

Jenis tugas, selalu print-split.

URL unduhan untuk model hasil pemisahan, satu per format yang Anda minta. Format yang tidak Anda minta tidak memiliki kunci. Format yang mendukung objek adegan menyimpan setiap bagian sebagai objek terpisah, sedangkan stl menyatukan bagian-bagian tersebut menjadi satu bentuk solid.

URL unduhan untuk gambar pratinjau model hasil pemisahan, dalam layout yang Anda minta. Jika bagian-bagian mempertahankan tekstur, pratinjau menampilkannya. Jika tidak, setiap bagian memiliki warnanya sendiri.

Peta tekstur dari model hasil pemisahan, sebagai array dengan satu objek. Semua bagian berbagi peta ini. Hanya ada ketika keep_texture bernilai true dan model input memiliki tekstur.

URL unduhan untuk versi thumbnail_url dengan latar belakang transparan (RGBA). Hanya ada setelah tugas berhasil, ketika Meshy merender pratinjau transparan.

Apakah Meshy mengabaikan prompt. Nilainya true ketika prompt dari permintaan by_parts atau by_color tidak menyebutkan nama bagian apa pun, sehingga Meshy memisahkan model secara otomatis. Nama bagian dalam hasilnya kemudian menjadi milik Meshy, bukan milik Anda. Ada mulai dari PENDING. Meshy tidak menyertakannya untuk tugas auto dan setiap kali Meshy mengikuti prompt.

Jumlah bagian yang dapat dicetak yang dihasilkan oleh pemisahan. Format yang mendukung objek adegan menyimpan satu objek per bagian. stl menyatukan bagian-bagian menjadi satu bentuk solid, tetapi part_count tetap menghitungnya. Sebelum ekspor, Meshy menghapus serpihan tipis yang tidak dapat menjadi bagian yang bisa dicetak, dan tidak menghitungnya.

Seberapa banyak tugas telah selesai, dalam persentase. Nilainya 0 hingga tugas dimulai dan 100 ketika berhasil.

Status tugas, salah satu dari PENDING, IN_PROGRESS, SUCCEEDED, FAILED, atau CANCELED.

Jumlah tugas yang berada di depan tugas ini dalam antrean. Nilai ini hanya berarti selama tugas berstatus PENDING.

Waktu tugas dibuat, dalam milidetik Unix.

Waktu tugas dimulai, dalam milidetik Unix. Nilainya 0 hingga tugas dimulai.

Waktu tugas selesai, dalam milidetik Unix. Nilainya 0 hingga tugas selesai.

Waktu kedaluwarsa hasil tugas, dalam milidetik Unix. Nilainya 0 hingga tugas selesai.

Detail kesalahan ketika tugas gagal. Lihat Kesalahan.

Jika pemeriksaan keamanan menolak model input, tugas gagal dengan task_error.type diatur ke invalid_input dan task_error.code diatur ke provider_content_refused. Kirim model yang berbeda. Lihat Kesalahan.

Dengan keep_texture: true, jika Meshy tidak dapat mempertahankan tekstur, tugas gagal dengan task_error.code diatur ke textured_split_refused. Lihat Kesalahan.

Jumlah kredit yang digunakan tugas. Kolom ini selalu ada. Nilainya 10 setelah Meshy menerima tugas, dan 0 untuk tugas FAILED, karena Meshy mengembalikan kredit ketika tugas gagal. Menghapus tugas PENDING juga mengembalikan kreditnya.