Retexture API

Diperlukan kecuali anda menghantar model_url. ID tugas yang menghasilkan model 3D untuk ditekstur, contohnya tugas Teks ke 3D, Imej ke 3D, Remesh, atau Retekstur. Tugas tersebut mestilah yang anda cipta dengan API dan mempunyai status SUCCEEDED. Meshy akan mentekstur GLB tugas tersebut.

Dengan meshy-n1, model tugas boleh mempunyai sehingga 7,999,999 permukaan, dikira sebagai segi tiga (segi empat dikira sebagai 2).

Diperlukan kecuali anda menghantar input_task_id. Model untuk ditekstur, sebagai URL awam atau Data URI. Jika anda menghantar kedua-duanya, Meshy menggunakan input_task_id.

Model mestilah fail GLB, glTF, OBJ, FBX, atau STL bersaiz maksimum 400 MB daripada URL http atau https, atau 100 MB sebagai Data URI. Untuk Data URI, gunakan MIME type application/octet-stream, contohnya data:application/octet-stream;base64,<data model terenkod base64 anda>.

Fail melebihi 100 MB juga mesti mematuhi peraturan berikut:

• Fail GLB, glTF, FBX, atau OBJ boleh mempunyai sehingga 10,000,000 permukaan. Meshy mengira permukaan sebagai segi tiga, jadi segi empat dikira sebagai 2, dan jejaring yang dilukis lebih daripada sekali dikira sekali bagi setiap salinan.
• Fail FBX mestilah FBX binari 7.1 atau lebih baharu.
• Fail GLB atau glTF tidak boleh menggunakan pemampatan Draco.

Dengan meshy-n1, model boleh mempunyai sehingga 7,999,999 permukaan, dikira sebagai segi tiga (segi empat dikira sebagai 2), tanpa mengira saiz failnya.

Diperlukan kecuali anda menghantar image_style_url atau multiview_image_urls. Teks yang menerangkan tekstur yang anda mahukan, sehingga 800 aksara. Teks yang lebih panjang mengembalikan 400. Dengan meshy-n1, menghantarnya tanpa image_style_url mengembalikan 400.

Diperlukan kecuali anda menghantar text_style_prompt atau multiview_image_urls. Imej 2D yang gayanya diikuti oleh tekstur, sebagai URL awam atau Data URI (data:image/jpeg;base64,<data imej terenkod base64 anda>). Jika anda menghantar kedua-dua text_style_prompt dan image_style_url, Meshy menggunakan image_style_url.

Imej mestilah fail .jpg, .jpeg, .png, atau .webp bersaiz maksimum 20 MB, dan sekurang-kurangnya 32 piksel pada setiap sisi.

Tekstur mungkin tidak sesuai dengan baik apabila objek dalam imej mempunyai bentuk yang sangat berbeza daripada model. Dengan meshy-n1, Meshy menganggap imej sebagai pandangan hadapan.

Diperlukan kecuali anda menghantar text_style_prompt atau image_style_url. Satu hingga empat imej objek yang sama daripada pandangan berbeza. Imej pertama ialah pandangan utama (hadapan). Susunan pandangan lain (kiri, belakang, kanan) tidak penting. Tatasusunan kosong, atau lebih daripada empat imej, mengembalikan 400.

Setiap imej mengikut peraturan format dan saiz yang sama seperti image_style_url, maksimum 20 MB bagi setiap imej. Anda tidak boleh menggabungkan multiview_image_urls dengan text_style_prompt atau image_style_url.

multiview_image_urls memerlukan ai_model yang dinyatakan secara eksplisit iaitu meshy-7 atau meshy-n1. ai_model lain, termasuk lalai latest, mengembalikan 400.

Model AI yang menjana tekstur.

Nilai yang tersedia:

• meshy-6-lite
• meshy-6
• meshy-7
• meshy-n1: tekstur warna asas 2K hanya daripada imej rujukan. Tiada prompt teks, tiada peta PBR, tiada 4K atau 8K. Sehingga 7,999,999 permukaan.
• latest: Meshy 7

Sama ada untuk mengekalkan susun atur UV model berbanding menjana yang baharu.

• Untuk model yang dijana oleh Meshy, daripada input_task_id atau model_url yang merujuk kepada output Meshy, gunakan true untuk menggunakan semula susun atur UV yang telah dioptimumkan.
• Untuk model yang anda muat naik dari tempat lain, gunakan true untuk mengekalkan UV yang sudah baik. Biarkan false untuk membolehkan Meshy menjana UV baharu, yang sesuai untuk model tanpa pemetaan UV yang betul.

