API Auto Split

ID tugasan yang berjaya yang modelnya hendak dipisahkan. Jenis tugasan yang disokong: Imej ke 3D, Berbilang Imej ke 3D, Teks ke 3D (pratonton), Remesh, Tukar, dan Ubah saiz. Tugasan tersebut mesti mempunyai status SUCCEEDED, dan modelnya mesti dijana dengan Meshy 6 atau Meshy 7 (ai_model meshy-6, meshy-7, atau latest). Model low-poly dan Smart Topology (meshy-t2) tidak disokong.

Cara model dibahagikan kepada bahagian-bahagian.

Nilai yang tersedia:

• auto: Meshy memilih titik potongan. prompt diabaikan.
• by_parts: Potong mengikut bahagian struktur yang anda namakan dalam prompt, seperti kepala, tangan, dan badan.
• by_color: Potong mengikut kawasan warna yang anda namakan dalam prompt. Memerlukan input yang dijana daripada imej yang dimuat naik (Imej ke 3D atau Berbilang Imej ke 3D); input lain akan ditolak dengan 400.

Format untuk mengeksport model yang telah dipisahkan. Setiap bahagian adalah objek berasingan dalam setiap format. glb sentiasa dihasilkan dan dikembalikan dalam model_urls; senaraikan mana-mana format lain yang anda mahu sebagai tambahan.

Nilai yang tersedia: glb, obj, fbx, usdz, blend, 3mf.

3mf ditulis untuk slicer: satu objek bagi setiap bahagian, masing-masing pada slot filamennya sendiri, supaya Bambu Studio membuka fail tersebut sebagai bahagian-bahagian yang berwarna secara individu dan boleh dipilih secara berasingan (arkib tersebut membawa konfigurasi projek Bambu Studio; slicer lain membaca geometrinya sahaja). Sama seperti format cetakan lain Meshy, ia dalam milimeter dan, kerana endpoint ini tidak menerima saiz sasaran, keseluruhan model diskalakan supaya sisi terpanjangnya adalah 150 mm — had yang sama yang digunakan oleh eksport format cetakan lain, dipilih agar sesuai dengan setiap plat pembinaan arus perdana. Dengan layout: "on_plate", had tersebut dikenakan pada keseluruhan plat yang telah disusun, supaya fail tersebut sedia untuk dihiris; dengan assembled, bahagian-bahagian tersebut kekal pada kedudukan asalnya dalam model sumber dan anda menyusunnya dalam slicer.

Cara bahagian-bahagian disusun dalam setiap format output, dan dalam imej kecil.

Nilai yang tersedia:

• assembled: Bahagian-bahagian kekal pada kedudukan asalnya dalam model sumber.
• on_plate: Bahagian-bahagian diletakkan mendatar dan disebarkan di atas plat pembinaan, sedia untuk dihiris — susunan yang sama seperti paparan On Plate dalam aplikasi web.

Dalam kedua-dua susunan, fail yang dieksport membawa satu objek bagi setiap bahagian dan tidak lebih daripada itu: kepingan nipis yang runtuh atau bahagian seperti titik yang tertinggal daripada satu potongan akan dialih keluar sebelum eksport, supaya setiap objek yang anda dapati dalam fail tersebut boleh dicetak.

Menambah penyambung tanggam-lidah pada setiap potongan supaya bahagian yang dicetak boleh dipasang bersama.

Permintaan tersebut tidak boleh diterima. Sebab-sebab biasa:

• Prompt tiada: prompt diperlukan apabila mode adalah by_parts atau by_color.
• Prompt menamakan kurang daripada dua bahagian: by_parts / by_color memerlukan sekurang-kurangnya dua bahagian yang dinamakan (contohnya head, torso, base); arahan generik seperti split into individual parts akan ditolak. Tiada caj dikenakan.
• Tugasan input tidak disokong: input_task_id mesti merujuk kepada tugasan yang berjaya dari jenis yang disokong, dijana dengan Meshy 6 atau Meshy 7.
• Input bertekstur: Model input tersebut mempunyai tekstur. Hanya model tanpa tekstur disokong pada masa ini.
• Tiada imej rujukan: by_color memerlukan input yang dijana daripada imej yang dimuat naik.
• Format tidak disokong: target_formats mengandungi stl.
• Penyambung di luar julat: connector_size atau connector_height adalah di luar 0.1 hingga 0.8.

