Google

Nano Banana 2 Lite

Nano-Banana-2-Lite

Modello leggero ed efficiente della famiglia Google Image, pensato per bassa latenza e bassi costi, ideale per la conceptualizzazione rapida e la generazione di immagini ad alto throughput, sostituisce senza soluzione di continuità la prima generazione di Nano Banana

Nano-Banana-2-Lite

Prova Nano-Banana-2-Lite

Input

Creazioni

Vedi tutte le creazioni

Output

image

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

Nano-Banana-2-Lite per image

Prezzo unitario	$0.033

Panoramica e posizionamento

Nano-Banana-2-Lite è il modello leggero orientato all'efficienza della serie di generazione di immagini di Google, e supporta sia la generazione di immagini da testo sia l'editing di immagini basato su immagini di riferimento. Dà priorità alla velocità di risposta e al costo per chiamata, ed è adatto agli sviluppatori che necessitano di generazione di immagini in batch e iterazione rapida delle prime bozze; mantiene prestazioni utilizzabili nel seguito delle istruzioni e nella coerenza dei personaggi, ed è in grado di gestire produzioni multi-formato, dalla bozza concettuale all'immagine di marketing, con successiva rifinitura su richiesta.

Punti di forza principali

Generazione da testo ed editing di immagini nella stessa interfaccia: sulla stessa linea è possibile sia generare direttamente immagini tramite prompt, sia passare fino a 10 immagini di riferimento per editing e remix, riducendo i cambi di flusso di lavoro.
Posizionamento efficiente per chiamate ad alta frequenza: all'interno della serie occupa il livello che privilegia velocità e costo, adatto a task sensibili al throughput come materiali in batch e generazione di immagini template.
Output con 14 rapporti d'aspetto: è possibile specificare direttamente rapporti anche estremi, da 1:1 e 16:9 fino a 1:8 e 8:1, generando in una sola volta immagini adatte a più posizionamenti su diverse piattaforme.
Supporto all'iterazione locale su più turni: è possibile modificare ripetutamente porzioni del risultato esistente, portando rapidamente la prima bozza a uno stato utilizzabile.

Descrizione delle capacità

Generazione da testo ed editing con immagini di riferimento: passando solo il prompt si ottiene una generazione da testo; allegando da 1 a 10 URL di immagini di riferimento si passa all'editing o al remix. La stessa interfaccia copre entrambe le esigenze, facilitando l'incapsulamento unificato in un'unica pipeline.

Output con rapporto d'aspetto controllabile: aspect_ratio offre 14 valori e supporta la selezione automatica con auto; gli sviluppatori possono bloccare direttamente il rapporto in base al posizionamento di pubblicazione, evitando ritagli e adattamenti successivi.

Input di prompt lunghi: prompt può arrivare a 20000 caratteri, accogliendo descrizioni abbastanza complete di soggetto, composizione e stile, ed è adatto alla costruzione in batch di richieste di generazione tramite composizione di template.

Input con più immagini di riferimento: fino a 10 immagini di riferimento JPEG, PNG e WebP (massimo 30MB ciascuna), utilizzabili per task di editing che richiedono contesto multi-immagine, come trasferimento di stile e combinazione di materiali.

Scenari applicativi

Bozze concettuali in batch per team creativi: generare in batch schizzi di proposte con prompt brevi, da usare come materiale per revisioni interne e selezione di direzione; prima si valuta la direzione, poi si decide l'investimento nella rifinitura.
Pipeline di generazione ad alto throughput per sviluppatori: generare in batch immagini di prodotto o di contenuto con prompt template, archiviarle direttamente per l'uso su richiesta da parte dei sistemi aziendali.
Immagini per più posizionamenti marketing e social: specificare rapporti come 1:1, 9:16 e 16:9 in base al posizionamento, generando in una sola volta immagini finite in più formati e riducendo il lavoro di ritaglio successivo.
Modifiche locali su più turni di immagini esistenti: caricare immagini di riferimento e descrivere le modifiche tramite prompt, regolando i dettagli locali turno dopo turno per produrre versioni iterative consegnabili.
Contenuti seriali con personaggi coerenti tra immagini: usare la stessa immagine di riferimento per mantenere personaggi e identità visiva, producendo in batch set di illustrazioni o storyboard con un aspetto coerente della serie.

Limiti e suggerimenti di selezione

Essendo un modello leggero che privilegia l'efficienza, la prima bozza del rendering di testo in frasi lunghe o layout complessi potrebbe richiedere interventi manuali; le istruzioni testuali semplici e chiare sono più affidabili. Per layout complessi e dettagli ad alta precisione si consiglia di prevedere una fase di rilavorazione. Al momento non si dispone di specifiche dettagliate come limite massimo di risoluzione, concorrenza e quote, da verificare autonomamente prima dell'integrazione. Se il task richiede qualità dell'immagine e comprensione di istruzioni complesse più del throughput, conviene scegliere un modello di livello superiore della stessa serie; se servono solo bozze in batch e iterazione rapida, questo modello è più adatto.

Domande frequenti

Vedi tutte le domande →

Per quali attività è principalmente adatto Nano Banana 2 Lite?

Linea entry-level a 1K fisso, adatta a grandi volumi di bozze, iterazioni rapide e ridisegno opzionale con più immagini di riferimento.
Nano Banana 2 Lite supporta le immagini di riferimento?

Supporta fino a 10 immagini di riferimento opzionali; se non ne viene caricata nessuna, può essere utilizzato come generazione di immagini puramente da testo.
Quali specifiche di output sono supportate?

La pagina attuale mostra 1K e auto, 1:1, 16:9, 9:16, 4:3, 3:4, 8:1, 1:8; le opzioni finali disponibili sono determinate dai parametri del Playground.
Come viene fatturato Nano Banana 2 Lite?

Il costo è calcolato in base al numero di immagini generate con successo; eventuali differenze tra risoluzioni o livelli di qualità sono indicati nel prezzo in tempo reale mostrato 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: Nano-Banana-2-Lite

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per Nano-Banana-2-Lite e la route default — vedi la tabella dei parametri sotto.

promptstringObbligatoriominLength 1maxLength 20000

Prompt testuale per la generazione dell'immagine, in forma di stringa, massimo 20000 caratteri, utilizzato per descrivere il contenuto visivo che si desidera generare o modificare.

image_urlsarrayOpzionaleminItems 1maxItems 10

Array opzionale di URL di immagini di riferimento, i cui elementi sono stringhe di indirizzo immagine, utilizzato per la modifica delle immagini o la composizione mista; massimo 10 immagini, ciascuna in formato JPEG/PNG/WebP e non superiore a 30MB; se non fornito, si ricade nella generazione puramente testuale.

Array [ string ]

aspect_ratiostringObbligatorioPredefinito: "auto"

Rapporto larghezza-altezza dell'immagine di output, in forma di stringa, il valore predefinito auto lascia che sia il modello a sceglierlo.

Opzioni:auto1:12:33:23:44:34:55:4

Mostra tutto (7)

9:1616:921:91:44:11:88:1

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": "Nano-Banana-2-Lite",
  "input": {
    "prompt": "…",
    "aspect_ratio": "auto"
  }
}'

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: "Nano-Banana-2-Lite",
    input: {
      "prompt": "…",
      "aspect_ratio": "auto"
    }
  }),
});
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": "Nano-Banana-2-Lite",
        "input": {
          "prompt": "…",
          "aspect_ratio": "auto"
        }
    },
)
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"
    }
  }
}