Sama ada untuk turut menjana peta PBR (metallic, roughness, dan normal) bersama warna asas. Dengan meshy-6, Meshy turut menjana peta emisi, kecuali pada texture_resolution bernilai 8k. meshy-6-lite, meshy-7, dan latest tidak menjana peta emisi. Dengan meshy-n1, true mengembalikan 400.

Saiz tekstur warna asas. Resolusi yang lebih tinggi menangkap lebih banyak perincian permukaan.

Nilai yang tersedia:

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

4k dan 8k memerlukan ai_model iaitu meshy-6, meshy-7, atau latest. Dengan meshy-6-lite atau meshy-n1, kedua-duanya mengembalikan 400. Pada 8k, Meshy tidak menjana peta emisi.

Gunakan texture_resolution sebagai ganti. true adalah sama seperti texture_resolution: "4k". Jika anda menghantar kedua-duanya, Meshy menggunakan texture_resolution.

Sama ada untuk membuang sorotan dan bayang daripada tekstur warna asas. Hasilnya berfungsi lebih baik di bawah pencahayaan anda sendiri.

Meshy menggunakannya hanya dengan meshy-6, pada texture_resolution bernilai 2k atau 4k. Dengan meshy-7 atau latest, atau pada 8k, Meshy menerima dan mengabaikannya. Dengan meshy-6-lite atau meshy-n1, menghantarnya dengan sebarang nilai mengembalikan 400.

Format fail untuk dijana. Meshy hanya menjana format yang anda senaraikan, yang boleh memendekkan tugas tersebut. Jika anda tidak menyertakannya, Meshy menjana setiap format kecuali 3mf.

Nilai yang tersedia:

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

Sama ada untuk turut merender pratonton dengan latar belakang lutsinar (RGBA), dikembalikan dalam alpha_thumbnail_url apabila anda mendapatkan tugas tersebut. thumbnail_url tidak berubah.

Permintaan tidak dapat dijalankan. Mesej ralat menyatakan masalah yang ditemui. Contohnya:

• Parameter hilang: Tiada model_url mahupun input_task_id dihantar.
• Gaya hilang: Tiada satu pun daripada text_style_prompt, image_style_url, dan multiview_image_urls dihantar.
• Input gaya bercanggah: multiview_image_urls dihantar bersama text_style_prompt atau image_style_url.
• Model tidak disokong untuk berbilang pandangan: multiview_image_urls dihantar tanpa ai_model eksplisit iaitu meshy-7 atau meshy-n1.
• Pilihan tidak disokong untuk Meshy N1: meshy-n1 dihantar bersama enable_pbr: true, remove_lighting, texture_resolution bernilai 4k atau 8k, hd_texture: true tanpa texture_resolution, atau text_style_prompt tanpa image_style_url.
• Terlalu banyak segi tiga untuk Meshy N1: Dengan meshy-n1, model 3D mempunyai lebih daripada 7,999,999 segi tiga. Kurangkan bilangan segi tiga, atau gunakan ai_model lain.
• Model terlalu kompleks untuk Meshy N1: Dengan meshy-n1, fail model_url terlalu kompleks untuk Meshy mengira segi tiganya. Kurangkan bilangan segi tiga, kemudian hantar semula fail tersebut.
• Pengiraan segi tiga tamat masa: Dengan meshy-n1, pengiraan segi tiga fail model_url mengambil masa terlalu lama. Cuba semula, atau kurangkan saiz model.
• Tugas input tidak sah: input_task_id bukan tugas berjaya daripada jenis yang disokong.
• Format model tidak sah: Fail model_url mempunyai sambungan yang tidak disokong.
• URL tidak boleh dicapai: Meshy tidak dapat memuat turun fail model_url, imej image_style_url, atau imej multiview_image_urls.
• Fail model terlalu besar: Fail model_url melebihi 400 MB daripada URL http atau https, atau melebihi 100 MB sebagai Data URI.
• Terlalu banyak permukaan: Fail model_url melebihi 100 MB dan mempunyai lebih daripada 10,000,000 permukaan. Kurangkan bilangan permukaan, kemudian hantar semula fail tersebut.
• FBX ASCII melebihi 100 MB: Fail model_url ialah FBX ASCII melebihi 100 MB. Hantar sebagai FBX binari atau GLB.
• Fail model tidak boleh dibaca: Fail model_url melebihi 100 MB, dan Meshy tidak dapat membaca pengepalanya. Contohnya, ia ialah GLB atau glTF termampat Draco, atau FBX binari yang lebih lama daripada 7.1.
• Pengepala model terlalu kompleks: Fail model_url melebihi 100 MB, dan pengepalanya mempunyai terlalu banyak jejaring, nod, atau rekod untuk diperiksa. Kurangkan bilangan objek dalam fail tersebut, kemudian hantar semula.
• Imej terlalu besar: Imej image_style_url atau imej multiview_image_urls melebihi 20 MB.

