> ## Documentation Index
> Fetch the complete documentation index at: https://docs.samsa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Modifica di immagini

> Modifica un'immagine esistente con un prompt — con o senza mask — riutilizzando i tuoi modelli addestrati.

Magic Edit prende un'immagine sorgente e un prompt e restituisce un'immagine
modificata. Fornisci la sorgente in tre modi — un `image_id` già presente nel
contesto della tua organizzazione, un `url` `https`, oppure `base64` +
`mime_type` inline. Aggiungi un `mask` per eseguire in modalità **PRO** (inpaint
basato su mask) e riutilizza i tuoi modelli
`style`/`object`/`person`/`setting` addestrati e le color palette per risultati
in linea con il brand.

## Pattern asincrono

Come la generazione, la modifica è asincrona: `POST /images/edits` restituisce
**`202 Accepted`** con un `id` del job; interroga
[`GET /images/edits/{id}`](/it/api-reference/edits/get-edit) finché non è
`completed`, poi leggi le immagini modificate (presigned URL validi per **24
ore**). Un `webhook_url` ti dà invece una callback push — vedi
[Webhook](/it/guides/webhooks).

## Engine e credits

L'engine predefinito è `nano_banana_pro`; sono disponibili anche `gemini` e
`kontext`. Fornire un `mask` esegue la modifica in modalità **PRO** (basata su
mask), supportata dagli engine `nano_banana_pro` e `gemini`. Fornire modelli
addestrati (`style_id`/`object_ids`/`person_ids`/`setting_ids`) o un
`color_palette_id` forza `nano_banana_pro`. Ogni output viene addebitato dal pool
della tua organizzazione alle tariffe dell'app; un pool esaurito restituisce
`402`. Vedi [Prezzi](/it/guides/pricing).