Remesh API

ID dari tugas Image to 3D atau Text to 3D yang telah selesai yang ingin Anda remesh. Tugas ini harus merupakan salah satu dari tugas berikut: Text to 3D Preview, Text to 3D Refine, Image to 3D, atau Retexture. Selain itu, tugas tersebut harus memiliki status SUCCEEDED.

Berikan model 3D untuk di-remesh oleh Meshy melalui URL yang dapat diakses publik atau data URI. Format yang didukung: .glb, .gltf, .obj, .fbx, .stl.

Untuk Data URI, gunakan MIME type: application/octet-stream.

Ukuran file maksimum: 400 MB untuk URL http atau https, 100 MB untuk URI data:.

File GLB, glTF, FBX, atau OBJ yang berukuran lebih dari 100 MB dapat memiliki paling banyak 10.000.000 faces. Faces dihitung sebagai segitiga: satu quad dihitung sebagai 2, dan mesh yang digambar lebih dari sekali dihitung sekali per salinan. Di atas 100 MB, file FBX harus berupa FBX biner 7.1 atau yang lebih baru, dan file GLB atau glTF tidak boleh menggunakan kompresi Draco.

Daftar format target untuk model hasil remesh. Jika tidak disertakan, hanya GLB yang akan dihasilkan.

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

Tentukan topology dari model yang dihasilkan.

Nilai yang tersedia:

• quad: Menghasilkan mesh yang didominasi quad.
• triangle: Menghasilkan mesh segitiga yang telah didesimasi.

Tentukan jumlah target poligon dalam model yang dihasilkan. Jumlah poligon sebenarnya dapat menyimpang dari target tergantung pada kompleksitas geometri.

Rentang yang valid adalah 100 hingga 300.000 (inklusif).

Aktifkan desimasi adaptif dengan mengatur level jumlah poligon. Saat diatur, target_polycount akan diabaikan.

Nilai yang tersedia:

• 1: Adaptif — jumlah poligon ultra.
• 2: Adaptif — jumlah poligon tinggi.
• 3: Adaptif — jumlah poligon sedang.
• 4: Adaptif — jumlah poligon rendah.

Ubah ukuran model ke tinggi tertentu yang diukur dalam meter. Kami merekomendasikan penggunaan Resize API yang khusus untuk ini.

Ubah ukuran model sehingga dimensi bounding-box terpanjang sama dengan nilai yang ditentukan dalam meter. Kami merekomendasikan penggunaan Resize API yang khusus untuk ini.

Jika diatur ke true, layanan akan menggunakan AI vision untuk secara otomatis memperkirakan tinggi objek di dunia nyata dan mengubah ukuran model sesuai dengan itu. Kami merekomendasikan penggunaan Resize API yang khusus untuk ini.

Jika true, layanan hanya akan mengubah format file model input, mengabaikan input lain seperti topology, resize_height, dan target_polycount. Kami merekomendasikan penggunaan Convert API yang khusus untuk ini.

Jika diatur ke true, tugas juga akan merender versi latar belakang transparan (RGBA) dari preview dan mengembalikannya sebagai alpha_thumbnail_url pada respons GET. Field thumbnail_url yang sudah ada tidak berubah.

Permintaan tidak dapat diterima. Penyebab umum:

• Parameter hilang: Salah satu dari model_url atau input_task_id harus disediakan.
• Tugas input tidak valid: input_task_id harus merujuk pada tugas yang berhasil dari model yang didukung.
• Format model tidak valid: model_url mengarah ke file dengan ekstensi yang tidak didukung.
• URL tidak dapat dijangkau: model_url tidak dapat diunduh.
• File model terlalu besar: File model_url melebihi 400 MB (URL http atau https) atau 100 MB (URI data:).
• Terlalu banyak faces: File model_url berukuran lebih dari 100 MB dan memiliki lebih dari 10.000.000 faces. Kurangi jumlah faces, lalu kirim file tersebut lagi.
• ASCII FBX di atas 100 MB: File model_url adalah ASCII FBX yang berukuran lebih dari 100 MB. Kirim sebagai FBX biner atau GLB.
• File model tidak dapat dibaca: File model_url berukuran lebih dari 100 MB dan headernya tidak dapat dibaca, misalnya GLB atau glTF yang dikompresi Draco, atau FBX biner yang 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: Parameter topology tidak valid.
• Parameter saling eksklusif: auto_size dan resize_height tidak dapat diatur bersamaan.

Autentikasi gagal. Silakan periksa kunci API Anda.

Kredit tidak cukup untuk menjalankan tugas ini.

Anda telah melampaui batas laju Anda.

ID dari remesh task yang ingin diambil.

ID dari tugas remesh yang akan dihapus.

Nomor halaman untuk paginasi.

Batas ukuran halaman. Maksimum yang diizinkan adalah 100 item.

Kolom untuk pengurutan.

Nilai yang tersedia:

• +created_at: Urutkan berdasarkan waktu pembuatan secara menaik.
• -created_at: Urutkan berdasarkan waktu pembuatan secara menurun.

Identifier unik untuk task Remesh yang akan di-streaming.

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

Tipe dari Remesh task. Nilainya adalah remesh.

URL yang dapat diunduh untuk file model 3D bertekstur yang dihasilkan oleh Meshy. Properti untuk suatu format akan dihilangkan jika format tersebut tidak dihasilkan, bukannya mengembalikan string kosong.

URL yang dapat diunduh untuk gambar pratinjau yang dirender dari model hasil remesh.

URL yang dapat diunduh untuk versi latar belakang transparan (RGBA) dari thumbnail_url. Hanya ada jika task dibuat dengan alpha_thumbnail: true dan pratinjau transparan berhasil dirender; jika tidak, kolom ini akan dihilangkan.

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

Status dari task. Kemungkinan nilainya adalah salah satu dari PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

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.

Jumlah kredit yang digunakan oleh task ini. Ada jika status task adalah PENDING, IN_PROGRESS, atau SUCCEEDED. Mengembalikan 0 untuk task FAILED (kredit dikembalikan jika gagal).