Rigging API

Wajib kecuali Anda mengirim model_url. ID tugas yang modelnya ingin Anda rig. Meshy mendukung model humanoid bertekstur.

Model dapat memiliki paling banyak 380.000 segitiga (quad dihitung sebagai 2), dan model dengan jumlah lebih banyak akan mengembalikan 400. Untuk tetap berada di bawah batas, jalankan Remesh API pada model tersebut terlebih dahulu dengan target_polycount 300000 atau kurang, atau 150000 atau kurang dengan topology: quad.

Wajib kecuali Anda mengirim input_task_id. Model yang akan di-rig, sebagai URL publik atau data URI. Jika Anda mengirim keduanya, Meshy menggunakan input_task_id.

Model harus berupa file GLB (.glb) berukuran paling banyak 400 MB dari URL http atau https, atau 100 MB sebagai data URI. Rigging mendukung model humanoid bertekstur.

Model dapat memiliki paling banyak 380.000 segitiga (quad dihitung sebagai 2), dan model dengan jumlah lebih banyak akan mengembalikan 400. Untuk tetap berada di bawah batas, jalankan Remesh API pada model tersebut terlebih dahulu dengan target_polycount 300000 atau kurang, atau 150000 atau kurang dengan topology: quad.

Wajah karakter harus menghadap ke sumbu +Z, arah hadap standar glTF. Estimasi pose akan gagal untuk model yang menghadap ke sumbu lain.

File di atas 100 MB juga harus mengikuti aturan berikut:

• File dapat memiliki paling banyak 10.000.000 wajah (face). File dengan jumlah lebih banyak akan mengembalikan 400. Meshy menghitung wajah sebagai segitiga, dan mesh yang digambar lebih dari sekali dihitung sekali per salinan.
• File tidak boleh menggunakan kompresi Draco.

Perkiraan tinggi karakter, dalam meter. Meshy menggunakannya untuk menskalakan dan me-rig model dengan lebih akurat. Nilai negatif akan mengembalikan 400.

Hilangkan parameter ini jika model sudah memiliki tekstur sendiri. Tanpa itu, Meshy menggunakan tekstur yang tertanam dalam file model_url, atau tekstur dari tugas input. Jika Anda mengirimkannya, gambar ini menjadi satu-satunya tekstur model yang di-rig, dan model kehilangan peta PBR-nya.

Tekstur warna dasar model yang di-UV-unwrap, sebagai URL publik atau data URI. Gambar harus berupa file PNG berukuran paling banyak 20 MB. Format gambar lain akan mengembalikan 400.

Permintaan tidak dapat dijalankan. Pesan kesalahan menyebutkan masalah apa yang ditemukan. Contohnya:

• Parameter hilang: Baik model_url maupun input_task_id tidak dikirim.
• Format model tidak valid: File model_url memiliki ekstensi yang tidak didukung. Hanya .glb yang didukung.
• URL tidak dapat dijangkau: Meshy tidak dapat mengunduh file model_url.
• Ukuran file model terlalu besar: File model_url berukuran di atas 400 MB dari URL http atau https, atau di atas 100 MB sebagai data URI.
• Terlalu banyak wajah (face): File model_url berukuran di atas 100 MB dan memiliki lebih dari 10.000.000 wajah. Kurangi jumlah wajah, lalu kirim file tersebut lagi.
• File model tidak dapat dibaca: File model_url berukuran di atas 100 MB, dan Meshy tidak dapat membaca headernya. Misalnya, file tersebut adalah GLB yang dikompresi dengan Draco.
• Header model terlalu kompleks: File model_url berukuran di atas 100 MB, dan headernya memiliki terlalu banyak mesh, node, atau record untuk diperiksa. Kurangi jumlah objek dalam file, lalu kirim lagi.
• Gambar terlalu besar: Gambar texture_image_url berukuran di atas 20 MB.
• Format tekstur tidak valid: Gambar texture_image_url bukan file PNG.
• Tinggi tidak valid: height_meters bernilai negatif.
• Tugas input tidak valid: input_task_id tidak merujuk ke tugas API yang valid.
• Tugas input belum siap: Tugas input_task_id belum mencapai status SUCCEEDED. Tunggu hingga berhasil, lalu coba lagi.
• Jumlah wajah melebihi batas: Model input memiliki lebih dari 380.000 segitiga (quad dihitung sebagai 2). Jalankan Remesh API pada model tersebut dengan target_polycount 300000 atau kurang, atau 150000 atau kurang dengan topology: quad, sebelum me-rig model.

Perbaiki permintaan, lalu kirim lagi. Lihat Kesalahan.

Kunci API hilang atau tidak valid. Periksa header Authorization.

Contohnya:

• 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.

input_task_id adalah model relief (bas-relief), yang tidak dapat di-rig oleh endpoint ini. Pesannya adalah This model type does not support this operation. Kirim model yang berbeda.

Meshy tidak dapat menemukan file dari tugas input_task_id. Salah satu dari berikut ini berlaku:

• Meshy menghapus file tugas setelah expires_at-nya. Buat tugas tersebut lagi, lalu kirim ID tugas tersebut.
• Tugas tersebut tidak memiliki file yang diperlukan untuk rigging, seperti gambar pratinjau, misalnya tugas Konversi. Rig tugas asal file tersebut, atau kirim model sebagai model_url.

Estimasi pose gagal. Model mungkin bukan karakter humanoid yang valid. Kirim model karakter humanoid. Untuk model_url, periksa juga apakah karakter menghadap ke sumbu +Z.

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

ID task dari respons pembuatan.

ID dari task yang akan dihapus.

ID tugas dari respons pembuatan.

ID task. Perlakukan sebagai string opaque, dan jangan bergantung pada formatnya.

Jenis task, selalu rig.

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

Seberapa banyak task telah selesai, dalam persentase. Nilainya 0 hingga task dimulai dan 100 saat task berhasil.

Waktu task dibuat, dalam milidetik Unix.

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

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

Waktu file hasil task kedaluwarsa, dalam milidetik Unix. Setelah waktu ini, Meshy dapat menghapus file tersebut.

Detail kesalahan saat task gagal. Nilainya null kecuali statusnya FAILED. Lihat Kesalahan.

Jumlah kredit yang digunakan oleh task. Muncul saat statusnya PENDING, IN_PROGRESS, atau SUCCEEDED. Nilainya 0 untuk task FAILED, karena Meshy mengembalikan kredit saat task gagal.

URL file output. Sampai task berhasil, setiap URL berupa string kosong, dan basic_animations bernilai null.

Jumlah task yang berada di depan task ini dalam antrean. Nilai ini hanya berarti selama task berstatus PENDING. Kolom ini tidak disertakan saat nilainya 0.