API Creative Lab Fidget Pixel

Foto yang akan diubah menjadi pixel art, 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. Meshy mendeteksi format dari data gambar, bukan dari ekstensi file pada URL. URL tanpa ekstensi tetap berfungsi, dan Meshy mengikuti pengalihan (redirect).

Apa yang ditampilkan oleh foto tersebut, yang menentukan gaya pixel-art. Kedua gaya ini terlihat jelas berbeda. Nilai lain mengembalikan 400.

Nilai yang tersedia:

• person: seorang orang, dalam foto potret atau foto seluruh tubuh. Meshy menggambar sprite pixel bergaya chibi.
• other: subjek lainnya, misalnya hewan peliharaan, objek, maskot, logo, atau pemandangan. Meshy menggambar ikon pixel bergaya bead-art.

Nama untuk tugas, maksimal 100 karakter. Nama ini akan muncul kembali di field name pada tugas. Nama yang lebih panjang mengembalikan 400.

Permintaan tidak dapat dijalankan. Contohnya:

• image_url atau type tidak ada.
• type bukan person atau other.
• Gambar bukan file JPG, JPEG, PNG, atau WebP.
• Gambar terlalu kecil, melebihi 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 menunjukkan masalah apa yang ditemukan. Perbaiki permintaan, lalu kirim ulang.

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

Salah satu dari berikut ini berlaku:

• Akun tidak memiliki kredit yang cukup.
• 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 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 Rate limits.
• Terlalu banyak tugas Anda yang sedang antre atau 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, dan mengembalikan kredit apa pun yang telah dikenakan. Coba ulangi permintaan.

ID dari tugas prototipe yang akan dibangun. Harus merupakan tugas yang dibuat oleh akun Anda dengan POST /openapi/creative-lab/fidget-pixel/v1/prototype, dengan status SUCCEEDED.

Sebuah ID yang bukan merupakan tugas prototipe Fidget Pixel Anda dari API akan mengembalikan 404, termasuk prototipe yang dibuat di aplikasi web.

Nama untuk tugas, hingga 100 karakter. Nilai ini akan muncul kembali di field name tugas. Nama yang lebih panjang mengembalikan 400.

Bentuk dasar (footprint) dari setiap bagian. Nilai lain mengembalikan 400.

Nilai yang tersedia:

• square: bagian persegi pada grid persegi
• hex: bagian heksagonal pada grid heksagonal, dengan piece_size_mm diatur ke 6 atau 8

Jumlah sel grid di sepanjang setiap sisi papan, 16 atau 32. Nilai lain mengembalikan 400. Grid 32 mempertahankan lebih banyak detail. Grid 16 menghasilkan bagian yang lebih sedikit dengan ukuran yang sama, sehingga papan menjadi sekitar setengah lebarnya.

Panjang sisi setiap bagian dalam milimeter, 6, 8, atau 10. Nilai lain mengembalikan 400. Bersama grid_size, ini menentukan ukuran papan yang dicetak. Misalnya, grid 32 dengan bagian 8 mm berukuran sekitar 26,5 cm per sisi.

10 tidak bekerja dengan hex dan mengembalikan 400, karena permukaan heksagonal yang miring akan menjorok keluar pada sebagian besar printer FDM konsumen.

Jumlah maksimum warna dalam palet pixel-art, dari 1 hingga 8. Nilai di luar rentang ini mengembalikan 400. Untuk mencetak, Anda memerlukan hingga color_count ditambah satu filamen, satu per warna dan satu untuk badan abu-abu.

Tinggi setiap bagian dalam milimeter, dari 10 hingga 80. Nilai di luar rentang ini mengembalikan 400.

Format file dari hasil. Nilai lain mengembalikan 400.

Nilai yang tersedia:

• 3mf: satu file model.3mf multi-warna, dikembalikan di model_urls.3mf

Permintaan tidak dapat dijalankan. Misalnya:

• input_task_id hilang atau bukan ID tugas yang valid.
• Status tugas prototipe bukan SUCCEEDED. Jika masih berjalan, tunggu dan coba lagi. Jika gagal atau dibatalkan, buat tugas prototipe baru.
• Tugas prototipe berhasil tetapi tidak memiliki gambar. Buat tugas prototipe baru.
• Sebuah field options berada di luar nilai yang diizinkan, misalnya grid_size selain 16 atau 32.
• piece_size_mm adalah 10 dan shape adalah hex. Bagian heksagonal hanya tersedia dalam ukuran 6 dan 8 mm.
• output.format bukan 3mf.

Pesan error akan menunjukkan masalah apa yang ditemukan.

Kunci API hilang atau tidak valid. Periksa header Authorization.

Salah satu dari ini berlaku:

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

Periksa kredit dan paket Anda, lalu coba lagi.

Tim Anda mengaktifkan IP Filtering, dan Meshy menandai gambar tugas prototipe tersebut karena hak kekayaan intelektual pihak ketiga. Buat tugas prototipe dari gambar yang memang berhak Anda gunakan.

