API Perbaiki Kemampuan Cetak

Wajib diisi kecuali Anda mengirim model_url. ID dari task yang model-nya ingin Anda perbaiki, misalnya task Gambar ke 3D, Multi-Gambar ke 3D, Teks ke 3D, Remesh, Retexture, atau Analisis kemampuan cetak. Task tersebut harus merupakan task yang Anda buat dengan API, dengan status SUCCEEDED dan memiliki model GLB.

Sebuah task Analisis kemampuan cetak yang memeriksa ketebalan dinding juga meneruskan informasi printer dan ukurannya. Perbaikan kemudian memeriksa ketebalan dinding dan menebalkan dinding yang tipis, bahkan jika Anda tidak mengirim keduanya. printer_type atau ukuran cetak yang Anda kirim akan menggantikan yang berasal dari analisis. Task Analisis kemampuan cetak dari file .stl, .fbx, atau .gltf yang berasal dari model_url tidak berfungsi untuk ini. Kirim file tersebut sebagai model_url sebagai gantinya.

Wajib diisi kecuali Anda mengirim input_task_id. Model yang akan diperbaiki, berupa URL publik atau Data URI. Jika Anda mengirim keduanya, Meshy menggunakan input_task_id.

Dari URL http atau https, model harus berupa file .glb, .gltf, .obj, .fbx, atau .stl dengan ukuran maksimal 400 MB. Data URI hanya dapat menampung file GLB base64 (data:model/gltf-binary;base64,...) atau glTF (data:model/gltf+json;base64,...) dengan ukuran maksimal 100 MB. Kirim file .obj, .fbx, atau .stl sebagai URL http atau https.

File yang berukuran lebih dari 100 MB juga harus mengikuti aturan berikut:

• File GLB, glTF, FBX, atau OBJ dapat memiliki paling banyak 10.000.000 faces. Meshy menghitung faces sebagai triangle, sehingga quad dihitung sebagai 2, dan mesh yang digambar lebih dari sekali dihitung sekali per salinan.
• File FBX harus berupa FBX biner versi 7.1 atau yang lebih baru.
• File GLB atau glTF tidak boleh menggunakan kompresi Draco.

URL download Meshy (assets.meshy.ai/…?Expires=…&Signature=…) ditandatangani dan berhenti berfungsi pada expires_at task tersebut. Membaca ulang task tidak memperbarui masa berlakunya. Untuk model yang Anda buat dengan Meshy, kirim input_task_id sebagai gantinya, yang akan tetap berfungsi selama Meshy masih menyimpan task sumbernya (lihat Retensi aset). Untuk menggunakan model tersebut setelahnya, unduh sebelum expires_at dan kirim salinan Anda sendiri.

Apakah juga akan merender pratinjau dengan latar belakang transparan (RGBA), dikembalikan dalam alpha_thumbnail_url saat Anda mengambil task. thumbnail_url tidak berubah.

Printer yang akan Anda gunakan. Ini menentukan ketebalan dinding minimum yang menjadi target perbaikan. Jika Anda mengirim ukuran cetak tanpa printer_type, Meshy menggunakan fdm, kecuali task Analisis kemampuan cetak di input_task_id menyediakan informasi printer.

Nilai yang tersedia:

• fdm: filament, dinding minimum 1.0 mm
• sla: resin, dinding minimum 0.8 mm
• full_color: full-color, dinding minimum 2.0 mm

Nilai lain akan mengembalikan 400.

Tinggi cetakan, dalam milimeter, dari 1 hingga 1000. Nilai di luar rentang tersebut akan mengembalikan 400. Kirim ini atau intended_print_longest_side_mm, tidak keduanya.

Ini hanya berfungsi dengan input GLB. Untuk model_url yang bukan file .glb, kirim intended_print_longest_side_mm sebagai gantinya.

Panjang sisi terpanjang dari cetakan, dalam milimeter, dari 1 hingga 1000. Nilai di luar rentang tersebut akan mengembalikan 400. Ini berfungsi dengan setiap format input.

Request tidak dapat dijalankan. Pesan kesalahan menunjukkan masalah apa yang ditemukan. Misalnya:

