Tutorial completo per sviluppatori su Nano Banana Pro

Scopri come le funzionalità avanzate di questo modello AI di nuova generazione — tra cui ragionamento, grounding nella ricerca e straordinaria uscita 4K — ti consentiranno di creare applicazioni complesse e creative.

Mentre il modello Flash (Nano Banana) ha portato velocità e convenienza, la versione Pro introduce capacità di "ragionamento", grounding nella ricerca e output 4K ad alta fedeltà. È il momento di scatenarsi con compiti creativi complessi!

Questa guida ti illustrerà le funzionalità avanzate di Nano Banana Pro utilizzando l'API Gemini Developer.

**Questa guida copre:

**1. Usare Nano Banana Pro in Google AI Studio

1. Configurazione del progetto
2. Inizializzare il client
3. Generazione di base (i classici)
4. Il processo di "ragionamento"
5. Grounding nella ricerca
6. Generazione 4K ad alta risoluzione
7. Capacità multilingue
8. Mixaggio avanzato delle immagini
9. Demo esclusive della versione Pro
10. Best practice e suggerimenti per i prompt

Nota

: per una versione interattiva di questo post, dai un'occhiata al

cookbook Python

o al

Notebook JavaScript

di AI Studio.

1. Usare Nano Banana Pro in Google AI Studio

Mentre gli utenti finali possono accedere a Nano Banana Pro nell'app Gemini, l'ambiente migliore per gli sviluppatori per prototipare e testare i prompt è Google AI Studio. AI Studio è un parco giochi per sperimentare con tutti i modelli AI disponibili prima di scrivere codice, ed è anche il punto di ingresso per sviluppare con l'API Gemini.

Puoi usare Nano Banana Pro all'interno di AI Studio. Per iniziare, vai su aistudio.google.com, accedi con il tuo account Google e seleziona Nano Banana Pro (Gemini 3 Pro Image) dal selettore di modelli.

A differenza di Nano Banana, la versione Pro non ha un livello gratuito, il che significa che devi selezionare una chiave API con fatturazione abilitata (vedi la sezione "configurazione del progetto" qui sotto).

Suggerimento

: Puoi anche creare al volo app web Nano Banana direttamente in AI Studio su

ai.studio/apps

, oppure esplorare il codice e remixare una delle

app esistenti

.

2. Configurazione del progetto

Per seguire questa guida, avrai bisogno di quanto segue:

• Una chiave API da Google AI Studio.
• Fatturazione configurata per il tuo progetto.
• L'SDK Google Gen AI per Python o JavaScript/TypeScript.

Se sei già un utente avanzato dell'API Gemini con tutto questo, fantastico! Salta questa sezione e passa alla successiva. Altrimenti, ecco come iniziare:

Passo A: Ottieni la tua chiave API

Quando accedi per la prima volta a AI Studio, un progetto Google Cloud e una chiave API dovrebbero essere creati automaticamente.

Apri la schermata di gestione delle chiavi API e clicca sull'icona "copia" per copiare la tua chiave API.

Passo B: Abilita la fatturazione

Poiché Nano Banana Pro non ha un livello gratuito, devi abilitare la fatturazione sul tuo progetto Google Cloud.

Nella schermata di gestione delle chiavi API, clicca su Configura fatturazione accanto al tuo progetto e segui le istruzioni a schermo.

Quanto costa Nano Banana Pro?

La generazione di immagini con Nano Banana Pro è più costosa rispetto alla versione Flash, specialmente per le immagini 4K. Al momento della pubblicazione di questo post, un'immagine 1K o 2K costa $0,134, mentre una 4K costa $0,24 (più il costo dei token per l'input e l'output di testo).

Controlla i prezzi nella documentazione per i dettagli più recenti.

Consiglio da professionista

: Per risparmiare il 50% sui costi di generazione, puoi utilizzare l'

API Batch

. In cambio, potresti dover attendere fino a 24 ore prima di ricevere le tue immagini.

Passo C: Installa l'SDK

Scegli l'SDK per il tuo linguaggio preferito.

Python:

1pip install -U google-genai
2# Installa la libreria Pillow per la manipolazione delle immagini
3pip install Pillow

JavaScript / TypeScript:

1npm install @google/genai

Nota

: Gli esempi seguenti utilizzano l'SDK Python per la dimostrazione. Frammenti di codice equivalenti per usare Nano Banana in JavaScript sono forniti in questo

Notebook JS

.

3. Inizializzare il client

Per utilizzare il modello Pro, dovrai usare l'ID modello gemini-3-pro-image-preview.

1from google import genai
2from google.genai import types
3
4# Inizializza il client
5client = genai.Client(api_key="YOUR_API_KEY")
6
7# Imposta l'ID del modello
8PRO_MODEL_ID = "gemini-3-pro-image-preview"

4. Generazione di base (i classici)

Prima di passare alle cose più interessanti, diamo un'occhiata a una generazione standard. Puoi controllare l'output utilizzando response_modalities (per ottenere testo e immagini o solo immagini) e aspect_ratio.

