API Remesh

ID dari tugas Gambar ke 3D atau Teks ke 3D yang telah selesai yang ingin Anda remesh. Tugas ini harus salah satu dari tugas berikut: Pratinjau Teks ke 3D, Penyempurnaan Teks ke 3D, Gambar ke 3D atau Retexture. Selain itu, harus memiliki status SUCCEEDED.

Silakan sediakan model 3D untuk Meshy untuk remesh 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 disebutkan, hanya GLB yang dihasilkan.

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

Tentukan topology dari model yang dihasilkan.

Nilai yang tersedia:

• quad: Menghasilkan mesh dominan quad.
• triangle: Menghasilkan mesh segitiga yang tereduksi.

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

Rentang nilai yang valid bervariasi tergantung pada tingkat pengguna:

• 100 hingga 300,000 (inklusif)

Aktifkan decimation adaptif dengan menetapkan tingkat jumlah poligon. Ketika diatur, target_polycount 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 menggunakan Resize API yang didedikasikan.

Ubah ukuran model sehingga dimensi kotak pembatas terpanjang sama dengan nilai yang ditentukan dalam meter. Kami merekomendasikan menggunakan Resize API yang didedikasikan.

Ketika diatur ke true, layanan menggunakan visi AI untuk secara otomatis memperkirakan tinggi dunia nyata dari objek dan mengubah ukuran model sesuai. Kami merekomendasikan menggunakan Resize API yang didedikasikan.

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

Ketika diatur ke true, tugas juga merender versi pratinjau dengan latar belakang transparan (RGBA) dan mengembalikannya sebagai alpha_thumbnail_url pada respons GET. Field thumbnail_url yang ada tidak berubah.

Permintaan tidak dapat diterima. Penyebab umum:

• Parameter hilang: Baik 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 bersamaan.

Autentikasi gagal. Silakan periksa kunci API Anda.

Kredit tidak mencukupi untuk melakukan tugas ini.

Anda telah melebihi batas laju Anda.

ID dari tugas remesh yang akan diambil.

ID dari tugas remesh yang akan dihapus.

Nomor halaman untuk paginasi.

Batas ukuran halaman. Maksimum yang diizinkan adalah 50 item.

Bidang untuk pengurutan.

Nilai yang tersedia:

• +created_at: Urutkan berdasarkan waktu pembuatan dalam urutan naik.
• -created_at: Urutkan berdasarkan waktu pembuatan dalam urutan turun.

Pengenal unik untuk tugas Remesh yang akan di-stream.

Pengenal unik untuk tugas. Meskipun kami menggunakan UUID yang dapat diurutkan secara k untuk id tugas sebagai detail implementasi, Anda tidak boleh membuat asumsi apa pun tentang format id tersebut.

Jenis tugas Remesh. Nilainya adalah remesh.

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

URL yang dapat diunduh untuk gambar pratinjau yang dirender dari model yang telah di-remesh.

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

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

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

Jumlah tugas sebelumnya.

Stempel waktu ketika tugas dibuat, dalam milidetik.

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

Stempel waktu ketika 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 dikonsumsi oleh tugas ini. Ada ketika status tugas adalah PENDING, IN_PROGRESS, atau SUCCEEDED. Mengembalikan 0 untuk tugas FAILED (kredit dikembalikan jika gagal).