API Teks ke 3D

Langkah dalam aliran kerja dua langkah. Hantar preview untuk mencipta tugas pratonton.

Teks yang menerangkan objek yang hendak dijana, sehingga 800 aksara. Teks yang lebih panjang akan mengembalikan 400.

Jenis jejaring 3D yang hendak dijana.

Nilai yang tersedia:

• standard: jejaring 3D berperincian tinggi
• smart-topology: jejaring Smart Topology. Pilih model dengan ai_model (meshy-t2 atau meshy-t2.5).

Dengan smart-topology, Meshy mengabaikan should_remesh dan decimation_mode, dan hanya menerima topology: triangle.

Model AI yang menjana model 3D tersebut. Nilai yang tersedia bergantung pada model_type.

Model standard (model_type: standard):

• meshy-6-lite
• meshy-6
• meshy-7.1
• latest: Meshy 7.1
• meshy-7 (lapuk): hantar meshy-7.1 sebagai gantinya

Model Smart Topology (model_type: smart-topology):

• meshy-t2: topology yang lebih bersih, bahagian yang terpisah secara semula jadi, output segi tiga, dan bilangan muka yang anda tetapkan dengan target_polycount
• meshy-t2.5 (lalai): perincian yang lebih tajam untuk aset permainan, output segi tiga, dan bilangan muka yang anda tetapkan dengan target_polycount

Laluan penjanaan geometri. Hanya terpakai untuk tugas pratonton. Refine dengan parameter ini mengembalikan 400.

Nilai yang tersedia:

• standard
• 2k: menjalankan laluan Ultra pada 2048³
• 4k: menjalankan laluan Ultra pada 4096³, untuk perincian permukaan yang lebih halus

2k memerlukan meshy-7.1, latest, atau meshy-7 yang lapuk. 4k memerlukan meshy-7.1 atau latest. Model lain mengembalikan 400.

Hantar geometry_resolution sebagai gantinya. ultra_mode: true adalah sama dengan geometry_resolution: "2k".

Sama ada untuk remesh model selepas penjanaan. Untuk model 3D berkualiti tertinggi, hantar false.

Bilangan muka yang disasarkan. Hasilnya boleh berbeza daripada sasaran, bergantung pada geometri. Ia terpakai dalam dua kes berasingan:

• Remesh: dengan should_remesh: true pada model standard. Meshy me-remesh (mendesimasi) jejaring itu kepada kira-kira bilangan ini. Jika anda menetapkan decimation_mode, Meshy menggunakannya dan mengabaikan target_polycount.
• Smart Topology: dengan model_type: smart-topology dan ai_model meshy-t2 atau meshy-t2.5. Meshy menjana model pada bilangan muka ini secara terus. Tiada remesh dijalankan, dan anda tidak perlu should_remesh.

Jadual berikut menunjukkan julat dan nilai lalai untuk setiap kes:

Nilai di luar julat mengembalikan 400.

Biarkan ia dikeluarkan. Parameter ini tidak menjejaskan output.

Nilai yang tersedia:

• off: melumpuhkan simetri
• auto: menggunakan simetri berdasarkan geometri input
• on: menguatkuasakan simetri semasa penjanaan

Pose model yang dijana.

Nilai yang tersedia:

• a-pose: pose A
• t-pose: pose T
• "" (rentetan kosong): tiada pose tertentu

Hantar pose_mode sebagai gantinya. Sama ada untuk menjana model dalam pose A atau pose T.

Biarkan ia dikeluarkan. Meshy mengabaikannya.

Sama ada untuk menyaring prompt bagi kandungan berbahaya sebelum menjana. Jika Meshy mengesan kandungan berbahaya, permintaan mengembalikan 400 dan Meshy tidak mencipta tugas.

Format fail yang hendak dijana. Meshy hanya menjana dan mengembalikan format ini, yang boleh memendekkan tugas tersebut. Jika anda membiarkannya dikeluarkan, Meshy menjana setiap format kecuali 3mf, yang hanya dijana apabila anda memintanya.

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.

Sama ada untuk menganggarkan ketinggian sebenar objek dengan penglihatan AI dan mengubah saiz model mengikutnya. Meshy meletakkan titik asal di bahagian bawah melainkan anda menetapkan origin_at.

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