1prompt = "Create a photorealistic image of a siamese cat with a green left eye and a blue right one"
2aspect_ratio = "16:9" # "1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9" or "21:9"
3
4response = client.models.generate_content(
5    model=PRO_MODEL_ID,
6    contents=prompt,
7    config=types.GenerateContentConfig(
8        response_modalities=['Text', 'Image'], # Or just ['Image']
9        image_config=types.ImageConfig(
10            aspect_ratio=aspect_ratio,
11        )
12    )
13)
14
15# Display the image
16for part in response.parts:
17    if image:= part.as_image():
18        image.save("cat.png")

È anche disponibile la modalità chat (in realtà è quella che consiglierei per la modifica multi-giro). Dai un'occhiata all'ottavo esempio, "Banana Poliglotta", per un esempio.

5. Il processo di "ragionamento"

Nano Banana Pro non si limita a disegnare; ragiona. Questo significa che può elaborare i tuoi prompt più complessi e contorti prima di generare un'immagine. E la parte migliore? Puoi dare un'occhiata al suo cervello!

Per abilitarlo, imposta include_thoughts=True in thinking_config.

1prompt = "Create an unusual but realistic image that might go viral"
2aspect_ratio = "16:9"
3
4response = client.models.generate_content(
5    model=PRO_MODEL_ID,
6    contents=prompt,
7    config=types.GenerateContentConfig(
8        response_modalities=['Text', 'Image'],
9        image_config=types.ImageConfig(
10            aspect_ratio=aspect_ratio,
11        ),
12        thinking_config=types.ThinkingConfig(
13            include_thoughts=True # Enable thoughts
14        )
15    )
16)
17
18# Display the image and thoughts
19for part in response.parts:
20  if part.thought:
21    print(f"Thought: {part.text}")
22  elif image:= part.as_image():
23    image.save("viral.png")

E dovresti ottenere qualcosa del genere:

1## Immaginare pendolari lama
2
3Mi sto concentrando sui lama ora. L'obiettivo è catturarli come
4pendolari quotidiani su un affollato autobus a La Paz, in Bolivia. Il mio piano
5prevede un autobus d'epoca stipato di passeggeri divertiti. L'immagine
6metterà in risalto dettagli come un lama che guarda fuori dal finestrino,
7un altro che interagisce con un passeggero, mentre la gente scatta
8foto.
9
10[IMMAGINE]
11
12## Visualizzare il concetto
13
14Ora sono completamente immerso nello scenario richiesto. La mia attenzione
15principale è sugli aspetti "insoliti ma realistici". La scena sta
16iniziando a prendere forma con gli elementi chiave stabiliti.

Questa trasparenza ti aiuta a capire come il modello ha interpretato la tua richiesta. È come avere una conversazione con il tuo artista!

6. Grounding nella ricerca (magia in tempo reale)

Una delle funzionalità più rivoluzionarie è il Grounding nella ricerca. Nano Banana Pro non è fermo al passato; può accedere a dati in tempo reale da Google Search per generare immagini accurate e aggiornate. Vuoi le previsioni del tempo? Fatto.

Ad esempio, puoi chiedergli di visualizzare le previsioni meteo attuali:

1prompt = "Visualize the current weather forecast for the next 5 days in Tokyo as a clean, modern weather chart. add a visual on what i should wear each day"
2
3response = client.models.generate_content(
4    model=PRO_MODEL_ID,
5    contents=prompt,
6    config=types.GenerateContentConfig(
7        response_modalities=['Text', 'Image'],
8        image_config=types.ImageConfig(
9            aspect_ratio="16:9",
10        ),
11        tools=[{"google_search": {}}] # Enable Google Search
12    )
13)
14
15# Save the image
16for part in response.parts:
17    if image:= part.as_image():
18        image.save("weather.png")
19
20# Display sources (you must always do that)
21print(response.candidates[0].grounding_metadata.search_entry_point.rendered_content)

7. Vai alla grande o vai a casa: generazione 4K

Hai bisogno di immagini di qualità da stampa? Nano Banana Pro supporta la risoluzione 4K. Perché a volte, più grande è meglio.

1prompt = "A photo of an oak tree experiencing every season"
2resolution = "4K" # Options: "1K", "2K", "4K", be careful lower case do not work.
3
4response = client.models.generate_content(
5    model=PRO_MODEL_ID,
6    contents=prompt,
7    config=types.GenerateContentConfig(
8        response_modalities=['Text', 'Image'],
9        image_config=types.ImageConfig(
10            aspect_ratio="1:1",
11            image_size=resolution
12        )
13    )
14)

Nota

: La generazione 4K ha un costo maggiore, quindi usala con saggezza!

8. Banana Poliglotta (capacità multilingue)

Il modello può generare e persino tradurre testo all'interno delle immagini in oltre una dozzina di lingue. È praticamente un traduttore universale per i tuoi occhi.

1# Generate an infographic in Spanish
2message = "Make an infographic explaining Einstein's theory of General Relativity suitable for a 6th grader in Spanish"
3
4response = chat.send_message(message,
5    config=types.GenerateContentConfig(
6        image_config=types.ImageConfig(aspect_ratio="16:9")
7    )
8)
9
10# Save the image
11for part in response.parts:
12    if image:= part.as_image():
13        image.save("relativity.png")

