Creative Lab Fridge Magnet API

Foto yang akan diubah menjadi gambar konsep magnet kulkas, 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 task, hingga 100 karakter. Nama ini dikembalikan pada field name milik task. Nama yang lebih panjang akan mengembalikan 400.

Apakah akan menghapus latar belakang dari gambar prototipe. true mengembalikan PNG RGBA transparan yang tetap mempertahankan seluruh bentuk magnet, sehingga Anda dapat menempatkannya 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 task tetap berhasil.

Opsi remove_background pada build bersifat terpisah.

Permintaan tidak dapat dijalankan. Misalnya:

• image_url tidak ada.
• 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 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 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 kekayaan intelektual pihak ketiga. Kirimkan gambar yang Anda memiliki hak untuk menggunakannya.

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 antre atau berjalan. Tunggu hingga beberapa selesai, lalu coba lagi.
• Pada paket tak terbatas 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 tersebut, dan mengembalikan kredit yang telah dibebankan. Coba lagi permintaan tersebut.

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

ID yang bukan merupakan salah satu task prototype magnet kulkas 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.

Garis luar magnet ketika Meshy tidak melacaknya dari subjek. Meshy menggunakan ini ketika remove_background bernilai false, atau ketika Meshy tidak dapat menemukan garis luar subjek.

Nilai yang tersedia:

• circle
• rounded-rect
• hexagon
• shield
• star

Panjang sisi dari kotak pembatas magnet, dalam milimeter, hingga 400. 0 menggunakan nilai default.

Ketinggian maksimum relief di atas dasar, dalam milimeter, dari 0 hingga 20.

Seberapa jauh menurunkan relief, dalam milimeter, dari 0 hingga 20. Meshy mengurangkan nilai ini dari ketinggian relief di semua bagian, hingga ke dasar.

Ketebalan pelat dasar datar di belakang relief, dalam milimeter, dari 0 hingga 20. Dasar default 2 mm memberi magnet cukup badan untuk menempel pada kulkas, sehingga relief tidak terasa rapuh.

Apakah akan menutup bagian belakang magnet, sisi tempat Anda merekatkan magnet. false membiarkan bagian belakang terbuka, seperti cangkang.

Kurva yang memetakan nilai peta kedalaman ke ketinggian relief.

Nilai yang tersedia:

• linear
• gamma
• s-curve

Kekuatan kurva, hingga 10. Kurva gamma dan s-curve menggunakannya, sedangkan linear mengabaikannya. 0 menggunakan nilai default.

Apakah akan membalik peta kedalaman, sehingga area yang lebih gelap menjadi relief yang lebih tinggi.

Seberapa besar penghalusan peta kedalaman sebelum Meshy membangun relief, dari 0 hingga 10.

Seberapa besar zoom pada relief dan teksturnya di dalam garis luar, dari titik pusat, hingga 10. Nilai di atas 1 memperbesar subjek, dan nilai di bawah 1 memperkecilnya. Ini tidak mengubah ketinggian relief. 0 menggunakan nilai default.

Nilai peta kedalaman yang di bawahnya Meshy menetapkan kedalaman menjadi nol, dari 0 hingga 1.

Apakah akan melacak garis luar magnet dari subjek, sehingga magnet mengikuti bentuk subjek. false menggunakan garis luar badge_shape sebagai gantinya. Meshy juga menggunakan badge_shape ketika tidak dapat menemukan garis luar subjek.

Ini terpisah dari parameter remove_background pada prototype, yang menentukan apakah gambar prototype memiliki latar belakang transparan.

Resolusi mesh dari model yang diekspor, dari 64 hingga 512. Meshy membangun geometri dari peta kedalaman 512 piksel, sehingga mesh yang lebih halus akan menambah faces tanpa menambah detail. 0 menggunakan nilai default.

Format file yang dikembalikan oleh build.

Nilai yang tersedia:

• glb: satu file model.glb, di model_urls.glb
• obj: file zip berisi model.obj, model.mtl, dan texture.png, di model_urls.obj
• zip: file zip berisi setiap file yang dihasilkan Meshy, di model_urls.bundle_zip

Permintaan tidak dapat dijalankan. Contohnya:

• input_task_id hilang atau bukan ID task yang valid.
• Status task prototype bukan SUCCEEDED. Jika masih berjalan, tunggu lalu coba lagi. Jika gagal atau dibatalkan, buat task prototype baru.
• Task prototype berhasil tetapi tidak memiliki gambar. Buat task prototype baru.
• Sebuah kolom options berada di luar rentangnya atau bukan nilai yang tersedia.

Pesan error menunjukkan masalah yang ditemukan.

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.

input_task_id tidak cocok dengan task prototype magnet kulkas mana pun yang dibuat 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 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 berada dalam antrean atau sedang berjalan. Tunggu hingga beberapa selesai, lalu coba lagi.
• Pada paket tak terbatas 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 pada tugas prototype karena hak kekayaan intelektual pihak ketiga. Tugas build dan tim pada paket Enterprise tidak mendapatkan error ini. Buat tugas prototype dari gambar yang Anda miliki haknya untuk digunakan.

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

Meshy tidak dapat menjalankan pemeriksaan hak 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 (create).
• Task sudah memiliki status akhir (SUCCEEDED, FAILED, atau CANCELED), sehingga tidak dapat dibatalkan.

Tidak ada task magnet kulkas dengan ID ini yang dimiliki oleh akun Anda, atau tahap task tidak cocok 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 sampai 255. 0 mengembalikan halaman pertama. Nilai di luar 0 sampai 255 akan mengembalikan 400.

Jumlah tugas per halaman, hingga 100. Nilai dari 101 sampai 255 akan mengembalikan 100 tugas, dan 0 menggunakan nilai default. Nilai di luar 0 sampai 255 akan 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-fridge-magnet-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 pada task_error
• CANCELED: final, tanpa hasil

Persentase pekerjaan yang 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 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 Asset retention.

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

Alasan tugas gagal. 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 kreditnya. Membatalkan tugas hanya mengembalikan kredit 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 ini, coba ulangi permintaan.

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

ID task. Jangan bergantung pada formatnya.

Tipe task, selalu creative-lab-fridge-magnet-build.

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

Status task tersebut.

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 ketika berhasil.

Waktu task dibuat, dalam milidetik Unix.

Waktu 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 selagi berstatus PENDING. 1 berarti task akan dimulai berikutnya. 0 setelah task keluar dari antrean, dan selalu 0 dalam hasil daftar (list).

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

Jumlah kredit yang dikenakan untuk task tersebut, setelah pengembalian dana (refund) jika ada. Permintaan yang mengembalikan error tidak dikenakan biaya. Task yang gagal bernilai 0, karena Meshy mengembalikan kreditnya. Membatalkan task hanya mengembalikan kredit selagi task berstatus 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 tersebut.

URL unduhan untuk file model, dengan satu entri untuk output.format yang Anda minta. {} sampai task berhasil.