Flat Lay API

API Flat Lay Photoroom secara otomatis mengubah foto pakaian menjadi foto flat lay tampak atas yang rapi, siap digunakan di e‑commerce dan marketplace. Ini adalah salah satu dari lebih dari 20 jenis pengeditan di API Photoroom.

Ya. Dengan API Photoroom, kamu mengirim foto pakaian dengan flatLay.mode disetel ke ai.auto, lalu menerima hasil flat lay, satu gambar untuk setiap panggilan. Panggilan dapat dijalankan secara paralel hingga batas laju, yaitu 60 gambar per menit secara default. Jadi, kamu bisa menghubungkannya ke katalog atau alur unggah dan otomatis menghasilkan foto flat lay untuk setiap pakaian baru.

Dengan API Photoroom, kamu mengirim foto pakaian dan mendapatkan foto flat lay dari atas yang rapi, siap digunakan di e‑commerce dan marketplace, tanpa perlu menata, membentangkan, dan memotretnya secara manual. Permintaan API diproses secara paralel, dengan kecepatan default 60 gambar per menit, sehingga seluruh katalog bisa diproses dalam satu panggilan yang sama.

Untuk katalog pakaian, Flat Lay API Photoroom dirancang untuk memproses banyak gambar. Dengan satu integrasi, setiap foto pakaian ditampilkan dalam gaya flat lay dan kamu mendapat lebih dari 20 edit lainnya, seperti penghapusan latar belakang, Manekin Hantu dan Setrika AI. Paket Enterprise menawarkan batas permintaan yang lebih tinggi dan pemeriksaan hasil untuk katalog besar: hubungi tim penjualan.

Flat Lay menata pakaian secara rata dan menampilkannya dari atas. Ghost Mannequin menampilkan pakaian tanpa manekin, sehingga potongan dan jatuhnya kain terlihat. Sementara itu, Virtual Model mengubah foto pakaian menjadi gambar bergaya lifestyle dengan model AI yang telah ditentukan atau model AI kustom. Ketiganya menggunakan Photoroom API yang sama, jadi satu integrasi mencakup semuanya.

Dapatkan kunci API, lalu kirim foto pakaianmu dengan flatLay.mode disetel ke ai.auto:

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header 'x-api-key: YOUR_API_KEY_HERE' \
  --form imageFile=@/path/to/image.png \
  --form flatLay.mode=ai.auto \
  --output result.png

Setiap parameter tercantum dalam dokumentasi Flat Lay.

Kirim setiap foto pakaian melalui panggilan API Photoroom yang sama dengan pengaturan yang sama. Berikut pengaturan yang bisa kamu ubah:

• flatLay.mode: atur ke ai.auto untuk menggunakan Flat Lay.

• flatLay.size: ukuran output dan rasio aspek gambar yang dihasilkan. Nilai default-nya adalah SQUARE_HD. Nilai lainnya adalah PORTRAIT_HD_16_9, PORTRAIT_HD_4_3, PORTRAIT_HD_3_2, LANDSCAPE_HD_3_2, LANDSCAPE_HD_4_3, dan LANDSCAPE_HD_16_9.

• flatLay.prompt: perintah teks opsional untuk memandu gaya pembuatan, misalnya flat lay studio yang bersih.

Kirim file PNG, JPEG, WEBP, atau AVIF hingga 30 MB dan 5.000 piksel pada sisi terpanjangnya, lalu dapatkan hasil dalam format yang sama. Flat Lay menghasilkan gambar berukuran 1K (1024 x 1024) secara default, sedangkan output 2K dan 4K tersedia untuk paket Enterprise. Detailnya ada di halaman dokumentasi ukuran file, resolusi, dan format.

Flat Lay termasuk dalam paket Plus API dengan biaya $100 per bulan ($0,10 per gambar), dan juga tersedia dalam paket Enterprise: hubungi tim penjualan. Setiap panggilan dikenai biaya $0,10 dan dapat mencakup opsi pengeditan sebanyak yang kamu perlukan tanpa memengaruhi harga. Panggilan yang menghasilkan error tidak mengurangi jatah gambar. Kamu bisa mencoba Image Editing API terlebih dahulu dalam mode sandbox, dengan 1.000 panggilan gratis per bulan yang menghasilkan gambar bertanda air. Detailnya ada di halaman harga.

Ya. Photoroom menyediakan server MCP untuk asisten AI seperti Claude, termasuk untuk Flat Lay: lihat Photoroom MCP untuk info selengkapnya.

Ada kendala saat menggunakan API? Bergabunglah dengan komunitas API kami untuk mendapatkan bantuan dari tim engineer kami, atau lihat halaman pemecahan masalah untuk menemukan solusi atas masalah umum.

Untuk hal terkait penagihan atau informasi sensitif, silakan kirim DM langsung ke Photoroom di komunitas. Kami selalu siap membantu.