Flat Lay API

L’API Flat Lay di Photoroom trasforma automaticamente la foto di un capo d’abbigliamento in una foto flat lay pulita, vista dall’alto e pronta per l’e‑commerce e i marketplace. È una delle oltre 20 modifiche disponibili nell’API di Photoroom.

Sì. Con l’API di Photoroom, invii una foto di un capo d’abbigliamento con flatLay.mode impostato su ai.auto e ricevi un’immagine flat lay, una per chiamata. Le chiamate possono essere eseguite in parallelo fino al limite di richieste, che per impostazione predefinita è di 60 immagini al minuto. Puoi quindi collegare l’API al tuo catalogo o al flusso di caricamento e ottenere automaticamente una foto flat lay di ogni nuovo capo.

Con l’API di Photoroom invii la foto di un capo d’abbigliamento e ricevi un’immagine flat lay pulita, ripresa dall’alto e pronta per l’e‑commerce e i marketplace, senza dover preparare, disporre e fotografare il capo a mano. Le chiamate vengono eseguite in parallelo: 60 immagini al minuto per impostazione predefinita, così puoi elaborare un intero catalogo con la stessa chiamata.

Per i cataloghi di abbigliamento, l’API Flat Lay di Photoroom è progettata per gestire grandi volumi. Con una sola integrazione puoi trasformare ogni foto di abbigliamento in uno scatto flat lay e applicare oltre 20 altre modifiche, come la rimozione dello sfondo, Manichino invisibile e Stiratura IA. I piani Enterprise offrono limiti di richieste più elevati e controlli sui risultati per i cataloghi di grandi dimensioni: contatta il team commerciale.

Flat Lay dispone il capo in piano e lo mostra dall’alto. Ghost Mannequin mostra i capi senza manichino, mettendone in risalto vestibilità e caduta, mentre Virtual Model trasforma le foto dei capi in immagini lifestyle con modelli IA predefiniti o personalizzati. Tutte e tre le soluzioni usano la stessa API di Photoroom, quindi basta una sola integrazione.

Ottieni la tua chiave API, poi invia la foto del tuo capo d’abbigliamento con flatLay.mode impostato su 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

Ogni parametro è presente nella documentazione di Flat Lay.

Invia ogni foto di un capo d’abbigliamento tramite la stessa chiamata API di Photoroom, con le stesse impostazioni. Ecco quali impostazioni puoi modificare:

• flatLay.mode: impostalo su ai.auto per usare Flat Lay.

• flatLay.size: la dimensione di output e il rapporto d’aspetto dell’immagine generata. Il valore predefinito è SQUARE_HD. Gli altri valori sono PORTRAIT_HD_16_9, PORTRAIT_HD_4_3, PORTRAIT_HD_3_2, LANDSCAPE_HD_3_2, LANDSCAPE_HD_4_3 e LANDSCAPE_HD_16_9.

• flatLay.prompt: un prompt di testo facoltativo per guidare lo stile della generazione, ad esempio una composizione flat lay pulita in studio.

Invia file PNG, JPEG, WEBP o AVIF fino a 30 MB e con un massimo di 5.000 pixel sul lato più lungo, e ricevi immagini negli stessi formati. Flat Lay restituisce immagini in 1K (1024 x 1024) per impostazione predefinita; l’output in 2K e 4K è disponibile con i piani Enterprise. Trovi i dettagli nella pagina della documentazione dimensioni, risoluzione e formato dei file.

Flat Lay è incluso nel piano Plus API, a 100 $ al mese (0,10 $ per immagine), e nei piani Enterprise: parla con il team vendite. Ogni chiamata costa 0,10 $ e può includere tutte le opzioni di modifica che ti servono, senza incidere sul prezzo; le chiamate che restituiscono un errore non consumano un’immagine. Puoi provare prima l’API di modifica delle immagini in modalità sandbox, con 1.000 chiamate gratuite al mese con filigrana. Trovi tutti i dettagli nella pagina dei prezzi.

Sì. Photoroom offre un server MCP per assistenti IA come Claude, che supporta anche Flat Lay: scopri di più su Photoroom MCP.

Hai problemi con l’API? Unisciti alla nostra community dedicata all’API per ricevere aiuto dai nostri ingegneri oppure consulta la pagina di risoluzione dei problemi per trovare soluzioni ai problemi più comuni.

Per questioni di fatturazione o per condividere informazioni sensibili, scrivi direttamente a Photoroom in privato nella community. Saremo sempre felici di aiutarti.