input_task_id tidak cocok dengan tugas prototipe Fidget Pixel mana pun yang dibuat akun Anda melalui API. Prototipe yang dibuat di aplikasi web juga akan mengembalikan 404. Kirimkan ID result dari respons pembuatan prototipe.

Salah satu batas ini tercapai:

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

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

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 prototype tersebut karena melanggar kekayaan intelektual pihak ketiga. Task build dan tim pada paket Enterprise tidak mendapatkan error ini. Buat task prototype dari gambar yang hak penggunaannya Anda miliki.

Tidak ada task Fidget Pixel dengan ID ini yang dimiliki akun Anda, atau tahap task tidak sesuai dengan path. Periksa ID, dan gunakan /prototype atau /build yang sesuai dengan task tersebut.

Meshy tidak dapat menjalankan pemeriksaan kekayaan intelektual. Coba lagi permintaan tersebut.

ID tugas yang akan dibatalkan.

Salah satu dari hal berikut berlaku:

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

Tidak ada tugas Fidget Pixel dengan ID ini yang dimiliki akun Anda, atau tahap tugas tidak sesuai dengan path. Periksa ID, dan gunakan /prototype atau /build yang sesuai dengan tugas tersebut.

ID tugas dari respons pembuatan.

Tahap yang akan didaftar, prototype atau build.

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 tugas. Jangan bergantung pada formatnya.

Jenis tugas, selalu creative-lab-fidget-pixel-prototype.

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

Status tugas.

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 telah selesai, dari 0 hingga 100. Nilainya 0 sampai tugas dimulai dan 100 saat berhasil.

Waktu tugas dibuat, dalam milidetik Unix.

Waktu sebuah worker memulai tugas, dalam milidetik Unix. null sampai saat itu.

Waktu tugas mencapai status final, dalam milidetik Unix. null sampai saat itu.

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

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

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

Jumlah kredit yang dikenakan untuk tugas ini, setelah pengembalian dana (jika ada). Permintaan yang mengembalikan kesalahan tidak dikenakan biaya. Tugas yang gagal bernilai 0, karena Meshy mengembalikan dananya. Membatalkan tugas hanya mengembalikan dana selama tugas masih PENDING. Jika Meshy tidak dapat membaca biaya yang dikenakan, respons get atau stream akan menghilangkan field ini, dan permintaan daftar akan mengembalikan 500. Dalam kasus tersebut, coba lagi permintaannya.

URL unduhan untuk gambar pixel-art. Array ini memiliki satu URL setelah tugas berhasil, dan kosong sebelum itu.

URL tersebut ditandatangani (signed), jadi ambillah tanpa header Authorization. URL tetap berlaku hingga expires_at. Mengambil tugas tersebut lagi sebelum waktu itu akan mengembalikan URL yang sama, bukan yang baru ditandatangani. URL yang kedaluwarsa tidak dapat diperbarui, jadi unduh dan simpan berkasnya sebelum waktu itu.

ID tugas. Jangan bergantung pada formatnya.

Jenis tugas, selalu creative-lab-fidget-pixel-build.

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

Status tugas.

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 telah selesai, dari 0 hingga 100. Nilainya 0 sampai tugas dimulai dan 100 saat berhasil.

Waktu tugas dibuat, dalam milidetik Unix.

Waktu seorang pekerja memulai tugas, dalam milidetik Unix. null sampai saat itu.

Waktu tugas mencapai status final, dalam milidetik Unix. null sampai saat itu.

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

Posisi tugas dalam antrean selama statusnya PENDING. 1 berarti tugas ini akan dimulai berikutnya. 0 setelah tugas keluar dari antrean, dan selalu 0 pada hasil daftar.

Alasan kegagalan tugas. null kecuali status adalah FAILED. Lihat Kesalahan.

Jumlah kredit yang dikenakan untuk tugas, setelah pengembalian dana (jika ada). Permintaan yang mengembalikan kesalahan tidak dikenakan biaya. Tugas yang gagal bernilai 0, karena Meshy mengembalikan dananya. Membatalkan tugas hanya mengembalikan dana selama statusnya PENDING. Jika Meshy tidak dapat membaca biaya yang dikenakan, respons get atau stream akan menghilangkan field ini, dan permintaan daftar akan mengembalikan 500. Dalam kasus ini, coba ulangi permintaan tersebut.

URL unduhan untuk hasil, dikelompokkan berdasarkan format file. Objek ini memiliki satu entri, untuk output.format yang Anda kirim, dan kosong sampai tugas berhasil.

URL-nya ditandatangani, jadi ambil tanpa header Authorization. URL ini tetap berlaku hingga expires_at. Mengambil tugas lagi sebelum itu akan mengembalikan URL yang sama, bukan yang baru ditandatangani. URL yang sudah kedaluwarsa tidak dapat diperbarui, jadi unduh dan simpan file-file tersebut sebelum itu terjadi.