Retexture API

Wajib kecuali Anda mengirim model_url. ID dari tugas yang menghasilkan model 3D untuk diberi tekstur, misalnya tugas Teks ke 3D, Gambar ke 3D, Remesh, atau Retexture. Tugas tersebut harus yang Anda buat dengan API dan memiliki status SUCCEEDED. Meshy memberi tekstur pada GLB dari tugas tersebut.

Dengan meshy-n1, model dari tugas tersebut dapat memiliki paling banyak 7.999.999 wajah (faces), dihitung sebagai segitiga (quad dihitung sebagai 2).

Wajib kecuali Anda mengirim input_task_id. Model yang akan diberi tekstur, 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 berukuran paling banyak 400 MB dari URL http atau https, atau 100 MB sebagai data URI. Untuk data URI, gunakan MIME type application/octet-stream, misalnya data:application/octet-stream;base64,<data model Anda yang dienkode base64>.

File yang lebih dari 100 MB juga harus mengikuti aturan ini:

• File GLB, glTF, FBX, atau OBJ dapat memiliki paling banyak 10.000.000 wajah. Meshy menghitung wajah sebagai segitiga, jadi quad dihitung sebagai 2, dan mesh yang digambar lebih dari sekali dihitung sekali per salinan.
• File FBX harus berupa binary FBX 7.1 atau yang lebih baru.
• File GLB atau glTF tidak boleh menggunakan kompresi Draco.

Dengan meshy-n1, model dapat memiliki paling banyak 7.999.999 wajah, dihitung sebagai segitiga (quad dihitung sebagai 2), berapa pun ukuran filenya.

Wajib kecuali Anda mengirim image_style_url atau multiview_image_urls. Teks yang mendeskripsikan tekstur yang Anda inginkan, hingga 800 karakter. Teks yang lebih panjang mengembalikan 400. Dengan meshy-n1, mengirimnya tanpa image_style_url mengembalikan 400.

Wajib kecuali Anda mengirim text_style_prompt atau multiview_image_urls. Gambar 2D yang gayanya diikuti oleh tekstur, berupa URL publik atau data URI (data:image/jpeg;base64,<data gambar Anda yang dienkode base64>). Jika Anda mengirim text_style_prompt dan image_style_url sekaligus, Meshy menggunakan image_style_url.

Gambar harus berupa file .jpg, .jpeg, .png, atau .webp berukuran paling banyak 20 MB, dan setidaknya 32 piksel pada setiap sisinya.

Tekstur mungkin tidak pas jika objek pada gambar memiliki bentuk yang sangat berbeda dari model. Dengan meshy-n1, Meshy memperlakukan gambar sebagai tampilan depan.

Wajib kecuali Anda mengirim text_style_prompt atau image_style_url. Satu hingga empat gambar dari objek yang sama dari sudut pandang berbeda. Gambar pertama adalah tampilan utama (depan). Urutan tampilan lainnya (kiri, belakang, kanan) tidak penting. Array kosong, atau lebih dari empat gambar, mengembalikan 400.

Setiap gambar mengikuti aturan format dan ukuran yang sama dengan image_style_url, paling banyak 20 MB per gambar. Anda tidak dapat menggabungkan multiview_image_urls dengan text_style_prompt atau image_style_url.

multiview_image_urls memerlukan ai_model eksplisit berupa meshy-7 atau meshy-n1. ai_model lainnya, termasuk latest yang merupakan bawaan, mengembalikan 400.

Model AI yang menghasilkan tekstur.

Nilai yang tersedia:

• meshy-6-lite
• meshy-6
• meshy-7
• meshy-n1: tekstur warna dasar 2K hanya dari gambar referensi. Tanpa prompt teks, tanpa peta PBR, tanpa 4K atau 8K. Hingga 7.999.999 wajah.
• latest: Meshy 7

Apakah mempertahankan tata letak UV model alih-alih menghasilkan yang baru.

• Untuk model yang dihasilkan Meshy, dari input_task_id atau model_url yang menunjuk ke output Meshy, gunakan true untuk menggunakan kembali tata letak UV yang sudah dioptimalkan.
• Untuk model yang Anda unggah dari tempat lain, gunakan true untuk mempertahankan UV yang sudah bagus. Biarkan false agar Meshy menghasilkan UV baru, yang cocok untuk model tanpa pemetaan UV yang tepat.

Apakah juga menghasilkan peta PBR (metallic, roughness, dan normal) bersama warna dasar. Dengan meshy-6, Meshy juga menghasilkan peta emisi, kecuali pada texture_resolution 8k. meshy-6-lite, meshy-7, dan latest tidak menghasilkan peta emisi. Dengan meshy-n1, true mengembalikan 400.

Ukuran tekstur warna dasar. Resolusi yang lebih tinggi menangkap lebih banyak detail permukaan.

Nilai yang tersedia:

• 2k: 2048 × 2048 piksel
• 4k: 4096 × 4096 piksel
• 8k: 8192 × 8192 piksel

4k dan 8k memerlukan ai_model berupa meshy-6, meshy-7, atau latest. Dengan meshy-6-lite atau meshy-n1, keduanya mengembalikan 400. Pada 8k, Meshy tidak menghasilkan peta emisi.

Gunakan texture_resolution sebagai gantinya. true sama dengan texture_resolution: "4k". Jika Anda mengirim keduanya, Meshy menggunakan texture_resolution.

Apakah menghapus sorotan dan bayangan dari tekstur warna dasar. Hasilnya bekerja lebih baik di bawah pencahayaan Anda sendiri.