Pengesahan gagal. Sila semak kunci API anda.

Kredit tidak mencukupi untuk melaksanakan tugasan ini.

input_task_id tidak wujud atau tidak dimiliki oleh akaun anda.

Anda telah melebihi had kadar anda. Permintaan by_parts dan by_color juga berkongsi had penghuraian prompt sebanyak 12 permintaan seminit bagi setiap akaun.

Pemisahan berasaskan prompt (by_parts dan by_color) tidak tersedia buat sementara waktu. Cuba lagi kemudian, atau gunakan mode: "auto", yang tidak terjejas. Tiada caj dikenakan.

ID bagi tugas Auto Split yang hendak didapatkan semula.

ID tugasan Auto Split yang hendak dipadam.

Nombor halaman untuk penomboran halaman. Bermula dan lalai kepada 1.

Had saiz halaman. Lalai kepada 10 item. Maksimum yang dibenarkan ialah 100 item; nilai yang lebih besar akan dikekang kepada 100.

Medan untuk diisih mengikut. Nilai yang tersedia:

• +created_at: Isih mengikut masa penciptaan secara menaik.
• -created_at: Isih mengikut masa penciptaan secara menurun.

Pengecam unik untuk tugas Auto Split yang hendak dialirkan.

Pengenal unik untuk tugas. Walaupun kami menggunakan UUID k-sortable untuk id tugas sebagai butiran pelaksanaan, anda tidak seharusnya membuat sebarang andaian tentang format id tersebut.

Jenis tugas. Nilainya ialah print-split.

URL yang boleh dimuat turun untuk model yang dipisahkan, satu bagi setiap format yang diminta. Setiap bahagian adalah objek berasingan dalam fail. Sifat untuk sesuatu format akan ditinggalkan jika format itu tidak diminta.

URL yang boleh dimuat turun untuk pratonton terjana model yang dipisahkan, dengan setiap bahagian dalam warna yang berbeza, dalam layout yang diminta.

true apabila prompt bagi permintaan by_parts atau by_color tidak menamakan mana-mana bahagian, jadi Meshy memisahkan model tersebut secara automatik sebaliknya — nama bahagian dalam hasilnya adalah kepunyaan Meshy, bukan milik anda. Hadir bermula dari PENDING. Ditinggalkan untuk tugas auto dan apabila prompt tersebut diikuti.

Bilangan bahagian yang boleh dicetak dalam model yang dipisahkan — satu bagi setiap objek dalam fail yang dieksport. Kepingan runtuh yang tidak dapat dijadikan bahagian yang boleh dicetak oleh proses segmentasi dikeluarkan daripada fail sebelum eksport dan tidak dikira.

Progress tugas. Jika tugas belum bermula lagi, sifat ini akan menjadi 0. Apabila tugas berjaya, ini akan menjadi 100.

Status tugas. Nilai yang mungkin ialah salah satu daripada PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Bilangan tugas terdahulu.

Cap masa bila tugas dicipta, dalam milisaat.

Cap masa bila tugas dimulakan, dalam milisaat. Jika tugas belum bermula lagi, sifat ini akan menjadi 0.

Cap masa bila tugas selesai, dalam milisaat. Jika tugas belum selesai lagi, sifat ini akan menjadi 0.

Butiran ralat untuk tugas yang gagal. Lihat Ralat untuk rujukan penuh objek task_error.

Bilangan kredit yang digunakan oleh tugas ini. Sentiasa hadir: 10 sebaik sahaja tugas diterima, dan 0 untuk tugas FAILED kerana caj itu dikembalikan apabila gagal. Memadam tugas semasa ia masih PENDING juga mengembalikan kredit tersebut.