• Parameter hilang: Parameter yang diperlukan, seperti prompt atau mode, tiada.
• Prompt terlalu panjang: prompt melebihi had aksara.
• Model tidak disokong untuk Ultra: geometry_resolution ialah 2k atau 4k, dengan ai_model yang tidak dapat menjalankannya.

Betulkan permintaan tersebut, kemudian hantar semula. Lihat Ralat.

Kunci API tiada atau tidak sah. Semak header Authorization.

Contohnya:

• Kredit tidak mencukupi: Akaun tidak mempunyai kredit yang cukup 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.

Moderation kandungan menyekat prompt atau imej input. Ubah input tersebut, kemudian cuba semula.

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

Langkah dalam aliran kerja dua langkah. Hantar refine untuk mencipta tugas refine.

ID tugas preview yang hendak ditekstur. Tugas preview tersebut mesti mempunyai status SUCCEEDED.

Sama ada untuk turut menjana peta PBR (metallic, roughness, dan normal) bersama warna asas.

Dengan ai_model meshy-6, Meshy turut menjana peta emission, kecuali pada texture_resolution: 8k. meshy-6-lite, meshy-7, meshy-7.1, dan latest tidak menjana peta emission. Begitu juga refine bagi preview meshy-t2 atau meshy-t2.5 yang tidak menetapkan ai_model. Dengan ai_model: meshy-n1, true memulangkan 400.

Resolusi tekstur warna asas. Hanya terpakai untuk tugas refine. Preview dengan parameter ini memulangkan 400.

Nilai yang tersedia:

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

Resolusi yang lebih tinggi merakam lebih banyak perincian permukaan. 4k dan 8k memerlukan ai_model meshy-6, meshy-7.1, atau latest. Dengan meshy-n1, ia memulangkan 400. Pada 8k, Meshy tidak menjana peta emission.

Hantar texture_resolution sebagai gantinya. hd_texture: true adalah sama seperti texture_resolution: "4k". Jika anda menghantar kedua-duanya, Meshy akan menggunakan texture_resolution.

Teks yang membimbing proses pentekstur, sehingga 800 aksara. Teks yang lebih panjang memulangkan 400. Hantar texture_prompt atau texture_image_url, bukan kedua-duanya. Jika anda menghantar kedua-duanya, Meshy akan menggunakan texture_prompt. Dengan ai_model: meshy-n1, menghantarnya memulangkan 400.

Imej 2D yang membimbing proses pentekstur, sebagai URL awam atau Data URI berkod base64, seperti data:image/jpeg;base64,<your base64-encoded image data>.

Imej mesti merupakan fail .jpg, .jpeg, .png, atau .webp dengan saiz maksimum 20 MB, sekurang-kurangnya 32 piksel pada setiap sisi, dan paling banyak 178,956,970 piksel (lebar × tinggi).

Dengan ai_model: meshy-n1, Meshy mentekstur daripada imej ini sebagai pandangan hadapan.

Model AI yang mentekstur jejaring tersebut.

Nilai yang tersedia:

• meshy-6-lite
• meshy-6
• meshy-7.1
• latest: Meshy 7.1
• meshy-n1: tekstur warna asas 2K hanya daripada imej rujukan. Tiada prompt teks, tiada peta PBR, tiada 4K atau 8K.
• meshy-7 (lapuk): hantar meshy-7.1 sebagai gantinya

Biarkan kosong untuk menggunakan model tugas preview, supaya preview dan refine-nya berjalan pada model yang sama dari hujung ke hujung. Hantar nilai untuk mengatasinya. latest yang dinyatakan secara eksplisit diselesaikan dengan cara yang sama seperti pada tugas preview, jadi preview latest dan refine latest-nya sentiasa menggunakan model tekstur yang sama.

Dengan meshy-n1, Meshy mentekstur daripada texture_image_url. Tanpanya, Meshy menggunakan imej rujukan yang disimpan oleh preview meshy-7.1 atau latest. Preview lain memulangkan 400 melainkan anda menghantar texture_image_url. Preview boleh mempunyai paling banyak 7,999,999 segi tiga. Preview yang telah diremesh kepada quad memulangkan 400.

Sama ada untuk menyaring texture_prompt dan texture_image_url bagi kandungan berbahaya sebelum penjanaan. Jika Meshy mengesan kandungan berbahaya, permintaan memulangkan 400 dan Meshy tidak mencipta tugas.

