API Creative Lab Collapsible Fidget

Foto yang akan diubah menjadi collapsible fidget, berupa URL publik atau data URI (data:image/jpeg;base64,<data gambar Anda yang dienkode base64>).

Gambar harus berupa file JPG, JPEG, PNG, atau WebP dengan ukuran maksimal 20 MB.

Siluet subjek akan menjadi cincin-cincinnya, sehingga subjek dengan satu garis luar yang jelas dan tertutup bekerja paling baik. Latar belakang yang ramai, beberapa subjek terpisah, atau bentuk yang sangat tipis dapat menyisakan terlalu sedikit area untuk dinding-dinding bersarang. Dalam kasus itu, tugas akan gagal.

Nama untuk tugas, hingga 100 karakter. Nama ini akan muncul kembali pada kolom name milik tugas, dan Meshy tidak mengukirnya pada model. Nama yang lebih panjang akan mengembalikan 400.

Permintaan tidak dapat dijalankan. Contohnya:

• image_url tidak ada.
• Gambar bukan file JPG, JPEG, PNG, atau WebP.
• Gambar terlalu kecil, lebih dari 20 MB, atau melebihi jumlah piksel maksimum.
• Meshy tidak dapat mengunduh gambar, misalnya karena URL mengembalikan 404 atau waktu habis (timeout).
• Data URI bukan base64 yang valid.
• Gambar ditandai sebagai NSFW.

Pesan error akan menyebutkan masalah apa yang ditemukan. Perbaiki permintaan, lalu kirim ulang.

Kunci API tidak ada atau tidak valid. Periksa header Authorization.

Salah satu dari hal berikut berlaku:

• Akun tidak memiliki cukup kredit.
• Kunci API, ruang kerja, atau anggota telah mencapai batas kreditnya.
• Akun menggunakan paket gratis.

Periksa kredit dan paket Anda, lalu coba lagi.

Tim Anda mengaktifkan IP Filtering, dan Meshy menandai gambar tersebut terkait hak kekayaan intelektual pihak ketiga. Kirim gambar yang hak penggunaannya Anda miliki.

Salah satu batas berikut telah tercapai:

• Anda mengirim lebih banyak permintaan daripada yang diizinkan oleh batas laju Anda. Tunggu beberapa detik, lalu coba lagi. Lihat Batas laju.
• Terlalu banyak tugas Anda yang antre atau sedang berjalan. Tunggu hingga beberapa selesai, lalu coba lagi.
• Pada paket tak terbatas tanpa sisa kredit, Anda telah mencapai jumlah tugas yang dapat berjalan tanpa kredit. Tunggu hingga sebuah tugas selesai, atau tambahkan kredit.

Meshy mengalami kesalahan server, misalnya karena tidak dapat menjalankan pemeriksaan kekayaan intelektual pada gambar. Meshy tidak membuat tugas tersebut, dan mengembalikan kredit apa pun yang telah dikenakan. Coba kirim ulang permintaan.

ID task dari respons pembuatan.

id bukan ID task yang valid. Kirim ID result dari respons pembuatan.

Tim Anda mengaktifkan IP Filtering, dan Meshy menandai gambar task tersebut karena kekayaan intelektual pihak ketiga. Tim pada paket Enterprise tidak mendapatkan error ini. Buat task dari gambar yang hak penggunaannya Anda miliki.

Tidak ada task Collapsible Fidget dengan ID ini yang dimiliki akun Anda, atau task tersebut tidak dibuat dengan endpoint ini. Periksa ID-nya.

Meshy tidak dapat menjalankan pemeriksaan kekayaan intelektual. Coba lagi permintaannya.

ID dari task yang akan dibatalkan.

Salah satu dari kondisi berikut berlaku:

• id bukan ID task yang valid. Kirimkan ID result dari respons pembuatan task.
• Task sudah memiliki status akhir (SUCCEEDED, FAILED, atau CANCELED), sehingga tidak dapat dibatalkan.

Tidak ada task Collapsible Fidget dengan ID ini yang dimiliki akun Anda, atau task tersebut tidak dibuat dengan endpoint ini. Periksa kembali ID tersebut.

ID tugas dari respons pembuatan.

Halaman yang akan dikembalikan, dari 1 hingga 255. 0 mengembalikan halaman pertama. Nilai di luar 0 hingga 255 mengembalikan 400.

Jumlah tugas per halaman, hingga 100. Nilai dari 101 hingga 255 mengembalikan 100 tugas, dan 0 menggunakan nilai default. Nilai di luar 0 hingga 255 mengembalikan 400.

Urutan pengurutan.

Nilai yang tersedia:

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

ID task. Jangan bergantung pada formatnya.

Jenis task, selalu creative-lab-fidget-collapsible.

name yang Anda kirim saat membuat task, atau "" jika Anda tidak mengirimkannya.

Status task.

Nilai yang tersedia:

• PENDING: menunggu dalam antrean
• IN_PROGRESS: sedang menghasilkan hasil
• SUCCEEDED: final, dengan hasil
• FAILED: final, dengan alasan di task_error
• CANCELED: final, tanpa hasil

Persentase pekerjaan yang selesai, dari 0 hingga 100. Nilainya 0 sampai task dimulai dan 100 saat berhasil.

Waktu task dibuat, dalam milidetik Unix.

Waktu worker mulai mengerjakan task, dalam milidetik Unix. null sebelum itu.

Waktu task mencapai status final, dalam milidetik Unix. null sebelum itu.

Waktu hasil task kedaluwarsa, dalam milidetik Unix. Nilainya 3 hari setelah finished_at, atau 3 hari setelah created_at sampai task selesai. Untuk akun Enterprise, yang menyimpan hasil API tanpa batas waktu, nilainya sekitar 100 tahun kemudian. Lihat Retensi aset.

Posisi task dalam antrean selama berstatus PENDING. 1 berarti task ini akan dimulai berikutnya. 0 setelah task keluar dari antrean, dan selalu 0 dalam hasil daftar (list).

Alasan task gagal. null kecuali status adalah FAILED. Lihat Kesalahan.

Jumlah kredit yang dikenakan untuk task, setelah pengembalian dana (jika ada). Permintaan yang mengembalikan error tidak dikenakan biaya. Task yang gagal bernilai 0, karena Meshy mengembalikan kreditnya. Membatalkan hanya mengembalikan kredit task selama statusnya masih PENDING. Jika Meshy tidak dapat membaca biaya yang dikenakan, respons get atau stream akan tidak menyertakan field ini, dan permintaan list akan mengembalikan 500. Dalam kasus tersebut, coba ulangi permintaannya.

URL unduhan untuk model 3D, kosong sampai task berhasil. Task yang berhasil selalu memiliki stl, dan hanya memiliki glb jika Meshy merender pratinjaunya.