Teks ke 3D API

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

Jelaskan jenis objek apa yang dimodelkan 3D. Maksimum 600 karakter.

Tentukan jenis pembuatan mesh 3D.

Nilai yang tersedia:

• standard: Pembuatan mesh 3D detail tinggi biasa.
• 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 menggunakan smart-topology sebagai gantinya.

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

Pembuatan standar (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 — topologi yang lebih bersih, bagian yang secara asli terpisah, keluaran segitiga, 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 tahap remesh harus diaktifkan. Untuk model kualitas tertinggi, kami merekomendasikan mengatur should_remesh ke false.

Jumlah target poligon (wajah) dalam keluaran. Jumlah aktual 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 (pereduksi) untuk mencapai sekitar jumlah ini. Rentang 100 hingga 300.000, default 30.000. Jika decimation_mode diatur, ia mendapatkan prioritas dan target_polycount diabaikan.
• Smart Topology — dengan model_type: smart-topology dan ai_model: meshy-t2. Model dihasilkan langsung dengan jumlah wajah ini; tidak ada yang meng- remesh dan should_remesh tidak diperlukan. Rentang 100 hingga 15.000, default 4.000.

Usang. Parameter ini tidak lagi mempengaruhi output.

Bidang symmetry_mode mengontrol perilaku simetri selama proses pembuatan model.

Nilai valid adalah:

• off: Menonaktifkan simetri.
• auto: Menentukan dan menerapkan simetri secara otomatis berdasarkan geometri masukan.
• on: Memaksa simetri selama pembuatan.

Tentukan mode pose 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 menghasilkan model dalam pose A/T.

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

Ketika diatur ke true, konten masukan akan diperiksa secara otomatis untuk konten yang berpotensi berbahaya. Jika konten berbahaya terdeteksi, tugas tidak akan dilanjutkan ke pembuatan.

Teks dari prompt akan diperiksa.

Menentukan format file 3D yang akan dimasukkan dalam keluaran. Hanya format yang diminta yang akan dihasilkan dan dikembalikan, yang dapat mengurangi waktu penyelesaian tugas. Ketika dihilangkan, semua format yang didukung dimasukkan.

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

Ketika diatur ke true, tugas juga merender versi pratinjau dengan latar belakang transparan (RGBA) dan mengembalikannya sebagai alpha_thumbnail_url pada respons GET. Bidang thumbnail_url yang ada tidak berubah.

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

Permintaan tidak diterima. Penyebab umum:

• Parameter hilang: Parameter yang dibutuhkan (misalnya, prompt, mode) hilang.
• Parameter tidak valid: art_style bukan salah satu dari nilai yang diizinkan.
• Prompt terlalu panjang: prompt melebihi batas karakter.

Autentikasi gagal. Silakan periksa kunci API anda.

Kredit tidak mencukupi untuk melakukan tugas ini.

Anda telah melebihi batas laju anda.

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

ID tugas pratinjau yang sesuai.

Status tugas pratinjau yang diberikan harus SUCCEEDED.

Hasilkan Peta PBR (metallic, roughness, normal) selain warna dasar. Peta emisi juga disertakan ketika ai_model adalah meshy-6, kecuali pada texture_resolution: 8k (tidak ada peta emisi yang dihasilkan). meshy-7 (dan latest) tidak menghasilkan peta emisi.

Resolusi warna dasar tekstur. 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". Ketika keduanya diatur, texture_resolution akan diutamakan.

Berikan prompt teks tambahan untuk membimbing proses teksturing. Maksimum 600 karakter.

Berikan gambar 2d untuk membimbing proses teksturing. Saat ini kami mendukung format .jpg, .jpeg, dan .png.

Ada dua cara untuk memberikan gambar:

• URL yang dapat diakses secara publik: URL yang dapat diakses dari internet publik
• Data URI: URI data yang dikodekan base64 dari gambar. Contoh URI data: data:image/jpeg;base64,<your base64-encoded image data>

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

Ketika diatur ke true, konten masukan akan diperiksa secara otomatis untuk konten yang berpotensi berbahaya. Jika konten berbahaya terdeteksi, tugas tidak akan dilanjutkan ke pembuatan.

Baik teks dari texture_prompt dan gambar dari texture_image_url akan diperiksa.

Menghapus sorotan dan bayangan dari tekstur warna dasar, menghasilkan hasil yang lebih bersih yang lebih baik untuk pengaturan pencahayaan kustom.

Menentukan format file 3D yang akan dimasukkan dalam keluaran. Hanya format yang diminta yang akan dihasilkan dan dikembalikan, yang dapat mengurangi waktu penyelesaian tugas. Ketika dihilangkan, semua format yang didukung dimasukkan.

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

Ketika diatur ke true, tugas juga merender versi pratinjau dengan latar belakang transparan (RGBA) dan mengembalikannya sebagai alpha_thumbnail_url pada respons GET. Bidang thumbnail_url yang ada tidak berubah.

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

Permintaan tidak diterima. Penyebab umum:

• ID tugas tidak valid: preview_task_id tidak valid atau tidak ada.
• Tugas tidak siap: Tugas pratinjau belum berhasil.
• Ketidakcocokan model: Model AI tugas pratinjau tidak sesuai dengan model refine yang diminta.

Autentikasi gagal. Silakan periksa kunci API anda.

Kredit tidak mencukupi untuk melakukan tugas ini.

Tugas pratinjau 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 diperbolehkan adalah 50 item.

Bidang untuk diurutkan.

Nilai yang tersedia:

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

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

Pengidentifikasi unik untuk tugas. Sementara kami menggunakan UUID k-sortable untuk ID tugas sebagai detail implementasi, Anda seharusnya tidak membuat asumsi apapun tentang format ID tersebut.

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

URL Terunduh untuk file model 3D bertekstur yang dihasilkan oleh Meshy. Properti untuk sebuah format akan dihilangkan jika format tersebut tidak dihasilkan daripada mengembalikan string kosong.

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

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

art_style yang tidak diubah yang digunakan untuk membuat tugas pratinjau. 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 membimbing proses teksturing selama tahap refine.

Mencerminkan nilai ultra_mode tugas pratinjau dibuat. Hanya hadir untuk tugas pratinjau meshy-7 (atau latest) yang secara eksplisit mengatur ultra_mode; sebaliknya dihilangkan.

URL Terunduh untuk gambar tekstur yang digunakan untuk membimbing proses teksturing.

URL Terunduh untuk gambar thumbnail dari file model.

URL Terunduh untuk versi thumbnail_url dengan latar belakang transparan (RGBA). Hanya hadir saat tugas dibuat dengan alpha_thumbnail: true dan pratinjau transparan berhasil dirender; jika tidak, bidang ini dihilangkan.

URL Terunduh untuk video pratinjau. Akan dihapus di rilis mendatang.

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

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

Stempel waktu kapan tugas dibuat, dalam milidetik.

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

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

Sebuah array 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. Hadir ketika status tugas adalah PENDING, IN_PROGRESS, atau SUCCEEDED. Mengembalikan 0 untuk tugas FAILED (kredit dikembalikan saat gagal).