Relief timbul API

Foto yang akan diubah menjadi relief, berupa URL publik atau data URI (data:image/png;base64,...).

Gambar harus berupa file JPG, JPEG, PNG, atau WebP dengan ukuran maksimal 20 MB, dan minimal 32 × 32 piksel. Sisi yang lebih panjang paling banyak sekitar 16 kali sisi yang lebih pendek. Gambar lain akan mengembalikan 400. Meshy akan mengisi area transparan dengan warna hitam sebelum membangun relief.

Gaya relief. Ini membentuk peta kedalaman dan menetapkan carving_depth_mm default.

Nilai yang tersedia:

• high: ukiran yang lebih dalam, untuk bagian yang dicetak 3D.
• low: ukiran yang dangkal, untuk pengukiran laser, pengukiran CNC, dan plakat tipis.

Mengirim null atau "" sama saja dengan tidak menyertakannya. Nilai lain akan mengembalikan 400.

Apakah akan membangun model relief. Atur ke false untuk task yang hanya menghasilkan peta kedalaman, tanpa model dan tanpa gambar pratinjau. Meshy tetap memeriksa parameter ukuran, pengukiran, alas, lengkungan, dan resolusi, tetapi tidak menggunakannya. Ini tidak mengubah biaya kredit.

Panjang sisi foto yang lebih panjang pada model, diukur dalam keadaan datar sebelum ada lengkungan, dari 20 hingga 250 milimeter. Dengan remove_base, model dapat lebih kecil.

Apakah subjek menonjol dari plat atau dipotong ke dalamnya.

Nilai yang tersedia:

• emboss: bagian foto yang lebih dekat akan menonjol.
• engrave: kedalaman dibalik, sehingga bagian yang lebih dekat terpotong ke dalam.

Peta kedalaman sama di kedua mode.

Seberapa dalam relief diukir, dari 0 hingga 60 milimeter. Dengan remove_base diatur ke true, 0 menghasilkan model kosong. Task tetap berhasil dan dikenakan biaya 20 kredit, dan file GLB serta STL-nya tidak memiliki geometri.

Apakah akan memotong latar belakang dan tidak membangun plat alas. Saat true, removal_threshold menentukan apa yang dianggap sebagai latar belakang. Meshy memeriksa removal_threshold dalam kedua kasus.

Ketebalan plat alas, dari 0.1 hingga 10 milimeter. Saat remove_base adalah true, biarkan kosong atau kirim 0.

Apakah akan melengkungkan relief, dan ke arah mana. Saat bukan off, bend_axis dan bend_angle membentuk lengkungan. Meshy memeriksanya dalam kedua kasus.

Nilai yang tersedia:

• off: relief datar.
• convex: bagian depan menonjol keluar.
• concave: bagian depan melengkung ke dalam.

Jumlah titik mesh di sepanjang sisi foto yang lebih panjang, dari 512 hingga 2048. Nilai yang lebih tinggi mempertahankan detail yang lebih halus dan menghasilkan file yang lebih besar. Pada nilai default 1024, file GLB berukuran sekitar 40 hingga 50 MB dan file STL sekitar 80 hingga 105 MB. Foto berbentuk persegi menghasilkan ukuran yang lebih besar. Pada 2048, ukurannya sekitar 150 MB dan 300 MB. Lengkungan membuatnya lebih besar: file STL dapat mencapai sekitar 800 MB pada 2048.

Permintaan tidak dapat dijalankan. Pesan kesalahan menunjukkan masalah apa yang ditemukan. Contohnya:

• Parameter hilang: image_url tidak dikirim.
• Parameter tidak valid: Sebuah parameter memiliki tipe yang salah, berada di luar rentangnya, atau bukan salah satu nilai yang tersedia. Contohnya, variant bukan high atau low, atau mesh_resolution bukan bilangan bulat dari 512 hingga 2048.
• Ketebalan alas: base_thickness_mm bukan 0 saat remove_base diatur ke true, atau berada di bawah 0.1 tanpa itu.
• URL tidak dapat dijangkau: Meshy tidak dapat mengunduh gambar image_url, misalnya karena URL mengembalikan 404 atau waktu habis.
• Gambar tidak valid: Gambar bukan file JPG, JPEG, PNG, atau WebP, berukuran lebih dari 20 MB, lebih kecil dari 32 × 32 piksel, memiliki terlalu banyak piksel, atau tidak dapat dibaca.
• Rasio aspek ekstrem: Sisi gambar yang lebih panjang lebih dari sekitar 16 kali sisi yang lebih pendek.

