Auto Split API

ID tugas yang modelnya hendak dipecahkan. Tugas tersebut mesti berstatus SUCCEEDED. Jenis tugas berikut berfungsi:

• Imej ke 3D
• Berbilang Imej ke 3D
• Teks ke 3D, tugas preview atau refine
• Retekstur
• Remesh
• Tukar
• Ubah saiz

Model tersebut mesti dijana dengan Meshy 6 atau Meshy 7, iaitu dengan ai_model ditetapkan kepada meshy-6-lite, meshy-6, meshy-7, meshy-7.1, atau latest. Model Smart Topology (meshy-t2 dan meshy-t2.5) tidak disokong. Untuk tugas refine, Retekstur, Remesh, Tukar, atau Ubah saiz, peraturan ini terpakai kepada model asal tugas tersebut dimulakan. Tugas Retekstur, Remesh, Tukar, atau Ubah saiz yang dibuat daripada model yang dimuat naik mengembalikan 400.

Model boleh mempunyai paling banyak 8,000,000 segi tiga (faces). Model dengan lebih banyak segi tiga mengembalikan 400. Dalam kes itu, jalankan tugas Remesh terlebih dahulu, dan hantar ID tugas Remesh tersebut sebagai ganti.

Anda boleh memecahkan model yang bertekstur. Untuk mengekalkan teksturnya pada bahagian-bahagian tersebut, hantar keep_texture: true.

Cara untuk membahagikan model kepada bahagian-bahagian.

Nilai yang tersedia:

• auto: Meshy memilih pemotongan dan mengabaikan prompt. prompt yang melebihi 600 aksara tetap mengembalikan 400.
• by_parts: Meshy memotong mengikut bahagian struktur yang anda namakan dalam prompt, contohnya kepala, lengan, dan badan.
• by_color: Meshy memotong mengikut kawasan warna yang anda namakan dalam prompt. Meshy mencari kawasan tersebut dalam imej sumber, bukan dalam tekstur model input. Input mesti dijana daripada imej yang dimuat naik, dengan Imej ke 3D atau Berbilang Imej ke 3D. Input lain mengembalikan 400. Untuk Berbilang Imej ke 3D, Meshy menggunakan imej sumber yang pertama.

Format fail untuk dijana. Meshy sentiasa menjana glb dan mengembalikannya dalam model_urls, ditambah format lain yang anda senaraikan.

Nilai yang tersedia:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

Setiap format kecuali stl menyokong objek adegan dan menyimpan setiap bahagian sebagai objek berasingan. Fail STL tidak boleh menyimpan objek berasingan, jadi Meshy menggabungkan bahagian-bahagian tersebut menjadi satu pepejal, disusun mengikut layout. Untuk mendapatkan bahagian-bahagian yang boleh anda pilih secara berasingan dalam slicer, minta 3mf.

Dengan keep_texture: true, format-format berikut menyimpan tekstur:

• glb, fbx, usdz, dan blend: Tekstur tersebut berada di dalam fail.
• obj: Tekstur tersebut berada dalam fail bahan, yang dikembalikan oleh model_urls di bawah mtl.
• stl dan 3mf: Fail tersebut hanya menyimpan geometri, tanpa tekstur.

Cara Meshy menyusun bahagian-bahagian tersebut, dalam setiap format fail dan dalam imej kecil.

Nilai yang tersedia:

• assembled: Meshy mengekalkan bahagian-bahagian tersebut pada kedudukan asalnya dalam model sumber.
• on_plate: Meshy meletakkan bahagian-bahagian tersebut secara rata dan menyebarkannya pada plat pembinaan (build plate), sedia untuk dihiris. Ini adalah susunan yang sama seperti paparan On Plate dalam aplikasi web.

Dalam kedua-dua susunan, Meshy mengalih keluar sebarang kepingan yang runtuh atau kecil seperti titik yang ditinggalkan oleh pemotongan sebelum eksport, supaya setiap bahagian yang anda terima boleh dicetak. Format yang menyokong objek adegan menyimpan satu objek bagi setiap bahagian, dan stl menggabungkan bahagian-bahagian tersebut menjadi satu pepejal.

Sama ada untuk mengekalkan tekstur model input pada bahagian-bahagian tersebut. true memberikan setiap bahagian tekstur input tersebut, dan tugas tersebut mengembalikan peta dalam texture_urls. false memberikan setiap bahagian warna verteks rata.

Dengan true, tugas tersebut mengambil masa kira-kira dua kali ganda, dan kos kredit tidak berubah. Input yang tidak bertekstur dipecahkan dengan cara yang sama seperti dengan false. Jika Meshy tidak dapat mengekalkan tekstur tersebut, tugas tersebut gagal dengan kod ralat textured_split_refused. Lihat Ralat.

Sama ada untuk menambah penyambung tenon-dan-mortis pada setiap potongan, supaya bahagian-bahagian yang dicetak boleh dipasang bersama.

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

• Prompt tiada: mode ialah by_parts atau by_color, dan prompt tiada.
• Prompt tidak menerangkan sebarang pemecahan, atau terlalu banyak bahagian: Prompt tersebut meminta model tersebut dikekalkan sebagai satu kepingan, atau menamakan lebih daripada 10 bahagian. by_parts dan by_color menerima 1 hingga 10 bahagian yang dinamakan. Meshy tidak mengenakan caj untuk permintaan tersebut.
• Tugas input tidak disokong: input_task_id bukan tugas berjaya daripada jenis yang disokong, yang dijana dengan Meshy 6 atau Meshy 7.
• Tiada imej rujukan: mode ialah by_color, dan input tersebut tidak dijana daripada imej yang dimuat naik.
• Penyambung di luar julat: connector_size atau connector_height berada di luar 0.1 hingga 0.8.

