Remesh API

Wajib kecuali Anda mengirim model_url. ID tugas yang modelnya ingin Anda remesh, misalnya tugas Text to 3D, Image to 3D, Retexture, atau Remesh. Tugas tersebut harus yang Anda buat dengan API dan memiliki status SUCCEEDED.

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

Model harus berupa file GLB, glTF, OBJ, FBX, atau STL dengan ukuran maksimal 400 MB dari URL http atau https, atau 100 MB sebagai data URI. Untuk data URI, gunakan MIME type application/octet-stream.

File di atas 100 MB juga harus mengikuti aturan berikut:

• File GLB, glTF, FBX, atau OBJ dapat memiliki maksimal 10.000.000 wajah (faces). Meshy menghitung wajah sebagai segitiga, sehingga quad dihitung sebagai 2, dan mesh yang digambar lebih dari sekali dihitung sekali per salinan.
• File FBX harus berupa FBX biner 7.1 atau lebih baru.
• File GLB atau glTF tidak boleh menggunakan kompresi Draco.

Format file yang akan dihasilkan.

Nilai yang tersedia:

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

Jenis wajah dari model yang di-remesh.

Nilai yang tersedia:

• quad: mesh dengan dominan quad
• triangle: mesh segitiga yang didesimasi

Jumlah wajah yang ditargetkan, dari 100 hingga 300000. Hasilnya dapat berbeda dari target, tergantung pada geometri model. Nilai di luar rentang akan mengembalikan 400.

Jumlah wajah adaptif, berdasarkan level. Saat Anda mengaturnya, Meshy mengabaikan target_polycount.

Nilai yang tersedia:

• 1: ultra
• 2: tinggi
• 3: sedang
• 4: rendah

Gunakan Resize API sebagai gantinya. Tinggi untuk mengubah ukuran model, dalam meter. Kirim paling banyak satu dari resize_height, resize_longest_side, dan auto_size.

Gunakan Resize API sebagai gantinya. Panjang untuk mengubah ukuran sisi terpanjang dari kotak pembatas model, dalam meter. Kirim paling banyak satu dari resize_height, resize_longest_side, dan auto_size.

Gunakan Resize API sebagai gantinya. Apakah akan memperkirakan tinggi objek di dunia nyata dengan AI vision dan mengubah ukuran model ke tinggi tersebut. Kirim paling banyak satu dari resize_height, resize_longest_side, dan auto_size.

Gunakan Resize API sebagai gantinya. Di mana menempatkan titik asal model, bottom atau center. Nilai bawaan berlaku saat Anda mengirim resize_height, resize_longest_side, atau auto_size. Tanpa salah satu dari itu, Meshy memindahkan titik asal hanya jika Anda mengirim origin_at.

Gunakan Convert API sebagai gantinya. Apakah hanya akan mengonversi model ke target_formats. Saat true, Meshy mengabaikan topology, target_polycount, decimation_mode, resize_height, resize_longest_side, dan auto_size, tetapi tetap memeriksa nilainya, sehingga nilai yang tidak valid akan mengembalikan 400. Dengan convert_format_only: true, target_formats yang kosong atau null akan mengembalikan 400.

Apakah juga akan merender pratinjau dengan latar belakang transparan (RGBA), dikembalikan dalam alpha_thumbnail_url saat Anda mengambil tugas. thumbnail_url tidak berubah.

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

• Parameter hilang: Baik model_url maupun input_task_id tidak dikirim.
• Tugas input tidak valid: input_task_id bukan tugas API yang berhasil, atau model AI-nya tidak mendukung remeshing.
• Format model tidak valid: File model_url memiliki ekstensi yang tidak didukung.
• URL tidak dapat dijangkau: Meshy tidak dapat mengunduh file model_url.
• File model terlalu besar: File model_url berukuran lebih dari 400 MB dari URL http atau https, atau lebih dari 100 MB sebagai data URI.
• Terlalu banyak wajah: File model_url berukuran lebih dari 100 MB dan memiliki lebih dari 10.000.000 wajah. Kurangi jumlah wajah, lalu kirim file tersebut lagi.
• FBX ASCII di atas 100 MB: File model_url adalah FBX ASCII yang berukuran di atas 100 MB. Kirim sebagai FBX biner atau GLB.
• File model tidak dapat dibaca: File model_url berukuran lebih dari 100 MB, dan Meshy tidak dapat membaca headernya. Misalnya, file tersebut adalah GLB atau glTF yang dikompresi Draco, atau FBX biner lebih lama dari 7.1.
• Header model terlalu kompleks: File model_url berukuran lebih dari 100 MB, dan headernya memiliki terlalu banyak mesh, node, atau record untuk diperiksa. Kurangi jumlah objek dalam file, lalu kirim lagi.
• Topology tidak valid: topology bukan quad atau triangle.
• Parameter saling eksklusif: Permintaan memiliki lebih dari satu dari auto_size, resize_height, dan resize_longest_side. Kirim hanya satu.

Perbaiki permintaan, lalu kirim lagi. Lihat Kesalahan.

Kunci API hilang atau tidak valid. Periksa header Authorization.

Misalnya:

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

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

input_task_id tidak cocok dengan tugas Anda yang mana pun. Periksa ID tugas, lalu kirim permintaan lagi.

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

ID tugas dari respons pembuatan.

ID tugas yang akan dihapus.

Nomor halaman yang akan dikembalikan, hingga 255. Nilai yang lebih besar akan mengembalikan 400.

Jumlah tugas per halaman, hingga 100.

Urutan pengurutan.

Nilai yang tersedia:

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

ID tugas dari respons pembuatan.

ID tugas. Perlakukan ini sebagai string buram, dan jangan bergantung pada formatnya.

Jenis tugas, selalu remesh.

URL unduhan untuk model yang telah di-remesh, satu per format file. Format yang tidak dihasilkan oleh tugas tidak memiliki kunci, bukannya berupa string kosong.

URL unduhan untuk gambar pratinjau dari model yang telah di-remesh.

URL unduhan untuk versi thumbnail_url dengan latar belakang transparan (RGBA). Hanya ada ketika Anda membuat tugas dengan alpha_thumbnail: true dan Meshy berhasil merender pratinjau transparan.

Seberapa banyak tugas telah selesai, dalam bentuk persentase. Nilainya 0 sampai tugas dimulai dan 100 ketika tugas 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 sampai tugas dimulai.

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

Waktu URL unduhan tugas kedaluwarsa, dalam milidetik Unix. Nilainya 0 sampai tugas selesai.

URL unduhan untuk peta tekstur model, ketika tugas berhasil: sebuah array berisi objek, satu per set tekstur. Setiap objek memiliki URL base_color, dan juga dapat memiliki URL metallic, roughness, normal, emission, dan metallic_roughness. Nilainya null sampai tugas berhasil, dan berupa array kosong ketika model tidak memiliki peta tekstur.

Detail kesalahan ketika tugas gagal. Lihat Kesalahan.

Jumlah kredit yang digunakan oleh tugas. Ada ketika status adalah PENDING, IN_PROGRESS, atau SUCCEEDED. Nilainya 0 untuk tugas FAILED, karena Meshy mengembalikan kredit ketika tugas gagal.