Perbaiki permintaan, lalu kirim lagi. Meshy tidak mengenakan biaya untuk ini. Lihat Kesalahan.

Kunci API hilang atau tidak valid. Periksa header Authorization.

Contohnya:

• Kredit tidak cukup: Akun tidak memiliki cukup kredit untuk task ini, atau akun mencapai batas kredit. Periksa saldo kredit Anda, lalu coba lagi.
• Paket gratis: Membuat task memerlukan paket berbayar. Tingkatkan paket Anda di pengaturan langganan Anda, lalu coba lagi.

Moderasi konten memblokir gambar. Meshy tidak mengenakan biaya untuk permintaan ini. Kirim gambar lain.

Salah satu batas ini tercapai:

• Anda mengirim terlalu banyak permintaan. Tunggu, lalu coba lagi. Lihat Batas laju.
• Terlalu banyak task Anda yang sedang antre atau berjalan. Tunggu hingga beberapa selesai, lalu coba lagi.
• Pada paket tak terbatas tanpa sisa kredit, Anda mencapai jumlah task yang dapat berjalan tanpa kredit. Tunggu hingga sebuah task selesai, atau tambahkan kredit.

ID task dari respons pembuatan (create).

ID tugas yang akan dihapus.

Nomor halaman yang akan dikembalikan. Dimulai dari dan default-nya adalah 1.

Jumlah tugas per halaman, hingga 100. Default-nya adalah 10. Meshy memperlakukan nilai dari 101 hingga 255 sebagai 100, dan nilai yang lebih besar akan mengembalikan 400.

Urutan pengurutan.

Nilai yang tersedia:

• +created_at: terlama lebih dulu
• -created_at: terbaru lebih dulu

ID tugas dari respons pembuatan.

ID task. Perlakukan sebagai string buram, dan jangan bergantung pada formatnya.

Jenis task, selalu relief.

URL unduhan untuk model relief timbul. Berkasnya bisa berukuran besar; mesh_resolution mencantumkan ukuran umumnya.

URL unduhan untuk depth map grayscale 16-bit yang menjadi dasar pembuatan relief timbul. Piksel yang lebih terang berarti lebih tinggi. Nilainya adalah tinggi relatif, bukan milimeter. Perangkat lunak laser engraving dan CNC dapat menggunakannya sebagai height map. Ukuran berkasnya sekitar 1 hingga 2 MB. Kosong jika tidak ada.

URL unduhan untuk gambar pratinjau model relief timbul. Kosong jika tidak ada yang di-render, termasuk untuk task yang hanya menghasilkan depth map.

Seberapa banyak task yang sudah selesai, dalam bentuk persentase. Nilainya 0 hingga task dimulai dan 100 saat berhasil.

Status task, salah satu dari PENDING, IN_PROGRESS, SUCCEEDED, atau FAILED.

Jumlah task yang berada di depan task ini dalam antrean. Kolom ini tidak disertakan jika nilainya 0, sehingga hanya muncul selama masih ada task lain di depannya.

Waktu task dibuat, dalam milidetik Unix.

Waktu task dimulai, dalam milidetik Unix. Nilainya 0 hingga task dimulai.

Waktu task selesai, dalam milidetik Unix. Nilainya 0 hingga task selesai.

Waktu hasil task kedaluwarsa, dalam milidetik Unix. Nilainya 0 hingga task selesai.

Detail kesalahan saat task gagal. Lihat Kesalahan.

Jumlah kredit yang digunakan task: 20, atau 0 untuk task FAILED, yang dikembalikan oleh Meshy.