API Teks ke 3D

Bidang ini harus diatur ke "preview" saat membuat tugas preview.

Jelaskan objek seperti apa yang akan dihasilkan model 3D-nya. Maksimum 800 karakter.

Tentukan jenis pembuatan mesh 3D.

Nilai yang tersedia:

• standard: Pembuatan mesh 3D detail tinggi secara reguler.
• smart-topology: Pilih model Smart Topology dengan ai_model (meshy-t2 atau meshy-t2.5).
• lowpoly (usang, akan dihentikan pada 30 Oktober 2026): Menghasilkan mesh low-poly yang dioptimalkan untuk poligon yang lebih bersih. Kami merekomendasikan Meshy T2.5 sebagai gantinya: smart-topology dengan meshy-t2.5.

ID model yang akan digunakan. Nilai yang tersedia bergantung pada model_type.

Pembuatan standar (model_type: standard):

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (usang): gunakan meshy-7.1 sebagai gantinya.

Pembuatan Smart Topology (model_type: smart-topology):

• meshy-t2: model Smart Topology — topology yang lebih bersih, bagian yang terpisah secara native, output triangle, dan jumlah face yang dapat Anda atur dengan target_polycount.
• meshy-t2.5 (default): Detail yang lebih tajam untuk asset game. Output triangle, dan jumlah face yang dapat Anda atur dengan target_polycount.

Pass pembuatan geometri. 2k menjalankan pass Ultra pada 2048³; 4k menjalankannya pada 4096³ untuk detail permukaan yang paling halus.

Nilai yang tersedia: standard, 2k, 4k

Gunakan geometry_resolution sebagai gantinya. ultra_mode: true setara dengan geometry_resolution: "2k".

Mengontrol apakah akan mengaktifkan fase remesh. Untuk model berkualitas tertinggi, kami merekomendasikan mengatur should_remesh ke false.

Jumlah target poligon (face) pada output. Jumlah sebenarnya dapat menyimpang dari target tergantung pada geometri.

target_polycount berlaku dalam dua kasus independen:

• Remesh — dengan should_remesh: true pada model standard. Mesh di-remesh (decimated) hingga mendekati jumlah ini. Rentang 100 hingga 300.000, default 30.000. Jika decimation_mode diatur, maka akan diprioritaskan dan target_polycount diabaikan.
• Smart Topology — dengan model_type: smart-topology dan ai_model meshy-t2 atau meshy-t2.5. Model dihasilkan langsung dengan jumlah face ini; tidak ada remesh yang dijalankan dan should_remesh tidak diperlukan. Untuk meshy-t2: rentang 100 hingga 15.000, default 4.000. Untuk meshy-t2.5: rentang 100 hingga 30.000, default 15.000.

Usang. Parameter ini tidak lagi memengaruhi output.

Bidang symmetry_mode mengontrol perilaku simetri selama proses pembuatan model.

Nilai yang valid adalah:

• off: Menonaktifkan simetri.
• auto: Secara otomatis menentukan dan menerapkan simetri berdasarkan geometri input.
• on: Menerapkan simetri secara paksa selama pembuatan.

Tentukan pose_mode untuk model yang dihasilkan.

Nilai yang tersedia:

• a-pose: Hasilkan model dalam pose A.
• t-pose: Hasilkan model dalam pose T.
• "" (string kosong): Tidak ada pose spesifik yang diterapkan.

Gunakan pose_mode sebagai gantinya. Apakah akan menghasilkan model dalam pose A/T.

Tidak didukung oleh Meshy-6. Permintaan menggunakan Meshy-6 akan mengabaikan art_style, dan beberapa kombinasi dapat menyebabkan error. Nilai yang tersedia: realistic, sculpture.

Saat diatur ke true, konten input akan secara otomatis disaring untuk konten yang berpotensi berbahaya. Jika konten berbahaya terdeteksi, tugas tidak akan dilanjutkan ke tahap pembuatan.

Teks dari prompt akan disaring.

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 diisi, semua format yang didukung akan disertakan.

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

Saat diatur ke true, tugas akan tambahan merender versi preview dengan latar belakang transparan (RGBA) dan mengembalikannya sebagai alpha_thumbnail_url pada respons GET. Bidang thumbnail_url yang sudah ada tidak berubah.

Saat diatur ke true, layanan menggunakan AI vision untuk secara otomatis memperkirakan tinggi objek di dunia nyata dan mengubah ukuran model sesuai dengan itu. Titik asal akan default ke bottom kecuali origin_at diatur secara eksplisit.

Permintaan tidak dapat diterima. Penyebab umum:

• Parameter hilang: Parameter yang diperlukan (misalnya, prompt, mode) tidak ada.
• Parameter tidak valid: art_style bukan salah satu nilai yang diizinkan.
• Prompt terlalu panjang: prompt melebihi batas karakter.
• Model tidak didukung untuk low poly: ai_model: "meshy-6-lite" tidak mendukung model_type: "lowpoly".
• Model tidak didukung untuk Ultra: geometry_resolution memerlukan meshy-7.1 atau latest.

Autentikasi gagal. Silakan periksa kunci API Anda.

Kredit tidak cukup untuk melakukan tugas ini.

Anda telah melebihi batas laju Anda.

Bidang ini harus diatur ke "refine" saat membuat refine task.

ID preview task yang sesuai.

Status dari preview task yang diberikan harus SUCCEEDED.

Menghasilkan peta PBR (metallic, roughness, normal) selain base color. Peta emission juga disertakan saat ai_model adalah meshy-6, kecuali pada texture_resolution: 8k (tidak ada peta emission yang dihasilkan). meshy-6-lite, meshy-7.1, dan latest tidak menghasilkan peta emission, begitu juga refine dari preview meshy-t2 yang tidak mengatur ai_model.

