API Ukiran timbul

Foto untuk ditukar menjadi ukiran timbul, sebagai URL awam atau Data URI (data:image/png;base64,...).

Imej mestilah fail JPG, JPEG, PNG, atau WebP bersaiz maksimum 20 MB, dan sekurang-kurangnya 32 × 32 piksel. Sisi lebih panjangnya boleh menjadi paling banyak kira-kira 16 kali sisi lebih pendeknya. Imej lain mengembalikan 400. Meshy mengisi kawasan lut sinar dengan warna hitam sebelum membina ukiran timbul.

Gaya ukiran timbul. Ia membentuk peta kedalaman dan menetapkan carving_depth_mm lalai.

Nilai yang tersedia:

• high: ukiran lebih dalam, untuk kepingan cetak 3D.
• low: ukiran cetek, untuk ukiran laser, ukiran CNC, dan plak nipis.

Menghantar null atau "" adalah sama seperti meninggalkannya. Sebarang nilai lain mengembalikan 400.

Sama ada untuk membina model ukiran timbul. Tetapkan kepada false untuk tugas peta-kedalaman-sahaja, tanpa model dan tanpa imej pratonton. Meshy tetap menyemak parameter saiz, ukiran, asas, lengkungan, dan resolusi, tetapi tidak menggunakannya. Ia tidak mengubah kos kredit.

Panjang sisi lebih panjang foto pada model, diukur rata sebelum sebarang lengkungan, dari 20 hingga 250 milimeter. Dengan remove_base, model boleh menjadi lebih kecil.

Sama ada subjek menonjol dari plat atau diukir ke dalamnya.

Nilai yang tersedia:

• emboss: bahagian yang lebih dekat pada foto menonjol.
• engrave: kedalaman diterbalikkan, jadi bahagian yang lebih dekat diukir ke dalam.

Peta kedalaman adalah sama dalam kedua-dua mod.

Seberapa dalam ukiran timbul diukir, dari 0 hingga 60 milimeter. Dengan remove_base ditetapkan kepada true, 0 meninggalkan model kosong. Tugas tetap berjaya dan dikenakan 20 kredit, dan fail GLB serta STL-nya tidak mempunyai geometri.

Sama ada untuk memotong latar belakang dan tidak membina plat asas. Apabila true, removal_threshold menetapkan apa yang dikira sebagai latar belakang. Meshy menyemak removal_threshold dalam kedua-dua keadaan.

Ketebalan plat asas, dari 0.1 hingga 10 milimeter. Apabila remove_base ialah true, tinggalkan atau hantar 0.

Sama ada untuk melengkungkan ukiran timbul, dan ke arah mana. Apabila bukan off, bend_axis dan bend_angle membentuk lengkungan tersebut. Meshy menyemaknya dalam kedua-dua keadaan.

Nilai yang tersedia:

• off: ukiran timbul rata.
• convex: bahagian hadapan menonjol ke luar.
• concave: bahagian hadapan melengkung ke dalam.

Bilangan titik jejaring sepanjang sisi lebih panjang foto, dari 512 hingga 2048. Nilai yang lebih tinggi mengekalkan perincian yang lebih halus dan menghasilkan fail yang lebih besar. Pada lalai 1024, fail GLB adalah kira-kira 40 hingga 50 MB dan fail STL kira-kira 80 hingga 105 MB. Foto berbentuk segi empat sama memberikan saiz yang lebih besar. Pada 2048, ia kira-kira 150 MB dan 300 MB. Lengkungan menjadikannya lebih besar: fail STL boleh mencapai kira-kira 800 MB pada 2048.

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

