Introduzione
Nano Banana 2.1 Da testo a immagine è l’ultimo modello Nano Banana di Google, uscito il 6 ottobre 2026 come aggiornamento di Nano Banana 2 (Gemini 3.1 Flash Image). Google ha migliorato qualità visiva, aderenza al prompt e resa del testo, e dice di aver eliminato le giunzioni visibili nei banner larghi a 2K e 4K. Genera a 1k, 2k o 4k in quattordici formati fino a 8:1 e può cercare sul web o tra immagini di riferimento prima di disegnare.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| un brief scritto | Nano Banana 2.1 Da testo a immagine |
| immagini da cambiare o combinare | Nano Banana 2.1 Modifica immagine |
Caratteristiche principali
Testo che si legge correttamente
Nei nostri test ogni riga che abbiamo messo tra virgolette è uscita scritta come l’avevamo scritta: una testata di rivista e due titoli di copertina, un titolo di film e la sua riga della data di uscita, un’insegna al neon di un motel. Le scritte minute che non avevamo specificato, come le righe sotto il titolo di un film, sono tornate come testo di riempimento.
Quattordici formati, tre dimensioni
Dai fotogrammi story 1:8 ai banner 8:1, a 1k, 2k o 4k. Il formato non cambia mai il prezzo, solo il livello di dimensione. Il nostro banner 8:1 a 2k è tornato largo 5856 pixel. Che un formato largo torni come un’unica immagine dipende dalle persone che mostra: nelle nostre prove paesaggi e folle sono rimasti in un unico pezzo, mentre persone sparse nell’inquadratura o vicine all’obiettivo tornavano spesso come inquadrature unite.
Ricerca prima di disegnare
La ricerca web recupera fatti attuali come date, meteo ed eventi; la ricerca immagini recupera immagini di riferimento di luoghi e prodotti reali. Il nostro poster delle previsioni ha stampato la data di oggi con la ricerca web attiva e una data inventata senza.
PNG o JPEG
PNG è il formato predefinito; i file JPEG sono molte volte più piccoli allo stesso prezzo.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 5.000 caratteri. Descrivi soggetto, ambientazione, luce e obiettivo con frasi semplici; le parole tra virgolette doppie vengono stampate nell’immagine. almeno 1 caratteri · al massimo 5000 caratteri |
aspect_ratio | No | Uno dei quattordici formati, 16:9 per impostazione predefinita; il formato non cambia il prezzo. |
resolution | No | 1k (predefinito), 2k o 4k. Un’immagine quadrata misura 1024, 2048 o 4096 pixel di lato; ogni livello ha il suo prezzo. |
enable_web_search | No | Disattivato per impostazione predefinita. Se attivo, il modello verifica fatti attuali come date, meteo o eventi prima di disegnare. Predefinito: |
enable_image_search | No | Disattivato per impostazione predefinita. Se attivo, il modello cerca immagini di riferimento sul web prima di disegnare, utile per luoghi e prodotti reali. Predefinito: |
output_format | No | png (predefinito) o jpeg. I file JPEG sono molte volte più piccoli; il prezzo è lo stesso. |
official_fallback | No | Attivo per impostazione predefinita. Ogni richiesta viene eseguita prima sulla rotta economica. Predefinito: |
Prezzi
Addebitato per immagine in base al livello di dimensione; il formato e il formato di output non cambiano il prezzo. Ogni richiesta parte dal percorso economico, al prezzo economico. Con Official fallback (attivo per impostazione predefinita), una richiesta che il percorso economico rifiuta o non riesce a completare viene rieseguita sul percorso ufficiale al prezzo ufficiale, quindi il preventivo mostra il prezzo di partenza e l’importo massimo; disattivalo per pagare solo il prezzo economico. Le richieste con ricerca web o ricerca immagini passano dal percorso ufficiale, e ogni ricerca aggiunge un costo. Una richiesta che il modello attenua restituisce comunque un’immagine e viene addebitata come le altre. Le richieste rifiutate non vengono addebitate.
| Specifiche | Prezzo |
|---|---|
| $0.0217 / immagine (Con Official fallback: fino a $0.048) |
| $0.0351 / immagine (Con Official fallback: fino a $0.072) |
| $0.0626 / immagine (Con Official fallback: fino a $0.162) |
Casi d’uso
Copertine e poster
Copertine di riviste, locandine di film e volantini di eventi in cui il titolo deve leggersi giusto al primo tentativo.
Header di siti
Header ultra larghi 4:1 e 8:1 di paesaggi, porti, skyline e folle, controllati prima dell’uso per individuare pannelli uniti. Per persone in primo piano, genera un 21:9 a 4k e ritaglialo a 4:1. I formati alti 1:4 e 1:8 funzionano quando il soggetto è alto di per sé, come un faro, un grattacielo o una cascata.
Editoriali moda e lifestyle
Abbigliamento da sera, moda editoriale e coppie vengono resi come richiesto; le richieste dal livello Forte in su, no.
Immagini che dipendono da oggi
Schede delle previsioni, programmi e poster di eventi, con la ricerca web attiva perché i dettagli siano aggiornati.
Consigli avanzati
Virgolette per le parole, descrivi i caratteri
Metti ogni riga di testo tra virgolette doppie e indica stile e posizione: alte maiuscole con grazie in alto, sans serif condensato in grassetto in basso.
Tieni piccole le persone nei formati larghi
Per 4:1 e 8:1 lascia che un solo ambiente riempia tutta la larghezza, come un crinale, un porto o una folla, e tieni le persone piccole e vicine al centro. I prompt tornati come inquadrature unite erano quelli che spargevano persone nell’inquadratura o le mettevano vicino all’obiettivo; iniziare con «one continuous scene» non lo impediva.
Tieni la ricerca per i fatti
La ricerca web aiuta quando l’immagine dipende da qualcosa di attuale o reale. Non migliora stile o composizione, quindi negli altri casi lasciala spenta.
Bozza a 1k, consegna a 2k
Fissa la composizione a 1k, poi esegui lo stesso prompt a 2k; tieni 4k per la stampa e i ritagli forti.
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-2.1/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "16:9",
"output_format": "png",
"enable_web_search": false,
"enable_image_search": false
}
}'
# 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.









