Remesh API

ID dari tugas Gambar ke 3D atau Teks ke 3D yang telah selesai dan 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, statusnya harus SUCCEEDED.

Berikan sebuah 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.

Daftar format target untuk model yang telah di-remesh. Jika tidak diisi, 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 oleh quad.
• triangle: Menghasilkan mesh segitiga yang telah didesimasi.

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

Rentang nilai yang valid bervariasi tergantung pada tingkat pengguna:

• 100 hingga 300.000 (inklusif)

Aktifkan desimasi adaptif dengan menetapkan level jumlah poligon. Jika 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 disediakan sebagai gantinya.

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

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 disediakan sebagai gantinya.

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 disediakan sebagai gantinya.

Jika diatur ke true, tugas juga akan me-render versi latar belakang transparan (RGBA) dari pratinjau 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 menunjuk ke file dengan ekstensi yang tidak didukung.
• URL tidak dapat dijangkau: model_url tidak dapat diunduh.
• Topology tidak valid: Parameter topology tidak valid.
• Parameter saling eksklusif: auto_size dan resize_height tidak dapat diatur secara bersamaan.

Autentikasi gagal. Silakan periksa kunci API Anda.

Kredit tidak cukup untuk menjalankan tugas ini.

Anda telah melampaui batas laju Anda.

ID dari tugas remesh yang akan diambil.

ID dari tugas remesh yang akan dihapus.

Nomor halaman untuk paginasi.

Batas ukuran halaman. Maksimal yang diizinkan adalah 50 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 tugas Remesh yang akan di-streaming.

Pengidentifikasi unik untuk tugas ini. Meskipun kami menggunakan k-sortable UUID untuk id tugas sebagai detail implementasi, Anda tidak boleh membuat asumsi apa pun tentang format id tersebut.

Tipe dari tugas Remesh. 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, alih-alih 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 saat tugas dibuat dengan alpha_thumbnail: true dan pratinjau transparan berhasil dirender; jika tidak, kolom ini akan dihilangkan.

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

Status dari tugas ini. Nilai yang mungkin adalah salah satu dari PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

Jumlah tugas yang mendahului.

Stempel waktu saat tugas dibuat, dalam milidetik.

Stempel waktu saat tugas dimulai, dalam milidetik. Jika tugas belum dimulai, properti ini akan bernilai 0.

Stempel waktu saat tugas selesai, dalam milidetik. Jika tugas belum selesai, properti ini akan bernilai 0.

Detail kesalahan untuk tugas yang gagal. Lihat Kesalahan untuk referensi lengkap objek task_error.

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