API Figur Vinil Creative Lab

Foto yang akan diubah menjadi vinyl figure berkepala besar, 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 berukuran maksimal 20 MB.

Nama untuk tugas, hingga 100 karakter. Nama ini dikembalikan pada field name tugas. Nama yang lebih panjang akan mengembalikan 400.

Apakah akan menghapus latar belakang dari gambar prototipe. true mengembalikan PNG RGBA transparan, sehingga Anda dapat menempatkan subjek pada latar belakang apa pun. Proses build juga dimulai dari gambar tanpa latar belakangnya. Jika Meshy tidak dapat menghapus latar belakang, gambar akan dikembalikan beserta latar belakangnya, dan tugas tetap berhasil.

Permintaan tidak dapat dijalankan. Misalnya:

• image_url hilang.
• 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 menunjukkan masalah apa yang ditemukan. Perbaiki permintaan, lalu kirim ulang.

Kunci API hilang 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 berada pada paket gratis.

Periksa kredit dan paket Anda, lalu coba lagi.

Tim Anda mengaktifkan IP Filtering, dan Meshy menandai gambar tersebut karena kekayaan intelektual pihak ketiga. Kirim gambar yang Anda memiliki hak untuk menggunakannya.

Salah satu batas berikut 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 berada dalam antrean 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 dibebankan. Coba kirim ulang permintaan.

ID dari prototype task yang akan dibuild. ID ini harus berupa task yang dibuat oleh akun Anda dengan POST /openapi/creative-lab/vinyl-figure/v1/prototype, dengan status SUCCEEDED.

ID yang bukan merupakan salah satu prototype task Vinyl Figure Anda dari API akan mengembalikan 404, termasuk prototype yang dibuat di aplikasi web.

Nama untuk task, hingga 100 karakter. Nama ini akan muncul kembali di kolom name pada task. Nama yang lebih panjang akan mengembalikan 400.

Permintaan tidak dapat dijalankan. Misalnya:

• input_task_id tidak ada atau bukan ID task yang valid.
• Status prototype task bukan SUCCEEDED. Jika masih berjalan, tunggu dan coba lagi. Jika gagal atau dibatalkan, buat prototype task baru.
• Prototype task berhasil tetapi tidak memiliki gambar. Buat prototype task baru.

Pesan error akan menunjukkan masalah apa yang ditemukan.

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.

input_task_id tidak cocok dengan prototype task Vinyl Figure mana pun yang dibuat oleh akun Anda melalui API. Prototype yang dibuat di aplikasi web juga akan mengembalikan 404. Kirimkan ID result dari respons pembuatan prototype.

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 task Anda yang sedang dalam antrean atau berjalan. Tunggu hingga beberapa selesai, lalu coba lagi.
• Pada paket tanpa batas dengan sisa kredit habis, Anda telah mencapai jumlah task yang dapat berjalan tanpa kredit. Tunggu hingga sebuah task selesai, atau tambahkan kredit.

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

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

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

ID task yang akan dibatalkan.

Salah satu dari berikut ini berlaku:

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

Tidak ada task Vinyl Figure 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.

ID tugas dari respons pembuatan.

Tahap yang akan ditampilkan, prototype atau build.

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

Jumlah tugas per halaman, hingga 100. Nilai dari 101 hingga 255 akan mengembalikan 100 tugas, dan 0 menggunakan nilai default. Nilai di luar 0 hingga 255 akan 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-vinyl-figure-prototype.

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

Waktu task dibuat, dalam milidetik Unix.

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

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

Waktu kedaluwarsa hasil task, 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 akan dimulai berikutnya. 0 setelah task keluar dari antrean, dan selalu 0 pada hasil daftar.

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

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

URL unduhan untuk gambar konsep. Array ini berisi satu URL setelah task berhasil, dan kosong sebelum itu.

ID task. Jangan bergantung pada formatnya.

Jenis task, selalu creative-lab-vinyl-figure-build.

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 hingga task dimulai dan 100 saat berhasil.

Waktu task dibuat, dalam milidetik Unix.

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

Waktu task mencapai status final, dalam milidetik Unix. null sampai saat 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 saat statusnya PENDING. 1 berarti task 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 (refund) apa pun. Permintaan yang mengembalikan kesalahan tidak dikenakan biaya. Task yang gagal bernilai 0, karena Meshy mengembalikan dananya. Membatalkan hanya mengembalikan dana task selama statusnya masih PENDING. Jika Meshy tidak dapat membaca biaya yang dikenakan, respons get atau stream akan menghilangkan bidang ini, dan permintaan list akan mengembalikan 500. Dalam kasus ini, coba lagi permintaan tersebut.

Selalu "" untuk Vinyl Figure build task.

Selalu "" untuk Vinyl Figure build task, seperti prompt.

Selalu "" untuk Vinyl Figure build task, seperti prompt.

Selalu "" untuk Vinyl Figure build task, seperti prompt.

URL unduhan untuk model 3D, sebagai GLB bertekstur dan sebagai file OBJ dengan file MTL-nya.

URL unduhan untuk gambar pratinjau model.

Peta tekstur, sebagai array dengan satu objek yang menyimpan peta warna dasar (base color).