Introduzione
Nano Banana Pro Modifica immagine applica il Gemini 3 Pro Image di Google alle immagini che hai già. Accetta da una a quattordici sorgenti, pianifica la modifica prima di renderla e restituisce 1k, 2k o 4k nel formato della sorgente o in uno dei dieci formati.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| un brief scritto | Nano Banana Pro Da testo a immagine |
| un’immagine da cambiare | Nano Banana Pro Modifica immagine |
Caratteristiche principali
Modifiche accurate con un solo cambiamento
Luce nuova, uno sfondo nuovo o testo aggiunto mentre le persone e il resto dell’immagine restano com’erano, come nei nostri esempi con le candele e la copertina. Il modello pianifica la modifica prima di renderla, e questo mantiene stabili le parti dell’immagine non coinvolte.
Testo sulle foto
Testate, righe del numero e didascalie vengono posate sull’immagine con la grafia che citi, nella posizione che indichi.
Fino a quattordici riferimenti
Unisci persone, prodotti e ambientazioni da molte sorgenti, ognuna descritta dal suo ruolo nel prompt, in un’unica richiesta di modifica.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 5.000 caratteri. Descrivi soggetto, ambientazione, luce e obiettivo con frasi complete; le parole tra virgolette vengono scritte come testo nell’immagine. almeno 1 caratteri · al massimo 5000 caratteri |
image_urls | Sì | Da 1 a 14 immagini sorgente. Scrivi nel prompt cosa porta ciascuna: la persona, l’ambientazione, il prodotto. almeno 1 elementi · al massimo 14 elementi |
aspect_ratio | No | auto (predefinito) mantiene il formato dell’immagine sorgente; oppure scegli uno tra dieci formati da 21:9 a 9:16. Il formato non cambia il prezzo. |
resolution | No | 1k (predefinito), 2k o 4k. 1k e 2k costano uguale; 4k costa di più e genera 4096 pixel sul lato lungo. |
official_fallback | No | Attivo per impostazione predefinita. Ogni modifica viene eseguita prima sulla rotta economica. Predefinito: |
Prezzi
Addebitato per immagine in base al livello di dimensione. Ogni modifica parte dal percorso economico, al prezzo economico, senza costi per immagine sorgente. Con Official fallback (attivo per impostazione predefinita), una modifica che il percorso economico rifiuta o non riesce a completare, o che ha più di 8 immagini sorgente, passa dal percorso ufficiale al prezzo ufficiale, che aggiunge anche un piccolo costo fisso per ogni immagine sorgente; disattivalo per pagare solo il prezzo economico. Il preventivo mostra il prezzo di partenza e l’importo massimo della modifica. Le richieste rifiutate non vengono addebitate.
| Specifiche | Prezzo |
|---|---|
| $0.0668 / immagine (Con Official fallback: fino a $0.1072) |
| $0.0668 / immagine (Con Official fallback: fino a $0.1072) |
| $0.118 / immagine (Con Official fallback: fino a $0.192) |
Casi d’uso
Trasformare foto in copertine e poster
Aggiungi una testata, una data e una riga di testo a una foto approvata senza ritoccarla.
Varianti di atmosfera e luce
Mostra la stessa scena a lume di candela, all’alba o sotto il neon per un cliente che sta scegliendo una direzione.
Immagini di campagna localizzate
Sostituisci il testo di un poster finito con una riga tradotta per ogni mercato, mentre la foto e la sua luce restano intatte.
Consigli avanzati
Cambia una cosa alla volta
Le istruzioni con un solo cambiamento mantengono stabile tutto il resto; concatena più modifiche invece di metterle in un solo prompt.
Proteggi le persone
Dopo la modifica, nomina la persona, l’abito e la posa che devono restare esattamente uguali.
Metti in conto il tempo delle modifiche
Con questo modello le modifiche durano più del testo a immagine: fino a circa tre minuti nei nostri test in 2k sul percorso ufficiale, mentre le nostre modifiche in 1k sul percorso economico sono finite in meno di un minuto.
Cita il testo con la sua posizione
Per il testo aggiunto, cita ogni riga e indica dove va: in alto, in basso a sinistra, accanto al logo.
Usa 2k come predefinito
Con questo modello 1k e 2k costano uguale, quindi modifica in 2k a meno che non ti serva un file più leggero.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-pro/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
