Google

Nano Banana

gemini-nano-banana-2.1

Generazione di immagini guidata dal linguaggio naturale e fotoritocco conversazionale multi-turno, con una buona conservazione della coerenza di personaggi e soggetti durante le modifiche, e una copertura di generazione, modifica e miglioramento

gemini-nano-banana-2.1 nano-banana

Prova gemini-nano-banana-2.1

Input

Creazioni

Vedi tutte le creazioni

Output

image

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

gemini-nano-banana-2.1 per image

Specifiche	Prezzo unitario
1K	$0.022
2K	$0.036
4K	$0.058

Panoramica della posizione

gemini-nano-banana-2.1 è un modello pensato per scenari di generazione e modifica di immagini, con supporto sia alla generazione testo-immagine sia a quella immagine-immagine. Gli sviluppatori possono passare un prompt tramite l'interfaccia unificata di HiAPI.ai per generare un'immagine, oppure caricare fino a 10 immagini di riferimento per modifiche locali, fusione di più immagini e modifiche consecutive con soggetto coerente. L'output può essere scelto tra risoluzioni da 1K a 4K e vari rapporti d'aspetto, adatto a team che necessitano di produrre rapidamente materiali visivi commerciali, iterare creativamente o completare miglioramenti delle immagini.

Punti di forza principali

Generazione e modifica coperte da un'unica linea — lo stesso modello supporta sia la generazione da solo testo sia modifiche e fusioni basate su immagini di riferimento, riducendo i costi di cambio modello tra compiti diversi.
Modifica multi-turno con coerenza del soggetto — nelle modifiche consecutive in stile conversazionale mantiene bene persone e soggetti, adatto a iterazioni creative che richiedono la continuità dello stesso personaggio tra più turni.
Fusione fino a 10 immagini di riferimento — è possibile passare più immagini in una sola volta per compiti come composizione di scene e combinazione di palette cromatiche, riducendo il lavoro di pre-elaborazione per l'assemblaggio di più materiali.
Controllo fine di risoluzione e formato — supporta tre livelli di nitidezza (1K, 2K, 4K) e oltre dieci rapporti d'aspetto, permettendo di allineare direttamente l'output alle specifiche del canale di distribuzione.

Descrizione delle capacità

Generazione testo-immagine in linguaggio naturale: basta descrivere la scena con un prompt per generare l'immagine; il modello comprende bene istruzioni complesse ed è adatto a ottenere direttamente bozze visive utilizzabili da una descrizione concettuale.

Modifica di immagini guidata da riferimenti: caricando immagini di riferimento insieme alle richieste di modifica è possibile sostituire sfondi, aggiungere o rimuovere oggetti, regolare texture e illuminazione, eseguire ritocchi locali e così via.

Fusione di più immagini e composizione di scene: è possibile passare fino a 10 immagini di riferimento in una sola volta per inserire oggetti in una scena specificata o combinare palette cromatiche, adatto alla produzione di immagini di prodotto in contesto e materiali compositi.

Specifiche di output su richiesta: si possono scegliere risoluzioni da 1K a 4K, quindici rapporti d'aspetto e formati JPG o PNG; l'output è direttamente conforme ai requisiti del canale, riducendo le lavorazioni successive.

Casi d'uso

Produzione di materiali per marketing e social media — inserendo il tema della campagna e la descrizione degli elementi del brand si generano immagini promozionali adattate a diversi rapporti d'aspetto, per la pubblicazione sui social e la rapida produzione di materiali pubblicitari.
Iterazione creativa continua con personaggi coerenti — con immagini di riferimento di persone e istruzioni di modifica multi-turno si producono storyboard e immagini di character design, per la previsualizzazione di animazioni o la produzione di contenuti seriali.
Immagini di prodotto in contesto e sostituzione di sfondi — caricando l'immagine del prodotto e descrivendo la scena desiderata si compongono immagini espositive con luci e ombre ambientali, per le pagine dettaglio dell'e-commerce e i materiali di catalogo.
Restauro e colorazione di vecchie foto — inserendo la foto da restaurare e indicando le esigenze di miglioramento si ottiene un'immagine più nitida o colorata, per l'archiviazione e la conservazione delle immagini di famiglia.
Prototipi concettuali e illustrazioni di schemi — dalla descrizione testuale o da uno schema strutturale si generano immagini concettuali, per revisioni di design, materiali didattici e illustrazioni visive nelle proposte.