Dengan meshy-n1, model yang tidak dapat diperiksa oleh Meshy sebelum tugas bermula, seperti fail STL, tidak ditolak di sini. Jika ia mempunyai lebih daripada 7,999,999 segi tiga, tugas gagal, dan Meshy memulangkan semula kredit yang digunakan.

Betulkan permintaan, kemudian hantar semula. Lihat Ralat.

Kunci API hilang atau tidak sah. Semak header Authorization.

Contohnya:

• Kredit tidak mencukupi: Akaun tidak mempunyai kredit yang mencukupi untuk tugas ini, atau akaun telah mencapai had kredit. Semak baki kredit anda, kemudian cuba semula.
• Pelan percuma: Mencipta tugas memerlukan pelan berbayar. Naik taraf pelan anda di tetapan langganan anda, kemudian cuba semula.

Salah satu daripada perkara berikut berlaku:

• Moderation kandungan menyekat prompt atau imej input. Tukar input, kemudian cuba semula.
• input_task_id ialah model relief rendah (bas-relief), yang tidak dapat diretekstur oleh endpoint ini. Mesejnya ialah This model type does not support this operation. Hantar model yang lain.

input_task_id tidak sepadan dengan mana-mana tugas anda. Semak ID tugas, kemudian hantar semula permintaan.

Anda telah melebihi had kadar anda. Tunggu, kemudian cuba semula. Lihat Had kadar.

ID tugas daripada respons create.

ID tugasan yang hendak dipadam.

Nombor halaman yang hendak dikembalikan, sehingga 255. Nilai yang lebih besar akan mengembalikan 400.

Bilangan tugas setiap halaman, sehingga 100.

Susunan pengisihan.

Nilai yang tersedia:

• +created_at: paling lama dahulu
• -created_at: paling baharu dahulu

ID tugas daripada respons create.

ID tugas. Anggap ia sebagai rentetan legap, dan jangan bergantung pada formatnya.

Jenis tugas, sentiasa retexture.

URL muat turun untuk model 3D bertekstur, satu bagi setiap format fail.

Prompt teks yang anda gunakan untuk mencipta tugas.

Imej gaya yang anda gunakan untuk mencipta tugas.

URL muat turun untuk imej rujukan berbilang pandangan yang anda gunakan untuk mencipta tugas. Hanya hadir apabila anda mencipta tugas dengan multiview_image_urls.

URL muat turun untuk imej kecil model.

URL muat turun untuk versi thumbnail_url dengan latar belakang telus (RGBA). Hanya hadir apabila anda mencipta tugas dengan alpha_thumbnail: true dan Meshy merender pratonton telus tersebut.

Berapa banyak tugas telah selesai, dalam peratusan. Nilainya 0 sehingga tugas bermula dan 100 apabila ia berjaya.

Masa tugas bermula, dalam milisaat Unix. Nilainya 0 sehingga tugas bermula.

Masa tugas dicipta, dalam milisaat Unix.

Masa hasil tugas tamat tempoh, dalam milisaat Unix.

Masa tugas selesai, dalam milisaat Unix. Nilainya 0 sehingga tugas selesai.

Status tugas, salah satu daripada PENDING, IN_PROGRESS, SUCCEEDED, FAILED, atau CANCELED.

URL muat turun untuk tekstur yang dijana, sebagai tatasusunan objek. Tatasusunan ini biasanya menyimpan satu objek. Setiap objek mempunyai medan berikut:

Bilangan tugas yang mendahului tugas ini dalam baris gilir. Hanya hadir semasa tugas berstatus PENDING; medan ini ditinggalkan apabila nilainya 0.

Butiran ralat apabila tugas gagal. Lihat Ralat.

Bilangan kredit yang digunakan oleh tugas. Hadir apabila status adalah PENDING, IN_PROGRESS, atau SUCCEEDED. Nilainya 0 untuk tugas FAILED, kerana Meshy memulangkan semula kredit apabila tugas gagal.