API Figur Bata Creative Lab

Foto yang akan diubah menjadi minifigure brick, 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 maksimum 20 MB.

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

Menentukan apakah latar belakang dihapus dari gambar prototype. 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, Meshy mengembalikan gambar beserta latar belakangnya, dan task tetap berhasil.

Permintaan tidak dapat dijalankan. Misalnya:

• 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 time out.
• Data URI bukan base64 yang valid.
• Gambar ditandai sebagai NSFW.

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

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

Salah satu dari berikut ini 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 kekayaan intelektual pihak ketiga. Kirim gambar yang hak penggunaannya Anda miliki.

Salah satu batas berikut tercapai:

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

Meshy mengalami error server, misalnya karena tidak dapat menjalankan pemeriksaan kekayaan intelektual pada gambar. Meshy tidak membuat task, dan mengembalikan kredit apa pun yang telah dikenakan. Coba lagi permintaan tersebut.

ID dari task prototype yang akan di-build. ID ini harus merupakan task yang dibuat oleh akun Anda dengan POST /openapi/creative-lab/brick-figure/v1/prototype, dengan status SUCCEEDED.

ID yang bukan merupakan salah satu task prototype Brick 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 field name pada task. Nama yang lebih panjang akan mengembalikan 400.

Permintaan tidak dapat dijalankan. Contohnya:

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

Pesan error akan menyebutkan 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 member telah mencapai batas kreditnya.
• Akun menggunakan paket gratis.

Periksa kredit dan paket Anda, lalu coba lagi.

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

ID tugas dari respons pembuatan.

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

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

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

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

ID tugas yang akan dibatalkan.

Salah satu dari berikut berlaku:

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

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

ID tugas dari respons pembuatan.

Tahap yang akan dicantumkan, 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 task. Jangan bergantung pada formatnya.

Tipe task, selalu creative-lab-brick-figure-prototype.

name yang Anda kirimkan 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 ketika berhasil.

Waktu task dibuat, dalam milidetik Unix.

Waktu worker mulai menjalankan 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 selama statusnya PENDING. 1 berarti task akan dijalankan berikutnya. 0 setelah task keluar dari antrean, dan selalu 0 dalam hasil daftar.

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

Jumlah kredit yang dikenakan untuk task, setelah dikurangi pengembalian dana jika ada. Permintaan yang mengembalikan kesalahan tidak dikenakan biaya. Task yang gagal bernilai 0, karena Meshy mengembalikan kreditnya. Membatalkan task hanya mengembalikan kredit selama task masih PENDING. Jika Meshy tidak dapat membaca biaya yang dikenakan, respons get atau stream akan mengabaikan field ini, dan permintaan daftar akan mengembalikan 500. Dalam kasus ini, coba ulangi permintaan.

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

ID tugas. Jangan bergantung pada formatnya.

Jenis tugas, selalu creative-lab-brick-figure-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 selesai, dari 0 hingga 100. Nilainya 0 sampai tugas dimulai dan 100 ketika berhasil.

Waktu tugas dibuat, dalam milidetik Unix.

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

Waktu tugas mencapai status final, dalam milidetik Unix. null sebelum 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 berstatus PENDING. 1 berarti tugas ini akan dimulai berikutnya. 0 setelah tugas keluar dari antrean, dan selalu 0 dalam hasil daftar (list).

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 list akan mengembalikan 500. Dalam kasus ini, coba ulangi permintaan.

Selalu "" untuk tugas build Brick Figure.

Selalu "" untuk tugas build Brick Figure, seperti prompt.

Selalu "" untuk tugas build Brick Figure, seperti prompt.

Selalu "" untuk tugas build Brick Figure, 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 base color.