Betulkan permintaan tersebut, kemudian hantar semula. Lihat Ralat.

Kunci API tiada atau tidak sah. Semak header Authorization.

Contohnya:

• Kredit tidak mencukupi: Akaun tersebut tidak mempunyai kredit yang mencukupi untuk tugas ini, atau akaun tersebut 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.

Salah satu daripada berikut berlaku:

• Moderation kandungan menyekat prompt tersebut. Mesejnya ialah explicit content atau prohibited content. Tukar prompt tersebut, kemudian cuba semula.
• input_task_id ialah model bas-relief, yang tidak dapat dipecahkan oleh endpoint ini. Mesejnya ialah This model type does not support this operation. Hantar model yang lain.

input_task_id tidak wujud atau bukan milik akaun anda. Semak ID tersebut, dan gunakan kunci API daripada akaun yang mencipta tugas tersebut.

Anda telah melebihi had kadar anda. Tunggu, kemudian cuba semula. Lihat Had kadar.

Permintaan by_parts dan by_color juga berkongsi had pembacaan prompt sebanyak 12 permintaan seminit bagi setiap akaun.

Pemecahan menggunakan prompt (by_parts dan by_color) buat sementara waktu tidak tersedia. Cuba semula kemudian, atau hantar mode: "auto", yang masih berfungsi. Meshy tidak mengenakan caj untuk permintaan tersebut.

ID tugas daripada respons pembuatan (create).

ID tugas yang hendak dipadam.

Nombor halaman yang hendak dikembalikan. Bermula pada dan lalainya 1.

Bilangan tugasan setiap halaman, sehingga 100. Lalainya 10. Meshy menganggap nilai yang lebih besar sebagai 100.

Susunan isihan.

Nilai yang tersedia:

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

ID tugas daripada respons create.

ID tugasan. Anggap ia sebagai rentetan legap, dan jangan bergantung pada formatnya.

Jenis tugasan, sentiasa print-split.

URL muat turun untuk model yang dipecahkan, satu bagi setiap format yang anda minta. Format yang tidak anda minta tiada kunci. Format yang menyokong objek adegan mengekalkan setiap bahagian sebagai objek berasingan, dan stl menggabungkan bahagian-bahagian menjadi satu pepejal.

URL muat turun untuk imej pratonton model yang dipecahkan, dalam layout yang anda minta. Apabila bahagian-bahagian mengekalkan tekstur, pratonton menunjukkannya. Jika tidak, setiap bahagian mempunyai warnanya sendiri.

Peta tekstur bagi model yang dipecahkan, sebagai tatasusunan dengan satu objek. Semua bahagian berkongsi peta ini. Hadir hanya apabila keep_texture ialah true dan model input mempunyai tekstur.

URL muat turun untuk versi thumbnail_url dengan latar belakang lutsinar (RGBA). Hadir hanya selepas tugasan berjaya, apabila Meshy merender pratonton lutsinar tersebut.

Sama ada Meshy mengabaikan prompt tersebut. Ia bernilai true apabila prompt bagi permintaan by_parts atau by_color tidak menamakan sebarang bahagian, jadi Meshy memecahkan model tersebut secara automatik sebaliknya. Nama bahagian dalam hasil tersebut kemudiannya adalah milik Meshy, bukan milik anda. Hadir bermula dari PENDING. Meshy mengetepikannya untuk tugasan auto dan setiap kali ia mengikut prompt tersebut.

Bilangan bahagian boleh cetak yang dihasilkan oleh pembahagian tersebut. Format yang menyokong objek adegan menyimpan satu objek bagi setiap bahagian. stl menggabungkan bahagian-bahagian menjadi satu pepejal, tetapi part_count tetap mengiranya. Sebelum eksport, Meshy membuang serpihan runtuh yang tidak boleh menjadi bahagian boleh cetak, dan tidak mengiranya.

Berapa banyak tugasan yang telah selesai, dalam peratusan. Ia bernilai 0 sehingga tugasan bermula dan 100 apabila ia berjaya.

Status tugasan, salah satu daripada PENDING, IN_PROGRESS, SUCCEEDED, FAILED, atau CANCELED.

Bilangan tugasan yang berada di hadapan tugasan ini dalam baris gilir. Nilai ini hanya bermakna semasa tugasan berstatus PENDING.

Masa tugasan dicipta, dalam milisaat Unix.

Masa tugasan bermula, dalam milisaat Unix. Ia bernilai 0 sehingga tugasan bermula.

Masa tugasan selesai, dalam milisaat Unix. Ia bernilai 0 sehingga tugasan selesai.

Masa hasil tugasan tamat tempoh, dalam milisaat Unix. Ia bernilai 0 sehingga tugasan selesai.

Butiran ralat apabila tugasan gagal. Lihat Ralat.

Jika semakan keselamatan menolak model input, tugasan gagal dengan task_error.type ditetapkan kepada invalid_input dan task_error.code ditetapkan kepada provider_content_refused. Hantar model yang lain. Lihat Ralat.

Dengan keep_texture: true, jika Meshy tidak dapat mengekalkan tekstur, tugasan gagal dengan task_error.code ditetapkan kepada textured_split_refused. Lihat Ralat.

Bilangan kredit yang digunakan oleh tugasan tersebut. Ia sentiasa hadir. Ia bernilai 10 selepas Meshy menerima tugasan tersebut, dan 0 untuk tugasan FAILED, kerana Meshy memulangkan semula kredit apabila tugasan gagal. Memadam tugasan PENDING juga memulangkan semula kredit tersebut.