• Parameter hilang: image_url tidak dihantar.
• Parameter tidak sah: Satu parameter mempunyai jenis yang salah, berada di luar julatnya, atau bukan salah satu nilai yang tersedia. Contohnya, variant bukan high atau low, atau mesh_resolution bukan integer dari 512 hingga 2048.
• Ketebalan asas: base_thickness_mm bukan 0 dengan remove_base ditetapkan kepada true, atau di bawah 0.1 tanpanya.
• URL tidak dapat dicapai: Meshy tidak dapat memuat turun imej image_url, contohnya kerana URL mengembalikan 404 atau tamat masa.
• Imej tidak sah: Imej bukan fail JPG, JPEG, PNG, atau WebP, melebihi 20 MB, lebih kecil daripada 32 × 32 piksel, mempunyai terlalu banyak piksel, atau tidak dapat dibaca.
• Nisbah bidang melampau: Sisi lebih panjang imej lebih daripada kira-kira 16 kali sisi lebih pendeknya.

Betulkan permintaan, kemudian hantar semula. Meshy tidak mengenakan caj untuknya. Lihat Ralat.

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

Moderation kandungan menyekat imej tersebut. Meshy tidak mengenakan caj untuk permintaan ini. Hantar imej lain.

Salah satu had berikut telah dicapai:

• Anda menghantar terlalu banyak permintaan. Tunggu, kemudian cuba semula. Lihat Had kadar.
• Terlalu banyak tugas anda sedang dalam baris gilir atau berjalan. Tunggu sehingga sesetengahnya selesai, kemudian cuba semula.
• Pada pelan tanpa had tanpa baki kredit, anda telah mencapai bilangan tugas yang boleh berjalan tanpa kredit. Tunggu sehingga satu tugas selesai, atau tambah kredit.

ID tugas daripada respons pembuatan (create).

ID tugas yang hendak dipadam.

Nombor halaman yang hendak dikembalikan. Bermula pada dan lalai kepada 1.

Bilangan tugas setiap halaman, sehingga 100. Lalai kepada 10. Meshy menganggap nilai dari 101 hingga 255 sebagai 100, dan nilai yang lebih besar akan mengembalikan 400.

Susunan isihan.

Nilai yang tersedia:

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

ID tugas daripada respons penciptaan.

ID tugas. Anggapnya sebagai rentetan legap, dan jangan bergantung pada formatnya.

Jenis tugas, sentiasa relief.

URL muat turun untuk model ukiran timbul. Fail boleh menjadi besar; mesh_resolution menyenaraikan saiz biasa.

URL muat turun untuk peta kedalaman skala kelabu 16-bit yang menjadi asas ukiran timbul. Piksel yang lebih cerah adalah lebih tinggi. Nilai tersebut adalah ketinggian relatif, bukan milimeter. Perisian ukiran laser dan CNC boleh menggunakannya sebagai peta ketinggian. Saiz fail adalah kira-kira 1 hingga 2 MB. Kosong jika tiada.

URL muat turun untuk imej pratonton model ukiran timbul. Kosong jika tiada yang dirender, termasuk bagi tugas khusus peta kedalaman sahaja.

Sejauh mana tugas telah selesai, dalam peratusan. Ia adalah 0 sehingga tugas bermula dan 100 apabila ia berjaya.

Status tugas, salah satu daripada PENDING, IN_PROGRESS, SUCCEEDED, atau FAILED.

Bilangan tugas yang mendahului tugas ini dalam baris gilir. Medan ini ditinggalkan apabila nilainya 0, jadi ia hanya muncul semasa terdapat tugas yang mendahului tugas ini.

Masa tugas dicipta, dalam milisaat Unix.

Masa tugas bermula, dalam milisaat Unix. Ia adalah 0 sehingga tugas bermula.

Masa tugas selesai, dalam milisaat Unix. Ia adalah 0 sehingga tugas selesai.

Masa keputusan tugas tamat tempoh, dalam milisaat Unix. Ia adalah 0 sehingga tugas selesai.

Butiran ralat apabila tugas gagal. Lihat Ralat.

Bilangan kredit yang digunakan oleh tugas: 20, atau 0 untuk tugas FAILED, yang akan dikembalikan semula oleh Meshy.