API di editing delle immagini con IA

L'API di editing delle immagini modifica le foto dei prodotti con l'IA in un'unica richiesta. Invia un'immagine e indica le modifiche che vuoi applicare: rimozione dello sfondo, Sfondi IA, ombre, modifica dell'illuminazione, ridimensionamento e molto altro. Ricevi subito l'immagine modificata. È pensata per i team e‑commerce, che possono modificare qualsiasi quantità di immagini, da una sola foto a un intero catalogo.

Sì. Con una sola chiamata puoi rimuovere lo sfondo, aggiungere un’ombra generata dall’IA, impostare il padding, ridimensionare ed esportare nel formato che ti serve. Imposti ogni modifica come parametro, così la stessa chiamata funziona allo stesso modo su ogni immagine del tuo catalogo.

Ottieni una chiave API dalla dashboard, poi invia una richiesta POST con la tua immagine. Questo esempio crea un packshot su sfondo bianco con un’ombra morbida:

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header "x-api-key: $PHOTOROOM_API_KEY" \
  --header "pr-ai-shadows-model-version: 2026-04-15" \
  --form imageFile=@/absolute/path/to/image.jpg \
  --form background.color=FFFFFF \
  --form padding=0.15 \
  --form shadow.mode=ai.auto-with-overrides \
  --form outputSize=1600x1600 \
  --form export.format=jpeg \
  --output result.jpg

Puoi anche creare la chiamata visivamente nell’API playground e copiare il codice generato.

Sì, eseguendo chiamate in parallelo. L’API modifica un’immagine per chiamata e restituisce subito il risultato. Per elaborare un catalogo, invia molte chiamate contemporaneamente da un pool di worker. Il limite predefinito è di 60 immagini al minuto. I piani Enterprise aumentano questo limite per i cataloghi più grandi.

L’API Image Editing è inclusa nel piano Plus e costa 0,10 $ per immagine. Per provarla gratis, usa la modalità sandbox: aggiungi sandbox_ all’inizio della tua chiave API. Puoi effettuare fino a 1.000 chiamate gratuite al mese, ma i risultati avranno una filigrana. Scopri i prezzi dell’API.

Input: PNG, JPEG o WEBP, fino a 30 MB e 5.000 px sul lato più lungo. Le immagini più grandi vengono ridimensionate. Output: PNG per impostazione predefinita, oppure JPEG, WEBP o AVIF. JPEG non supporta la trasparenza, quindi imposta un colore di sfondo quando esporti in JPEG. Leggi la documentazione API per maggiori dettagli.

Sì. Usa l'endpoint GET e passa l'URL pubblico dell'immagine come imageUrl. Accetta gli stessi parametri dell'endpoint POST. Usa POST per i file locali e GET per le immagini già ospitate online.

Ogni risposta include un punteggio di incertezza (x-uncertainty-score) da 0 (sicuro) a 1 (incerto). Usalo per segnalare automaticamente le immagini da revisionare. I piani Enterprise includono anche QA visiva, che valuta ogni risultato in base ai tuoi standard di qualità: paghi solo per le immagini che li rispettano.

Sì. Collega Photoroom MCP in Claude da Impostazioni > Connettori > Aggiungi connettore personalizzato, usando https://mcp.photoroom.com/mcp. Poi chiedi di modificare le immagini in inglese semplice. Funziona con i piani a pagamento di Claude su Claude, Cowork e Claude Code, usa gli stessi crediti dell’API e permette di modificare fino a 20 immagini per chat.

Consulta la documentazione dell'API e la pagina per la risoluzione dei problemi, oppure chiedi ai nostri tecnici nella community API. Per domande sulla fatturazione o per qualsiasi questione riservata, scrivi direttamente a Photoroom nella community.