Limiti e consigli per la scelta

Questo modello è incentrato sull'output di immagini e non gestisce domande e risposte testuali né la generazione di video; il limite massimo di risoluzione è 4K, quindi per output più definiti è necessario un ingrandimento separato. L'efficacia delle modifiche multi-turno e della fusione di più immagini dipende dalla qualità dei prompt e delle immagini di riferimento; per composizioni complesse si consiglia di verificare prima su piccoli lotti. Se il compito è principalmente la produzione rapida di immagini in batch, si può valutare il nano-banana della stessa famiglia; se servono flussi di lavoro complessi con contesti lunghi, è necessario verificare le capacità della versione prima di scegliere. L'output può contenere marcatori di tracciabilità invisibili, da valutare in anticipo per scenari di attribuzione del copyright.

Domande frequenti

Vedi tutte le domande →

Per quali tipi di attività è principalmente adatto Nano Banana?

Un modello di generazione di immagini versatile, adatto per illustrazioni, fotografia, concept di prodotto e visual per i social media.
Nano Banana supporta le immagini di riferimento?

La linea attuale è pura generazione testo-immagine e non accetta immagini di riferimento.
Quali specifiche di output sono supportate?

La pagina attuale mostra 1K e auto, 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9; le opzioni finali disponibili sono quelle indicate nei parametri del Playground.
Come viene fatturato Nano Banana?

La fatturazione si basa sul numero di immagini generate con successo; eventuali differenze tra risoluzioni o livelli di qualità sono mostrate nel prezzo in tempo reale sulla pagina.

Crea un'attività di generazione

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.

Idempotency-KeystringOpzionale

Chiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.

Chiave di idempotenza

In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.

Corpo

modelstringObbligatorio

Valore fisso attuale: gemini-nano-banana-2.1

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per gemini-nano-banana-2.1 e la route default — vedi la tabella dei parametri sotto.

promptstringObbligatoriominLength 1maxLength 20000

Prompt che descrive il contenuto dell'immagine da generare, oppure le richieste di modifica per l'immagine di riferimento; assume forma di stringa.

resolutionstringOpzionalePredefinito: "1K"

Livello di nitidezza dell'immagine di output, assume forma di stringa; predefinito 1K.

Opzioni:1K2K4K

image_inputarrayOpzionalemaxItems 10

Array di immagini di riferimento, i cui elementi sono immagini utilizzate per la modifica o la fusione, supporta JPEG, PNG, WebP, ciascuna non superiore a 30 MB; i relativi sotto-campi hanno una descrizione separata.

Array [ string ]

aspect_ratiostringOpzionalePredefinito: "auto"

Rapporto larghezza-altezza dell'immagine, assume forma di stringa; predefinito auto, la modalità automatica determina il rapporto in base all'input.

Opzioni:1:12:33:21:44:13:44:34:5

Mostra tutto (7)

5:41:88:19:1616:921:9auto

output_formatstringOpzionalePredefinito: "jpg"

Formato file dell'immagine di output, assume forma di stringa; predefinito jpg.

Opzioni:jpgpng

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.

urlstringObbligatorio

Obbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.

whenstringOpzionalePredefinito: "final"

Al momento è supportato solo final: notifica sia su success sia su fail.

Opzioni:final

storagestringOpzionalePredefinito: "temp"

Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.

Opzioni:temppersistent

Esempi di richiesta

# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-nano-banana-2.1",
  "input": {
    "prompt": "…",
    "resolution": "1K",
    "aspect_ratio": "auto",
    "output_format": "jpg"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gemini-nano-banana-2.1",
    input: {
      "prompt": "…",
      "resolution": "1K",
      "aspect_ratio": "auto",
      "output_format": "jpg"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "gemini-nano-banana-2.1",
        "input": {
          "prompt": "…",
          "resolution": "1K",
          "aspect_ratio": "auto",
          "output_format": "jpg"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Ottieni i dettagli dell'attività

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

queued In coda, non avviata. handling In elaborazione. archiving Elaborazione conclusa, preparazione artefatti. success Terminale: completato, artefatti disponibili (restituisce output). fail Terminale: errore (restituisce error). Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi Unix dello stato terminale; 0 finché non terminale.

outputarrayOpzionale

Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).

Array [ object ]

Elementi dell'array

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione dell'errore.

Esempi di risposta

Successo

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In elaborazione (non terminale)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Non riuscito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}