Meshy menerapkannya hanya dengan meshy-6, pada texture_resolution 2k atau 4k. Dengan meshy-7 atau latest, atau pada 8k, Meshy menerima parameter ini dan mengabaikannya. Dengan meshy-6-lite atau meshy-n1, mengirimnya dengan nilai apa pun mengembalikan 400.

Format file yang akan dihasilkan. Meshy hanya menghasilkan format yang Anda cantumkan, yang dapat mempersingkat tugas. Jika Anda tidak menyertakannya, Meshy menghasilkan setiap format kecuali 3mf.

Nilai yang tersedia:

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

Apakah juga 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 menyebutkan masalah apa yang ditemukan. Misalnya:

• Parameter hilang: Baik model_url maupun input_task_id tidak dikirim.
• Gaya hilang: Tidak ada satu pun dari text_style_prompt, image_style_url, dan multiview_image_urls yang dikirim.
• Input gaya saling bertentangan: multiview_image_urls dikirim bersama text_style_prompt atau image_style_url.
• Model tidak didukung untuk multi-tampilan: multiview_image_urls dikirim tanpa ai_model eksplisit berupa meshy-7 atau meshy-n1.
• Opsi tidak didukung untuk Meshy N1: meshy-n1 dikirim dengan enable_pbr: true, remove_lighting, texture_resolution 4k atau 8k, hd_texture: true tanpa texture_resolution, atau text_style_prompt tanpa image_style_url.
• Terlalu banyak segitiga untuk Meshy N1: Dengan meshy-n1, model 3D memiliki lebih dari 7.999.999 segitiga. Kurangi jumlah segitiga, atau gunakan ai_model lain.
• Model terlalu kompleks untuk Meshy N1: Dengan meshy-n1, file model_url terlalu kompleks bagi Meshy untuk menghitung segitiganya. Kurangi jumlah segitiga, lalu kirim file lagi.
• Penghitungan segitiga melewati batas waktu: Dengan meshy-n1, penghitungan segitiga dari file model_url memakan waktu terlalu lama. Coba lagi, atau kurangi ukuran model.
• Tugas input tidak valid: input_task_id bukan tugas berhasil dengan tipe yang didukung.
• Format model tidak valid: File model_url memiliki ekstensi yang tidak didukung.
• URL tidak dapat dijangkau: Meshy tidak dapat mengunduh file model_url, gambar image_style_url, atau gambar multiview_image_urls.
• File model terlalu besar: File model_url lebih dari 400 MB dari URL http atau https, atau lebih dari 100 MB sebagai data URI.
• Terlalu banyak wajah: File model_url lebih dari 100 MB dan memiliki lebih dari 10.000.000 wajah. Kurangi jumlah wajah, lalu kirim file lagi.
• ASCII FBX di atas 100 MB: File model_url adalah ASCII FBX di atas 100 MB. Kirim sebagai binary FBX atau GLB.
• File model tidak dapat dibaca: File model_url lebih dari 100 MB, dan Meshy tidak dapat membaca headernya. Misalnya, file tersebut adalah GLB atau glTF yang dikompresi Draco, atau binary FBX yang lebih lama dari 7.1.
• Header model terlalu kompleks: File model_url lebih dari 100 MB, dan headernya memiliki terlalu banyak mesh, node, atau record untuk diperiksa. Kurangi jumlah objek dalam file, lalu kirim lagi.
• Gambar terlalu besar: Gambar image_style_url atau gambar multiview_image_urls lebih dari 20 MB.

Dengan meshy-n1, model yang tidak dapat diperiksa Meshy sebelum tugas dimulai, seperti file STL, tidak ditolak di sini. Jika memiliki lebih dari 7.999.999 segitiga, tugas akan gagal, dan Meshy mengembalikan kreditnya.

Perbaiki permintaan, lalu kirim lagi. Lihat Kesalahan.

Kunci API hilang atau tidak valid. Periksa header Authorization.

Misalnya:

• Kredit tidak cukup: Akun tidak memiliki kredit yang cukup untuk tugas ini, atau akun telah 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.

Salah satu dari berikut ini berlaku:

• Moderation konten memblokir prompt atau gambar input. Ubah input, lalu coba lagi.
• input_task_id adalah model bas-relief, yang tidak dapat diberi tekstur ulang 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 mana pun. Periksa ID tugas, lalu kirim permintaan lagi.

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

ID task dari respons pembuatan (create).

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: yang terlama lebih dulu
• -created_at: yang terbaru lebih dulu

ID tugas dari respons pembuatan.

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

Jenis task, selalu retexture.

URL unduhan untuk model 3D yang sudah diberi tekstur, satu per format file.

Prompt teks yang Anda gunakan untuk membuat task.

Gambar gaya yang Anda gunakan untuk membuat task.

URL unduhan untuk gambar referensi multi-tampilan yang Anda gunakan untuk membuat task. Hanya ada ketika Anda membuat task dengan multiview_image_urls.

URL unduhan untuk gambar thumbnail model.

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

Seberapa banyak task telah selesai, dalam persentase. Nilainya 0 sampai task dimulai dan 100 ketika berhasil.

Waktu task dimulai, dalam milidetik Unix. Nilainya 0 sampai task dimulai.

Waktu task dibuat, dalam milidetik Unix.

Waktu hasil task kedaluwarsa, dalam milidetik Unix.

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

Status task, salah satu dari PENDING, IN_PROGRESS, SUCCEEDED, FAILED, atau CANCELED.

URL unduhan untuk tekstur yang dihasilkan, berupa array objek. Array ini biasanya berisi satu objek. Setiap objek memiliki kolom berikut:

Jumlah task yang berada di depan task ini dalam antrean. Hanya ada selama task berstatus PENDING; kolom ini tidak disertakan ketika nilainya 0.

Detail kesalahan ketika task gagal. Lihat Kesalahan.

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