• Parameter hilang: Baik input_task_id maupun model_url tidak dikirim.
• UUID tidak valid: input_task_id bukan UUID yang valid.
• URL model tidak valid: model_url tidak berformat dengan benar, menggunakan skema yang tidak didukung, atau memiliki ekstensi file yang tidak didukung.
• File model terlalu besar: File model_url berukuran lebih dari 400 MB dari URL http atau https, atau lebih dari 100 MB sebagai data URI.
• Terlalu banyak faces: File model_url adalah file GLB, glTF, FBX, atau OBJ berukuran lebih dari 100 MB dengan lebih dari 10.000.000 faces. Kurangi jumlah faces, lalu kirim ulang filenya.
• ASCII FBX lebih dari 100 MB: File model_url adalah ASCII FBX dengan ukuran lebih dari 100 MB. Kirim sebagai FBX biner atau GLB.
• File model tidak dapat dibaca: File model_url berukuran lebih dari 100 MB, dan Meshy tidak dapat membaca header-nya. Misalnya, file tersebut adalah GLB atau glTF dengan kompresi Draco, atau FBX biner versi lebih lama dari 7.1.
• Header model terlalu kompleks: File model_url berukuran lebih dari 100 MB, dan header-nya memiliki terlalu banyak mesh, node, atau record untuk diperiksa. Kurangi jumlah objek dalam file, lalu kirim ulang.
• File model tidak dapat diunduh: model_url mengembalikan kesalahan, paling sering karena URL download Meshy yang ditandatangani telah kedaluwarsa. Membaca ulang task akan mengembalikan URL yang sama dengan masa berlaku yang sama. Kirim salinan file Anda sendiri, atau kirim input_task_id selama Meshy masih menyimpan task sumbernya.
• Task belum berhasil: Task input_task_id masih pending, sedang diproses, atau gagal.
• GLB hilang: Task input_task_id tidak memiliki model GLB untuk diperbaiki.
• Ukuran cetak tidak valid: intended_print_height_mm atau intended_print_longest_side_mm berada di luar rentang 1 hingga 1000, atau request memiliki keduanya.
• Jenis printer tidak dikenal: printer_type bukan fdm, sla, atau full_color.
• Tinggi pada model non-GLB: Request memiliki intended_print_height_mm dan model_url yang bukan file .glb. Kirim intended_print_longest_side_mm sebagai gantinya.
• Tidak dapat mengukur model ini berdasarkan tinggi: Pada tinggi yang diminta, atau default 150 mm, sisi terpanjang model akan berada di luar rentang 1 hingga 1.000 mm. Ini juga terjadi ketika model datar, atau ketika Meshy tidak dapat menentukan ukurannya. Kirim intended_print_longest_side_mm sebagai gantinya. Untuk model_url berupa .glb dan beberapa task input_task_id, Meshy baru menemukan hal ini setelah task dimulai, dan task akan berakhir sebagai FAILED sebagai gantinya.
• Ukuran STL tidak dapat digunakan: Request memiliki printer_type tanpa ukuran, dan Meshy tidak dapat membaca sisi terpanjang file .stl itu sendiri, atau nilainya di luar rentang 1 hingga 1.000 mm. Kirim intended_print_longest_side_mm.

Perbaiki request, lalu kirim ulang. Lihat Kesalahan.

Kunci API hilang atau tidak valid. Periksa header Authorization.

Misalnya:

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

input_task_id adalah model bas-relief, yang tidak dapat diperbaiki oleh endpoint ini. Pesannya adalah This model type does not support this operation. Kirim model lain.

Task input_task_id tidak ada atau milik pengguna lain. Periksa ID-nya, dan gunakan kunci API dari akun yang membuat task tersebut.

Anda melampaui batas laju Anda, atau Anda memiliki terlalu banyak task yang tertunda. Tunggu, lalu coba lagi. Lihat Batas laju.

ID tugas dari respons pembuatan.

ID tugas yang akan dihapus.

Nomor halaman yang akan dikembalikan, dimulai dari 1.

Jumlah tugas per halaman, hingga 100.

Urutan pengurutan.

Nilai yang tersedia:

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

ID tugas dari respons pembuatan.

ID tugas. Perlakukan ini sebagai string buram, dan jangan mengandalkan formatnya.

Jenis tugas, selalu print-repair.

Status tugas, salah satu dari PENDING, IN_PROGRESS, SUCCEEDED, FAILED, atau CANCELED.

Seberapa banyak tugas telah selesai, dalam persentase. Nilainya 0 sampai tugas dimulai dan 100 saat tugas berhasil.

Jumlah tugas yang berada di depan tugas ini dalam antrean. Nilai ini hanya berarti selama tugas berstatus PENDING.

Waktu tugas dibuat, dalam milidetik Unix.

Waktu tugas dimulai, dalam milidetik Unix. Nilainya 0 sampai tugas dimulai.

Waktu tugas selesai, dalam milidetik Unix. Nilainya 0 sampai tugas selesai.

Waktu hasil tugas kedaluwarsa, dalam milidetik Unix. Nilainya 0 sampai tugas selesai.

Detail kesalahan ketika tugas gagal. Nilainya null jika tugas belum gagal. Lihat Kesalahan.

URL unduhan untuk model yang telah diperbaiki. Objek ini hanya memiliki kunci yang sesuai dengan format input. Format yang tidak dihasilkan oleh tugas tidak memiliki kunci, bukan string kosong.

URL unduhan untuk gambar pratinjau model yang telah diperbaiki.

URL unduhan untuk versi thumbnail_url dengan latar belakang transparan (RGBA). Hanya ada ketika Anda membuat tugas dengan alpha_thumbnail: true dan Meshy merender pratinjau transparan tersebut.

Selalu berupa array kosong. Repair hanya mempertahankan geometri input dan tidak membuat ulang (re-bake) texture.

Jumlah kredit yang digunakan tugas. Nilainya 10 ketika tugas berstatus SUCCEEDED, dan 0 untuk tugas FAILED, karena Meshy mengembalikan kredit ketika sebuah tugas gagal.

Printer dan ukuran yang digunakan dalam perbaikan, baik Anda yang mengirimkannya maupun Meshy yang menggunakannya kembali dari tugas Analyze Printability. Ada sejak awal pada perbaikan ketebalan dinding, termasuk selama tugas berstatus PENDING. Nilai yang belum diketahui Meshy adalah null.

Apa yang dilakukan oleh perbaikan ketebalan dinding. Ada setelah perbaikan ketebalan dinding berhasil.