API Remesh

Diperlukan melainkan anda menghantar model_url. ID tugas yang modelnya ingin anda remesh, contohnya tugas Teks ke 3D, Imej ke 3D, Retekstur, atau Remesh. Tugas tersebut mestilah yang anda cipta dengan API dan mempunyai status SUCCEEDED.

Diperlukan melainkan anda menghantar input_task_id. Model untuk di-remesh, 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.

Fail yang melebihi 100 MB juga mesti mematuhi peraturan berikut:

• Fail GLB, glTF, FBX, atau OBJ boleh mempunyai maksimum 10,000,000 muka. Meshy mengira muka 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 mampatan Draco.

Format fail untuk dijana.

Nilai yang tersedia:

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

Jenis muka bagi model yang di-remesh.

Nilai yang tersedia:

• quad: jejaring dominan segi empat
• triangle: jejaring segi tiga yang didesimasi

Bilangan muka yang disasarkan, dari 100 hingga 300000. Hasilnya boleh berbeza daripada sasaran, bergantung pada geometri model. Nilai di luar julat ini memulangkan 400.

Bilangan muka adaptif, mengikut tahap. Apabila anda menetapkannya, Meshy mengabaikan target_polycount.

Nilai yang tersedia:

• 1: ultra
• 2: tinggi
• 3: sederhana
• 4: rendah

Gunakan Resize API sebagai gantinya. Ketinggian untuk mengubah saiz model, dalam meter. Hantar sekurang-kurangnya satu daripada resize_height, resize_longest_side, dan auto_size.

Gunakan Resize API sebagai gantinya. Panjang untuk mengubah saiz sisi terpanjang kotak pembatas model, dalam meter. Hantar sekurang-kurangnya satu daripada resize_height, resize_longest_side, dan auto_size.

Gunakan Resize API sebagai gantinya. Sama ada untuk menganggarkan ketinggian sebenar objek dengan penglihatan AI dan mengubah saiz model mengikutnya. Hantar sekurang-kurangnya satu daripada resize_height, resize_longest_side, dan auto_size.

Gunakan Resize API sebagai gantinya. Lokasi untuk meletakkan titik asal model, bottom atau center. Nilai lalai digunakan apabila anda menghantar resize_height, resize_longest_side, atau auto_size. Tanpa salah satu daripadanya, Meshy hanya memindahkan titik asal jika anda menghantar origin_at.

Gunakan Convert API sebagai gantinya. Sama ada hanya untuk menukar model kepada target_formats. Apabila true, Meshy mengabaikan topology, target_polycount, decimation_mode, resize_height, resize_longest_side, dan auto_size, tetapi masih menyemak nilainya, jadi nilai yang tidak sah akan memulangkan 400. Dengan convert_format_only: true, target_formats yang kosong atau null akan memulangkan 400.

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

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

• Parameter hilang: Baik model_url mahupun input_task_id tidak dihantar.
• Tugas input tidak sah: input_task_id bukan tugas API yang berjaya, atau model AI-nya tidak menyokong remesh.
• Format model tidak sah: Fail model_url mempunyai sambungan yang tidak disokong.
• URL tidak boleh dicapai: Meshy tidak dapat memuat turun fail model_url.
• Fail model terlalu besar: Fail model_url melebihi 400 MB daripada URL http atau https, atau melebihi 100 MB sebagai data URI.
• Terlalu banyak muka: Fail model_url melebihi 100 MB dan mempunyai lebih daripada 10,000,000 muka. Kurangkan bilangan muka, kemudian hantar fail itu semula.
• FBX ASCII melebihi 100 MB: Fail model_url ialah FBX ASCII yang 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 headernya. Contohnya, ia adalah GLB atau glTF yang dimampatkan Draco, atau FBX binari yang lebih lama daripada 7.1.
• Header model terlalu kompleks: Fail model_url melebihi 100 MB, dan headernya mempunyai terlalu banyak jejaring, nod, atau rekod untuk disemak. Kurangkan bilangan objek dalam fail, kemudian hantar semula.
• Topologi tidak sah: topology bukan quad atau triangle.
• Parameter saling eksklusif: Permintaan mempunyai lebih daripada satu daripada auto_size, resize_height, dan resize_longest_side. Hantar hanya satu.

Betulkan permintaan, kemudian hantar semula. Lihat Ralat.

kunci API tiada 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 dalam tetapan langganan anda, kemudian cuba semula.

input_task_id ialah model bas-relief, yang tidak dapat di-remesh oleh endpoint ini. Mesejnya ialah This model type does not support this operation. Hantar model yang berbeza.

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

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

ID tugas daripada respons create.

ID tugas yang hendak dipadam.

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

Bilangan tugas setiap halaman, sehingga 100.

Susunan isihan.

Nilai yang tersedia:

• +created_at: yang paling lama dahulu
• -created_at: yang paling baru dahulu

ID tugas daripada respons create.

ID tugasan. Anggap ini sebagai rentetan legap, dan jangan bergantung pada formatnya.

Jenis tugasan, sentiasa remesh.

URL muat turun untuk model yang telah di-remesh, satu bagi setiap format fail. Format yang tidak dihasilkan oleh tugasan tidak mempunyai kunci, bukannya rentetan kosong.

URL muat turun untuk imej pratonton bagi model yang telah di-remesh.

URL muat turun untuk versi thumbnail_url dengan latar belakang lutsinar (RGBA). Hadir hanya apabila anda mencipta tugasan dengan alpha_thumbnail: true dan Meshy berjaya merender pratonton lutsinar tersebut.

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

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

Bilangan tugasan yang mendahului tugasan ini dalam baris gilir. Nilai ini hanya bermakna semasa tugasan berstatus PENDING.

Masa tugasan dicipta, dalam milisaat Unix.

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

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

Masa URL muat turun tugasan tamat tempoh, dalam milisaat Unix. Nilainya 0 sehingga tugasan selesai.

URL muat turun untuk peta tekstur model, apabila tugasan berjaya: satu tatasusunan objek, satu bagi setiap set tekstur. Setiap objek mempunyai URL base_color, dan juga boleh mempunyai URL metallic, roughness, normal, emission, dan metallic_roughness. Nilainya null sehingga tugasan berjaya, dan tatasusunan kosong apabila model tidak mempunyai peta tekstur.

Butiran ralat apabila tugasan gagal. Lihat Ralat.

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