Sama ada untuk mengalih keluar sorotan dan bayang-bayang daripada tekstur warna asas. Hasil yang lebih bersih berfungsi lebih baik di bawah pencahayaan tersuai.

Hanya berkesan apabila ai_model ialah meshy-6. meshy-7.1 dan latest menerimanya tetapi mengabaikannya, begitu juga refine bagi preview meshy-t2 atau meshy-t2.5 yang tidak menetapkan ai_model. Menghantarnya dengan meshy-6-lite memulangkan 400. Dengan meshy-n1, true memulangkan 400.

Format fail yang hendak dijana. Meshy hanya menjana dan memulangkan format ini, yang boleh memendekkan tugas. Jika anda membiarkannya kosong, Meshy menjana setiap format kecuali 3mf, yang hanya dijana apabila anda memintanya.

Nilai yang tersedia:

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

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

Sama ada untuk menganggarkan ketinggian dunia-sebenar objek menggunakan penglihatan AI dan mengubah saiz model mengikutnya. Meshy meletakkan titik asal di bahagian bawah melainkan anda menetapkan origin_at.

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

• ID tugas tidak sah: preview_task_id tidak sah, atau tidak sepadan dengan mana-mana tugas preview anda.
• Tugas belum sedia: Tugas preview belum berjaya lagi.
• Model tidak sepadan: Model AI tugas preview tidak berfungsi dengan model refine yang diminta.
• Model tidak disokong untuk remove_lighting: remove_lighting dihantar bersama ai_model: "meshy-6-lite".
• Tiada imej rujukan untuk Meshy N1: ai_model: meshy-n1 dihantar tanpa texture_image_url, dan preview tidak mempunyai imej rujukan yang boleh digunakan oleh Meshy N1. Hantar texture_image_url.
• Preview quad untuk Meshy N1: ai_model: meshy-n1 dihantar untuk preview yang diremesh kepada quad. Refine dengan ai_model yang lain.
• Terlalu banyak segi tiga untuk Meshy N1: Dengan ai_model: meshy-n1, preview mempunyai lebih daripada 7,999,999 segi tiga. Refine dengan ai_model yang lain.
• Pilihan tidak disokong untuk Meshy N1: ai_model: meshy-n1 dihantar bersama salah satu pilihan berikut:
  • texture_prompt
  • enable_pbr: true
  • texture_resolution bernilai 4k atau 8k
  • hd_texture: true tanpa texture_resolution
  • remove_lighting: true

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 lagi.
• Pelan percuma: Mencipta tugas memerlukan pelan berbayar. Naik taraf pelan anda dalam tetapan langganan anda, kemudian cuba lagi.

Moderation kandungan menyekat prompt atau imej input. Tukar input, kemudian cuba lagi.

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

ID tugas daripada respons create.

ID tugas yang hendak dipadamkan.

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

Bilangan tugasan setiap halaman, sehingga 100.

Susunan isihan.

Nilai yang tersedia:

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

ID tugasan daripada respons cipta (create).

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

Jenis tugas, text-to-3d-preview untuk tugas preview atau text-to-3d-refine untuk tugas refine.

URL muat turun untuk model 3D yang dijana, satu bagi setiap format fail. Format yang tidak dijana oleh tugas tidak mempunyai kunci, berbanding rentetan kosong.

prompt yang anda hantar untuk mencipta tugas, tidak diubah.

Prompt teks yang anda hantar untuk membimbing pemberian tekstur dalam peringkat refine.

Rujuk geometry_resolution sebagai gantinya.

Tahap Ultra yang digunakan oleh tugas preview, 2k atau 4k. Medan ini tiada untuk standard.

URL muat turun untuk imej yang anda hantar untuk membimbing pemberian tekstur.

URL muat turun untuk imej kecil model 3D.

URL muat turun untuk versi thumbnail_url dengan latar belakang lutsinar (RGBA). Hadir hanya apabila anda mencipta tugas dengan alpha_thumbnail: true dan Meshy menjana preview lutsinar 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 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 peta tekstur yang dijana, sebagai tatasusunan objek. Biasanya ia menyimpan satu objek. Setiap objek mempunyai medan berikut:

Bilangan tugas di hadapan tugas ini dalam baris gilir. Nilai ini hanya bermakna semasa tugas berstatus PENDING.

Butiran ralat apabila tugas gagal. Ia null melainkan statusnya FAILED. Lihat Ralat.

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