Resolusi tekstur base color. Salah satu dari 2k (2048×2048), 4k (4096×4096), atau 8k (8192×8192). Resolusi yang lebih tinggi menangkap lebih banyak detail permukaan. Hanya berlaku untuk mode refine.

Gunakan texture_resolution sebagai gantinya — setara dengan texture_resolution: "4k". Jika keduanya diatur, texture_resolution akan diutamakan.

Berikan prompt teks tambahan untuk memandu proses texturing. Maksimal 800 karakter.

Berikan gambar 2d untuk memandu proses texturing. Kami saat ini 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,<your base64-encoded image data>

ID model yang digunakan untuk refining.

Nilai yang tersedia:

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (usang): gunakan meshy-7.1 sebagai gantinya.

Abaikan parameter ini untuk mewarisi model yang digunakan oleh preview task, yang membuat preview dan refine-nya tetap pada model yang sama dari awal hingga akhir. Berikan nilai eksplisit untuk menimpa pewarisan tersebut.

Jika diatur ke true, konten input akan secara otomatis diperiksa untuk konten yang berpotensi berbahaya. Jika konten berbahaya terdeteksi, task tidak akan dilanjutkan ke tahap generasi.

Baik teks dari texture_prompt maupun gambar dari texture_image_url akan diperiksa.

Menghapus highlight dan bayangan dari tekstur base color, menghasilkan hasil yang lebih bersih yang bekerja lebih baik di bawah 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 task. Jika diabaikan, semua format yang didukung akan disertakan.

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

Jika diatur ke true, task tersebut juga akan me-render versi preview dengan latar belakang transparan (RGBA) dan mengembalikannya sebagai alpha_thumbnail_url pada respons GET. Bidang thumbnail_url yang sudah ada tidak berubah.

Jika diatur ke true, layanan menggunakan AI vision untuk secara otomatis memperkirakan tinggi nyata dari objek dan mengubah ukuran model sesuai dengan itu. Titik asal akan default ke bottom kecuali origin_at diatur secara eksplisit.

Permintaan tidak dapat diterima. Penyebab umum:

• Task ID tidak valid: preview_task_id tidak valid atau tidak ada.
• Task belum siap: Preview task belum berhasil.
• Ketidakcocokan model: Model AI milik preview task tidak kompatibel dengan model refine yang diminta.
• Model tidak didukung untuk remove_lighting: remove_lighting diatur dengan ai_model: "meshy-6-lite".

Autentikasi gagal. Silakan periksa kunci API Anda.

Kredit tidak cukup untuk melakukan task ini.

Preview task yang ditentukan oleh preview_task_id tidak ditemukan.

Anda telah melampaui batas laju Anda.

Pengidentifikasi unik untuk task Teks ke 3D yang akan diambil.

ID dari task Teks ke 3D yang akan dihapus.

Nomor halaman untuk paginasi.

Batas ukuran halaman. Maksimum yang diperbolehkan adalah 100 item.

Kolom yang digunakan untuk pengurutan.

Nilai yang tersedia:

• +created_at: Urutkan berdasarkan waktu pembuatan secara ascending.
• -created_at: Urutkan berdasarkan waktu pembuatan secara descending.

Pengenal unik untuk tugas Text to 3D yang akan di-stream.

Identifier 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 task Teks ke 3D. Nilai yang mungkin adalah text-to-3d-preview untuk task tahap preview dan text-to-3d-refine untuk task tahap refine.

URL yang dapat diunduh untuk file model 3D bertekstur yang dihasilkan oleh Meshy. Properti untuk suatu format akan dihilangkan jika format tersebut tidak dihasilkan, alih-alih mengembalikan string kosong.

Ini adalah prompt tanpa modifikasi yang digunakan untuk membuat task.

Dipertahankan untuk kompatibilitas mundur. Bidang ini tidak memiliki dampak fungsional pada model yang dihasilkan.

art_style tanpa modifikasi yang digunakan untuk membuat task preview. Tidak didukung oleh Meshy-6.

Dipertahankan untuk kompatibilitas mundur. Bidang ini tidak memiliki dampak fungsional pada model yang dihasilkan.

Prompt teks tambahan yang disediakan untuk memandu proses pembuatan tekstur selama tahap refine.

Usang; baca geometry_resolution sebagai gantinya.

Tingkat Ultra tempat task preview dijalankan (2k atau 4k); dihilangkan untuk standard.

URL yang dapat diunduh untuk gambar tekstur yang digunakan untuk memandu proses pembuatan tekstur.

URL yang dapat diunduh untuk gambar thumbnail dari file model.

URL yang dapat diunduh untuk versi latar belakang transparan (RGBA) dari thumbnail_url. Hanya ada jika task dibuat dengan alpha_thumbnail: true dan preview transparan berhasil dirender; jika tidak, bidang ini akan dihilangkan.

URL yang dapat diunduh untuk video preview. Akan dihapus pada rilis mendatang.

Progress dari task. Jika task belum dimulai, properti ini akan bernilai 0. Setelah task berhasil, nilai ini akan menjadi 100.

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

Stempel waktu saat task dibuat, dalam milidetik.

Stempel waktu saat 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. Biasanya ini hanya berisi satu objek URL tekstur. Setiap URL tekstur memiliki properti-properti berikut:

Jumlah task yang mendahului.

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

Jumlah kredit yang terpakai oleh task ini. Tersedia saat status task adalah PENDING, IN_PROGRESS, atau SUCCEEDED. Mengembalikan 0 untuk task FAILED (kredit dikembalikan jika gagal).