1# Translate it to Japanese
2message = "Translate this infographic in Japanese, keeping everything else the same"
3response = chat.send_message(message)
4
5# Save the image
6for part in response.parts:
7    if image:= part.as_image():
8        image.save("relativity_JP.png")

9. Mescola le carte! (mixaggio avanzato delle immagini)

Mentre il modello Flash può mescolare fino a 3 immagini, il modello Pro può gestirne fino a 14 immagini! È una vera festa in un solo prompt. Perfetto per creare collage complessi o mostrare l'intera gamma dei tuoi prodotti.

1# Mix multiple images
2response = client.models.generate_content(
3    model=PRO_MODEL_ID,
4    contents=[
5        "An office group photo of these people, they are making funny faces.",
6        PIL.Image.open('John.png'),
7        PIL.Image.open('Jane.png'),
8        # ... add up to 14 images
9    ],
10)
11
12# Save the image
13for part in response.parts:
14    if image:= part.as_image():
15        image.save("group_picture.png")

Nota

: Se vuoi una fedeltà molto alta per i tuoi personaggi, limitati a 5, che sono già più che sufficienti per una serata di festa!

10. È ora di mettersi in mostra! (Demo esclusive della versione Pro)

Ecco alcuni esempi di ciò che è possibile solo con Nano Banana Pro. Preparati a rimanere stupito:

Pixel Art Personalizzata (Grounding nella ricerca)

Prompt

: "Cerca sul web e poi genera un'immagine in prospettiva isometrica, pixel art dettagliata che mostri la carriera di Guillaume Vernade"

Questo utilizza il grounding nella ricerca per trovare informazioni specifiche su una persona e le visualizza in uno stile specifico.

Integrazione complessa di testo

Prompt

: "Mostrami un'infografica su come funzionano i sonetti, utilizzando un sonetto sulle banane scritto al suo interno, insieme a una lunga analisi letteraria della poesia. Buona estetica vintage"

Il modello può generare testo coerente e lungo e integrarlo perfettamente in un layout complesso.

Mockup ad alta fedeltà

Prompt

: "Una foto del programma per lo spettacolo di Broadway sui giocatori di TCG su un bel sedile del teatro, è professionale e ben fatto, lucido, si vedono la copertina e una pagina che mostra una foto del palco."

Crea mockup fotorealistici di materiali stampati con illuminazione e texture accurate.

11. Best practice e suggerimenti per i prompt per Nano Banana e Nano Banana Pro

Per ottenere i migliori risultati con i modelli Nano Banana, segui queste linee guida per i prompt:

Sii iper-specifico: Più dettagli fornisci su soggetti, colori, illuminazione e composizione, maggiore sarà il controllo che avrai sull'output.

Fornisci contesto e intenzione: Spiega lo scopo o l'umore desiderato dell'immagine. La comprensione del contesto da parte del modello influenzerà le sue scelte creative.

Itera e perfeziona: Non aspettarti la perfezione al primo tentativo. Usa la capacità conversazionale del modello per apportare modifiche incrementali e perfezionare la tua immagine.

Usa istruzioni passo-passo: Per scene complesse, suddividi il prompt in una serie di istruzioni chiare e sequenziali.

Usa un linguaggio positivo: Invece di prompt negativi come "niente auto", descrivi la scena desiderata in modo positivo: "una strada vuota e deserta, senza segni di traffico".

Controlla la telecamera: Usa termini fotografici e cinematografici per dirigere la composizione, come "inquadratura grandangolare", "macro" o "prospettiva dal basso".

Sfrutta il grounding nella ricerca a tuo vantaggio: Quando sai di volere che il modello utilizzi dati in tempo reale o del mondo reale, sii molto preciso. "Cerca sul web l'ultima partita dell'Olympique Lione e crea un'infografica" funzionerà meglio di "un'infografica delle ultime partite dell'OL" (che dovrebbe comunque funzionare, ma non correre rischi).

Usa l'[API Batch](https://ai.google.dev/gemini-api/docs/image-generation?batch=file#batch-api) per ridurre i costi e ottenere più quota: L'API batch è un modo per inviare insieme lotti di richieste piccoli o molto grandi. Potrebbero essere necessarie fino a 24 ore per essere elaborate, ma in cambio puoi risparmiare il 50% sui costi di generazione. E anche la quota è più alta!

Per un approfondimento sulle best practice, consulta la guida ai prompt nella documentazione e le best practice per i prompt per Nano Banana pubblicate sul blog ufficiale.

Conclusione

Nano Banana Pro (Gemini 3 Pro Image) apre una nuova frontiera per la generazione di immagini AI. Con la sua capacità di ragionare, cercare e renderizzare in 4K, è uno strumento per creatori seri (e per un divertimento serio).

Pronto a provarlo? Vai su Google AI Studio, prova o personalizza le nostre App o dai un'occhiata al cookbook.