Flat Lay API

Die Flat Lay API von Photoroom verwandelt ein Foto eines Kleidungsstücks automatisch in eine saubere Flat-Lay-Aufnahme aus der Draufsicht, die für den E‑Commerce und Online-Marktplätze bereit ist. Sie ist eine von mehr als 20 Bildbearbeitungen in der Photoroom API.

Ja. Mit der Photoroom API sendest du ein Kleidungsfoto mit flatLay.mode auf ai.auto gesetzt und erhältst ein Flat Lay zurück – ein Bild pro Aufruf. Aufrufe können parallel bis zum Rate-Limit ausgeführt werden, standardmäßig 60 Bilder pro Minute. So kannst du die API mit deinem Katalog oder Upload-Ablauf verbinden und jedes neue Kleidungsstück automatisch als Flat Lay darstellen lassen.

Mit der Photoroom API sendest du ein Foto eines Kleidungsstücks und erhältst ein sauberes Flat Lay aus der Draufsicht, bereit für E‑Commerce und Marktplätze – ohne das Kleidungsstück von Hand stylen, auslegen und fotografieren zu müssen. Die API-Aufrufe laufen standardmäßig parallel und verarbeiten 60 Bilder pro Minute, sodass ein ganzer Katalog in einem einzigen Aufruf verarbeitet werden kann.

Für Bekleidungskataloge ist die Flat Lay API von Photoroom auf hohe Stückzahlen ausgelegt. Eine Integration richtet jedes Kleidungsfoto als Flatlay aus und ermöglicht dir über 20 weitere Bearbeitungen, etwa das Entfernen des Hintergrunds, Ghost Mannequin und AI Ironing. Enterprise-Tarife bieten höhere API-Anfragelimits und Ausgabekontrollen für große Kataloge: Kontaktiere den Vertrieb.

Flat Lay legt das Kleidungsstück flach aus und zeigt es von oben. Ghost Mannequin zeigt Kleidung ohne sichtbare Schaufensterpuppe und bildet Passform und Fall ab. Virtual Model verwandelt Kleidungsfotos in Lifestyle-Bilder mit vordefinierten oder benutzerdefinierten KI-Modellen. Alle drei laufen über dieselbe Photoroom API, sodass eine Integration alle drei abdeckt.

Hol dir deinen API-Schlüssel und sende dann ein Foto deines Kleidungsstücks mit flatLay.mode auf ai.auto gesetzt:

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

Alle Parameter stehen in der Flat Lay-Dokumentation.

Sende jedes Foto eines Kleidungsstücks über denselben Photoroom-API-Aufruf mit denselben Einstellungen. Diese Einstellungen kannst du ändern:

• flatLay.mode: Stelle es auf ai.auto ein, um Flat Lay zu verwenden.

• flatLay.size: die Ausgabegröße und das Seitenverhältnis des generierten Bildes. Der Standardwert ist SQUARE_HD. Die anderen Werte sind PORTRAIT_HD_16_9, PORTRAIT_HD_4_3, PORTRAIT_HD_3_2, LANDSCAPE_HD_3_2, LANDSCAPE_HD_4_3 und LANDSCAPE_HD_16_9.

• flatLay.prompt: ein optionaler Text-Prompt, der den Generierungsstil vorgibt, zum Beispiel ein cleanes Flatlay im Studio.

Du kannst PNG-, JPEG-, WEBP- oder AVIF-Dateien mit bis zu 30 MB und maximal 5.000 Pixeln an der längsten Seite senden und erhältst sie in denselben Formaten zurück. Flat Lay gibt Bilder standardmäßig mit 1K (1024 x 1024) zurück. Eine Ausgabe in 2K und 4K ist in Enterprise-Tarifen verfügbar. Weitere Informationen findest du auf der Dokumentationsseite Dateigröße, Auflösung und Format.

Flat Lay ist im Plus-API-Tarif für 100 $ pro Monat (0,10 $ pro Bild) sowie in Enterprise-Tarifen enthalten: Kontaktiere den Vertrieb. Jeder Aufruf kostet 0,10 $ und kann beliebig viele Bearbeitungsoptionen enthalten, ohne dass sich der Preis ändert. Aufrufe, die einen Fehler zurückgeben, werden nicht auf die Anzahl der Bilder angerechnet. Du kannst die Image Editing API zunächst im Sandbox-Modus mit 1.000 kostenlosen Aufrufen mit Wasserzeichen pro Monat testen. Weitere Informationen findest du auf der Preisseite.

Ja. Photoroom bietet einen MCP-Server für KI-Assistenten wie Claude, der auch Flat Lay umfasst: Weitere Informationen findest du unter Photoroom MCP.

Hast du Probleme mit der API? Tritt unserer API-Community bei, um Hilfe von unseren Ingenieuren zu erhalten, oder informiere dich auf der Seite zur Fehlerbehebung über häufige Probleme.

Bei allen Themen rund um die Abrechnung oder bei sensiblen Informationen schreib Photoroom bitte direkt per DM in der Community. Wir helfen dir immer gern.