API Teks ke 3D

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

Jelaskan objek seperti apa yang menjadi model 3D tersebut. Maksimum 800 karakter.

Tentukan jenis pembuatan mesh 3D.

Nilai yang tersedia:

• standard: Pembuatan mesh 3D detail tinggi reguler.
• smart-topology: Pilih model Smart Topology dengan ai_model (meshy-t2).
• lowpoly (usang): Menghasilkan mesh low-poly yang dioptimalkan untuk poligon yang lebih bersih. Kami merekomendasikan penggunaan smart-topology sebagai gantinya.

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

Pembuatan standard (model_type: standard):

• meshy-5, meshy-6, meshy-7, latest (Meshy 7)

Pembuatan Smart Topology (model_type: smart-topology):

• meshy-t2 (default): model Smart Topology — topology yang lebih bersih, bagian yang terpisah secara native, output triangle, dan jumlah wajah yang dapat Anda atur dengan target_polycount.

Mengaktifkan pembuatan Ultra untuk geometri dengan fidelitas lebih tinggi dengan detail permukaan yang lebih halus. Pembuatan memakan waktu lebih lama dan menambah 5 kredit.

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

Jumlah target poligon (wajah) pada output. Jumlah sebenarnya dapat menyimpang dari target tergantung pada geometrinya.

target_polycount berlaku dalam dua kasus independen:

• Remesh — dengan should_remesh: true pada model standard. Mesh akan di-remesh (didesimasi) menjadi kira-kira jumlah ini. Rentang 100 hingga 300.000, default 30.000. Jika decimation_mode diatur, itu memiliki prioritas dan target_polycount diabaikan.
• Smart Topology — dengan model_type: smart-topology dan ai_model: meshy-t2. Model dihasilkan langsung pada jumlah wajah ini; tidak ada remesh yang dijalankan dan should_remesh tidak diperlukan. Rentang 100 hingga 15.000, default 4.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: Memberlakukan simetri selama pembuatan.

Tentukan pose_mode untuk model yang dihasilkan.

Nilai yang tersedia:

• a-pose: Menghasilkan model dalam pose A.
• t-pose: Menghasilkan 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 yang menggunakan Meshy-6 akan mengabaikan art_style, dan beberapa kombinasi dapat menyebabkan kesalahan. Nilai yang tersedia: realistic, sculpture.

Ketika diatur ke true, konten input akan secara otomatis diperiksa untuk potensi konten berbahaya. Jika konten berbahaya terdeteksi, task tidak akan dilanjutkan ke pembuatan.

Teks dari prompt akan diperiksa.

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

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

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

Ketika 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) hilang.
• Parameter tidak valid: art_style bukan salah satu nilai yang diizinkan.
• Prompt terlalu panjang: prompt melebihi batas karakter.

Autentikasi gagal. Silakan periksa kunci API Anda.

Kredit tidak mencukupi untuk melakukan task ini.

Anda telah melebihi batas laju Anda.

Field 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. Emission map juga disertakan ketika ai_model adalah meshy-6, kecuali pada texture_resolution: 8k (tidak ada emission map yang dihasilkan). meshy-7 (dan latest) tidak menghasilkan emission map.

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 diprioritaskan.

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

Berikan gambar 2d untuk memandu proses texturing. Kami saat ini mendukung format .jpg, .jpeg, dan .png.

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,<data gambar terenkode base64 Anda>

ID model yang digunakan untuk refining. Nilai yang tersedia: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

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

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 berfungsi lebih baik di bawah setup 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 dihilangkan, semua format yang didukung akan disertakan.

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

Ketika diatur ke true, task akan tambahan me-render versi latar belakang transparan (RGBA) dari preview dan mengembalikannya sebagai alpha_thumbnail_url pada respons GET. Field thumbnail_url yang sudah ada tidak berubah.

Ketika 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:

• ID task tidak valid: preview_task_id tidak valid atau tidak ada.
• Task belum siap: Preview task belum berhasil.
• Ketidakcocokan model: Model AI dari preview task tidak kompatibel dengan model refine yang diminta.

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 melebihi batas laju Anda.

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

ID dari tugas Teks ke 3D yang akan dihapus.

Nomor halaman untuk paginasi.

Batas ukuran halaman. Maksimum yang diizinkan adalah 50 item.

Bidang untuk pengurutan.

Nilai yang tersedia:

• +created_at: Urutkan berdasarkan waktu pembuatan dalam urutan naik.
• -created_at: Urutkan berdasarkan waktu pembuatan dalam urutan turun.

Pengenal unik untuk tugas Teks ke 3D yang akan di-stream.

Pengenal unik untuk tugas. Meskipun kami menggunakan UUID yang dapat diurutkan secara k untuk id tugas sebagai detail implementasi, Anda tidak boleh membuat asumsi tentang format id.

Jenis tugas Teks ke 3D. Nilai yang mungkin adalah text-to-3d-preview untuk tugas tahap preview dan text-to-3d-refine untuk tugas tahap refine.

URL yang dapat diunduh ke file model 3D bertekstur yang dihasilkan oleh Meshy. Properti untuk format akan dihilangkan jika format tidak dihasilkan daripada mengembalikan string kosong.

Ini adalah prompt yang tidak dimodifikasi yang digunakan untuk membuat tugas.

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

art_style yang tidak dimodifikasi yang digunakan untuk membuat tugas preview. Tidak didukung oleh Meshy-6.

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

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

Menggemakan nilai ultra_mode yang dibuat dengan tugas preview. Hanya ada untuk tugas preview meshy-7 (atau latest) yang secara eksplisit menetapkan ultra_mode; dihilangkan jika tidak.

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

URL yang dapat diunduh ke gambar thumbnail dari file model.

URL yang dapat diunduh ke versi latar belakang transparan (RGBA) dari thumbnail_url. Hanya ada ketika tugas dibuat dengan alpha_thumbnail: true dan pratinjau transparan berhasil dirender; jika tidak, bidang ini dihilangkan.

URL yang dapat diunduh ke video pratinjau. Akan dihapus dalam rilis mendatang.

Kemajuan dari tugas. Jika tugas belum dimulai, properti ini akan menjadi 0. Setelah tugas berhasil, ini akan menjadi 100.

Stempel waktu ketika tugas dimulai, dalam milidetik. Jika tugas belum dimulai, properti ini akan menjadi 0.

Stempel waktu ketika tugas dibuat, dalam milidetik.

Stempel waktu ketika tugas selesai, dalam milidetik. Jika tugas belum selesai, properti ini akan menjadi 0.

Status dari tugas. Nilai yang mungkin adalah salah satu dari PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Sebuah array dari objek URL tekstur yang dihasilkan dari tugas. Biasanya ini hanya berisi satu objek URL tekstur. Setiap URL tekstur memiliki properti berikut:

Jumlah tugas sebelumnya.

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

Jumlah kredit yang dikonsumsi oleh tugas ini. Ada ketika status tugas adalah PENDING, IN_PROGRESS, atau SUCCEEDED. Mengembalikan 0 untuk tugas FAILED (kredit dikembalikan pada kegagalan).