Retexture API

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

Berikan model 3D agar Meshy dapat memberinya tekstur. Format yang didukung: .glb, .gltf, .obj, .fbx, .stl.

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

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

Ada dua cara untuk menyediakan model:

• URL yang dapat diakses publik: URL yang dapat diakses dari internet publik.
• Data URI: Data URI model yang dienkode base64. Gunakan MIME type application/octet-stream. Contoh: data:application/octet-stream;base64,<data model terenkode base64 Anda>.

Deskripsikan gaya tekstur objek yang diinginkan menggunakan teks. Maksimum 800 karakter.

Berikan gambar 2d untuk memandu proses pemberian tekstur. Saat ini kami mendukung format .jpg, .jpeg, .png, dan .webp.

Ukuran file maksimum: 20 MB.

Ada dua cara untuk menyediakan gambar:

• URL yang dapat diakses publik: URL yang dapat diakses dari internet publik
• Data URI: Data URI gambar yang dienkode base64. Contoh data URI: data:image/jpeg;base64,<data gambar terenkode base64 Anda>

Berikan 1 hingga 4 gambar yang menampilkan objek yang sama dari sudut pandang berbeda untuk memandu pemberian tekstur. Gambar pertama adalah tampilan utama (depan); urutan tampilan lainnya (kiri, belakang, kanan) tidak masalah.

Setiap elemen menerima format yang sama seperti image_style_url (URL yang dapat diakses publik atau data URI base64, .jpg/.jpeg/.png/.webp).

Ukuran file maksimum: 20 MB per gambar.

ID model AI yang digunakan untuk retexture. Nilai yang tersedia: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).

Pertahankan tata letak UV model yang sudah ada alih-alih membuat yang baru.

• Jika Anda melakukan retexture pada model yang dihasilkan oleh Meshy (melalui input_task_id, atau model_url yang mengarah ke output Meshy), atur ini ke true untuk menggunakan kembali tata letak UV yang sudah dioptimalkan.
• Jika Anda melakukan retexture pada model pihak ketiga yang Anda unggah, atur ke true jika model tersebut sudah memiliki UV yang baik dan ingin dipertahankan, atau biarkan false agar Meshy melakukan unwrap UV baru (paling cocok untuk model yang belum memiliki pemetaan UV yang tepat).

Hasilkan peta PBR (metallic, roughness, normal) selain warna dasar. Peta emission juga disertakan ketika ai_model adalah meshy-6, kecuali pada texture_resolution: 8k. meshy-6-lite, meshy-7, dan latest tidak menghasilkan peta emission.

Resolusi tekstur warna dasar. Salah satu dari 2k (2048×2048), 4k (4096×4096), atau 8k (8192×8192). Resolusi yang lebih tinggi menangkap detail permukaan yang lebih banyak.

Gunakan texture_resolution sebagai gantinya — setara dengan texture_resolution: "4k". Ketika keduanya diatur, texture_resolution memiliki prioritas.

Menghilangkan highlight dan bayangan dari tekstur warna dasar, menghasilkan hasil yang lebih bersih yang bekerja lebih baik dengan pengaturan pencahayaan khusus.

Menentukan format file 3D mana yang akan disertakan dalam output. Hanya format yang diminta yang akan dihasilkan dan dikembalikan, yang dapat mengurangi waktu penyelesaian tugas. Jika tidak disertakan, semua format yang didukung akan disertakan.

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

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

Permintaan tidak dapat diterima. Penyebab umum:

• Parameter hilang: Salah satu dari model_url atau input_task_id harus disediakan.
• Gaya hilang: Salah satu dari text_style_prompt, image_style_url, atau multiview_image_urls harus disediakan.
• Input gaya yang bertentangan: multiview_image_urls tidak dapat digabungkan dengan text_style_prompt atau image_style_url.
• Model tidak didukung untuk multi-tampilan: multiview_image_urls memerlukan ai_model: "meshy-7" secara eksplisit.
• Model tidak tersedia: ai_model: "meshy-7" dan ai_model: "meshy-6-lite" sedang digulirkan secara bertahap dan mungkin belum diaktifkan untuk akun Anda.
• 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, image_style_url, atau salah satu elemen multiview_image_urls tidak dapat diunduh.
• File model terlalu besar: File model_url melebihi 400 MB (URL http atau https) atau 100 MB (data: URI).
• Terlalu banyak wajah (faces): File model_url berukuran lebih dari 100 MB dan memiliki lebih dari 10.000.000 wajah. Kurangi jumlah wajah, lalu kirim ulang file tersebut.
• ASCII FBX lebih dari 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 tersebut, lalu kirim ulang.
• Gambar terlalu besar: Gambar image_style_url atau salah satu elemen multiview_image_urls melebihi 20 MB.

Autentikasi gagal. Silakan periksa kunci API Anda.

Kredit tidak cukup untuk menjalankan tugas ini.

Anda telah melampaui batas laju Anda.

Pengenal unik untuk task Retexture yang akan diambil.

ID dari tugas retexture 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 (ascending).
• -created_at: Urutkan berdasarkan waktu pembuatan secara menurun (descending).

Pengenal unik untuk tugas Retexture yang akan di-stream.

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

Tipe dari task Retexture. Nilainya adalah retexture.

URL yang dapat diunduh untuk file model 3D bertekstur yang dihasilkan oleh Meshy.

Ini adalah prompt teks yang digunakan untuk membuat task texturing ini.

Ini adalah input gambar yang digunakan untuk membuat task texturing ini.

URL yang dapat diunduh untuk gambar referensi multi-tampilan yang digunakan untuk membuat task texturing ini. Hanya muncul ketika task dibuat dengan multiview_image_urls.

URL yang dapat diunduh untuk gambar thumbnail dari file model.

URL yang dapat diunduh untuk versi latar belakang transparan (RGBA) dari thumbnail_url. Hanya muncul ketika 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, nilai ini akan menjadi 100.

Stempel waktu kapan task dimulai, dalam milidetik. Jika task belum dimulai, properti ini akan bernilai 0.

Stempel waktu kapan task dibuat, dalam milidetik.

Stempel waktu kapan hasil task kedaluwarsa, dalam milidetik.

Stempel waktu kapan task selesai, dalam milidetik. Jika task belum selesai, properti ini akan bernilai 0.

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

Sebuah array objek URL tekstur yang dihasilkan dari task tersebut. Biasanya ini hanya berisi satu objek URL tekstur. Setiap URL tekstur memiliki properti berikut:

Jumlah task yang mendahului.

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

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