Flat Lay-API

De Flat Lay API van Photoroom maakt automatisch van een foto van een kledingstuk een strakke flat lay van bovenaf, klaar voor e‑commerce en marketplaces. Het is een van de meer dan 20 bewerkingen in de Photoroom API.

Ja. Met de Photoroom API stuur je een kledingfoto mee met flatLay.mode ingesteld op ai.auto en ontvang je een flatlay terug, één afbeelding per aanvraag. Je kunt aanvragen parallel uitvoeren tot aan de snelheidslimiet, standaard 60 afbeeldingen per minuut. Zo koppel je de API aan je catalogus of uploadproces en maak je automatisch een flatlay van elk nieuw kledingstuk.

Met de Photoroom API stuur je een foto van een kledingstuk en krijg je een strakke flatlay van bovenaf terug, klaar voor e‑commerce en marketplaces, zonder dat je het kledingstuk zelf hoeft te stylen, neer te leggen en te fotograferen. API-aanroepen worden parallel verwerkt, standaard 60 afbeeldingen per minuut, zodat je een hele catalogus met dezelfde API-aanroep kunt verwerken.

Voor kledingcatalogi is de Flat Lay API van Photoroom gemaakt voor grote volumes. Met één integratie zet je elke kledingfoto om in een flat lay en krijg je toegang tot meer dan 20 andere bewerkingen, zoals de achtergrond verwijderen, Ghost Mannequin en AI Ironing. Enterprise-abonnementen bieden hogere limieten voor API-aanvragen en controles van resultaten voor grote catalogi: neem contact op met sales.

Flat Lay legt het kledingstuk plat neer en toont het van bovenaf. Ghost Mannequin toont kleding zonder paspop, waarbij de pasvorm en stofval zichtbaar zijn, en Virtual Model zet kledingfoto's om in lifestylebeelden met vooraf ingestelde of aangepaste AI-modellen. Alle drie werken via dezelfde Photoroom API, dus met één integratie beschik je over alle drie.

Haal je API-sleutel op en verstuur vervolgens je kledingfoto met flatLay.mode ingesteld op 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

Elke parameter staat in de documentatie van Flat Lay.

Verstuur elke foto van een kledingstuk via dezelfde Photoroom API-aanroep met dezelfde instellingen. Dit zijn de instellingen die je kunt wijzigen:

• flatLay.mode: stel deze in op ai.auto om Flat Lay te gebruiken.

• flatLay.size: de uitvoergrootte en beeldverhouding van de gegenereerde afbeelding. De standaard is SQUARE_HD. De andere waarden zijn PORTRAIT_HD_16_9, PORTRAIT_HD_4_3, PORTRAIT_HD_3_2, LANDSCAPE_HD_3_2, LANDSCAPE_HD_4_3 en LANDSCAPE_HD_16_9.

• flatLay.prompt: een optionele tekstprompt om de stijl van de generatie te bepalen, bijvoorbeeld een strakke studio-flatlay.

Upload PNG-, JPEG-, WEBP- of AVIF-bestanden van maximaal 30 MB en 5.000 pixels aan de langste zijde en ontvang ze terug in dezelfde formaten. Flat Lay levert standaard afbeeldingen op van 1K (1024 x 1024). Uitvoer in 2K en 4K is beschikbaar met Enterprise-abonnementen. Meer informatie vind je op de documentatiepagina bestandsgrootte, resolutie en formaat.

Flat Lay is inbegrepen bij het Plus API-abonnement van $100 per maand ($0,10 per afbeelding) en bij de Enterprise-abonnementen: neem contact op met sales. Elke call kost $0,10 en kan zoveel bewerkingsopties bevatten als je nodig hebt, zonder dat dit invloed heeft op de prijs. Calls die een fout opleveren, verbruiken geen afbeelding. Je kunt de Image Editing API eerst testen in sandboxmodus, met 1.000 gratis calls per maand waarbij de afbeeldingen een watermerk krijgen. Meer informatie vind je op de prijzenpagina.

Ja. Photoroom heeft een MCP-server voor AI-assistenten zoals Claude, met ondersteuning voor Flat Lay: bekijk Photoroom MCP voor meer informatie.

Problemen met de API? Word lid van onze API-community voor hulp van onze engineers, of bekijk de pagina voor probleemoplossing voor veelvoorkomende problemen.

Voor alles wat met facturatie te maken heeft of gevoelige informatie bevat, kun je Photoroom rechtstreeks een DM sturen in de community. We helpen je graag.