Introduzione
Nano Banana 2 Da testo a immagine è il Gemini 3.1 Flash Image di Google, uscito il 26 febbraio 2026, che genera immagini da un prompt scritto. Google lo descrive come qualità d’immagine di livello Pro alla velocità Flash. Genera su quattro livelli di dimensione da 0.5k a 4k in quattordici formati fino a 8:1 e può cercare sul web e tra immagini di riferimento prima di disegnare, a partire da ben sotto le tariffe di Google.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| un brief scritto | Nano Banana 2 Da testo a immagine |
| un’immagine da cambiare | Nano Banana 2 Modifica immagine |
Caratteristiche principali
Percorso economico e Official fallback
Le richieste partono da un percorso economico, a un prezzo ben sotto il listino di Google. Con Official fallback (attivo per impostazione predefinita), una richiesta che non riesce a completare viene rieseguita sul percorso ufficiale al prezzo ufficiale. In entrambi i casi il modello è Gemini 3.1 Flash Image di Google, con i livelli di dimensione che Google pubblica per Nano Banana 2.
Quattro livelli, quattordici formati
Dalle bozze a 512 pixel alle versioni finali a 4096 pixel, e dalle torri 1:8 ai banner 8:1. Il formato non cambia mai il prezzo, solo il livello di dimensione. In 2k il nostro banner 4:1 è tornato largo 4128 pixel.
Ricerca prima di disegnare
La ricerca web recupera fatti attuali come date, meteo e monumenti; la ricerca immagini recupera foto di riferimento di luoghi e prodotti reali. Sono entrambe interruttori facoltativi della richiesta.
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 |
aspect_ratio | No | Uno tra quattordici formati, compresi i banner estremi 4:1, 1:4, 8:1 e 1:8; 16:9 per impostazione predefinita. Il formato non cambia il prezzo. |
resolution | No | 0.5k, 1k (predefinito), 2k o 4k. Un’immagine quadrata misura 512, 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 informazioni attuali come meteo, date o monumenti 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: |
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 non cambia 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 in 0.5k o con ricerca web o ricerca immagini passano dal percorso ufficiale, e ogni ricerca aggiunge un costo. Sul percorso ufficiale, un rifiuto che arriva come breve risposta testuale invece di un’immagine conta come una generazione completata e viene addebitato al prezzo ufficiale; gli altri rifiuti non vengono addebitati.
| Specifiche | Prezzo |
|---|---|
| $0.036 / immagine |
| $0.0384 / immagine (Con Official fallback: fino a $0.0536) |
| $0.0602 / immagine (Con Official fallback: fino a $0.0808) |
| $0.0902 / immagine (Con Official fallback: fino a $0.1208) |
Casi d’uso
Testate web e cartelloni
Banner ultra larghi 4:1 e 8:1 resi come un’unica foto continua, senza unire o stirare dopo.
Bozze rapide di moda e lifestyle
Molte direzioni all’ora in 0.5k e 1k, con la migliore rifatta in 2k per la consegna.
Luoghi e prodotti reali
Con la ricerca immagini attiva, le scene ambientate davanti a un monumento reale o con un prodotto reale possono appoggiarsi a foto di riferimento dal web.
Formati alti per il mobile
Immagini alte 1:4 e 1:8 per le storie e i banner laterali, generate come un’unica immagine continua.
Consigli avanzati
Dai contenuto a entrambi i bordi nei formati larghi
Per 4:1 e 8:1, descrivi cosa riempie i bordi sinistro e destro: una lunga spiaggia, uno skyline, una fila di vetrine. Altrimenti le estremità diventano cielo vuoto.
La ricerca per i fatti, non per lo stile
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 piccola, consegna grande
Tieni lo stesso prompt tra 0.5k e 4k; la composizione resta vicina, quindi le scelte fatte sulla bozza restano valide.
Scegli 2k per la consegna
In 2k un’immagine quadrata misura 2048 pixel di lato, abbastanza per la maggior parte di schermi e pagine; 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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "16:9",
"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.
