Google

Nano Banana 2

nano-banana-2

Modello di immagine rapido di Google per la generazione di immagini su larga scala, supporta da 512px fino a 4K nativo e diversi formati, genera combinando informazioni in tempo reale dalla ricerca, ideale per la creazione ad alta frequenza

nano-banana-2

Prova nano-banana-2

Input

Creazioni

Vedi tutte le creazioni

Output

image

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

nano-banana-2 per image

Specifiche	Prezzo unitario
1K	$0.036
2K	$0.057
4K	$0.086

Panoramica della posizione

nano-banana-2 è un modello di generazione di immagini presentato da Google, che supporta sia la generazione testo-immagine sia l'editing con immagini di riferimento. Consente agli sviluppatori di generare in una sola volta un'immagine con formato e risoluzione selezionati, utilizzando un prompt fino a 20000 caratteri insieme a un massimo di 14 immagini di riferimento. È adatto a team che necessitano di produrre materiali marketing in serie, iterare rapidamente bozze creative o vincolare la coerenza di stile tramite immagini di riferimento, richiamabili tramite l'interfaccia unificata di HiAPI.ai.

Punti di forza principali

Fino a 14 immagini di riferimento in un'unica richiesta——la pipeline immagine-a-immagine può ricevere fino a 14 immagini di riferimento in una volta, vincolando personaggi, stile o impaginazione tramite più immagini e riducendo i costi di assemblaggio delle generazioni a lotti.
Output diretto in tre livelli di risoluzione——è possibile scegliere la risoluzione di output tra 1K, 2K e 4K; le immagini ad alta risoluzione non richiedono passaggi di super-resolution aggiuntivi.
15 orientamenti di formato——dal quadrato 1:1 all'ultra-wide 8:1 e al verticale 9:16, tutti specificabili direttamente nei parametri, oppure affidati alla modalità auto adattiva.

Descrizione delle capacità

Generazione testo-immagine ed editing con immagini di riferimento：il prompt è l'input principale, con la possibilità opzionale di allegare immagini di riferimento per trasformazioni o riutilizzo dello stile; la stessa interfaccia copre sia la generazione da zero sia la riscrittura basata su materiali esistenti.

Controllo parametrico delle specifiche di output：risoluzione, rapporto d'aspetto e formato di output sono dichiarati esplicitamente nei parametri della richiesta, con restituzione in jpg o png, per un inserimento diretto nella pipeline di materiali a valle.

Capienza di prompt lunghi：il campo prompt ha un limite di 20000 caratteri, sufficiente a contenere descrizioni visive complete, vincoli di stile e indicazioni di composizione, senza dover ridurre drasticamente la lunghezza.

Accesso tramite interfaccia unificata：i risultati immagine si ottengono tramite la modalità di chiamata unificata di HiAPI.ai, senza che gli sviluppatori debbano mantenere logiche di integrazione upstream separate per una singola capacità immagine.

Scenari di utilizzo

Produzione in serie di immagini per team marketing——generare in serie immagini promozionali nelle dimensioni delle varie piattaforme tramite prompt testuali, con output separati in 1:1, 16:9 e 9:16, utilizzabili direttamente per social media e materiali pubblicitari.
Esplorazione della coerenza di stile su più immagini per i designer——caricare più immagini di riferimento per vincolare personaggi o stile visivo, producendo serie di immagini stilisticamente coerenti per confronti di concept e iterazioni di proposte.
Output in 4K per materiali stampati ed espositivi——generare immagini a risoluzione 4K con formato specificato, per poster, pannelli espositivi e materiali con requisiti precisi di nitidezza e rapporto d'aspetto.

Limiti e suggerimenti di scelta

I confini delle capacità sono determinati dai parametri attuali: viene restituita una sola immagine per richiesta, non sono disponibili controlli su numero di immagini batch, durata di generazione o contenuti video, né parametri riproducibili come il seed; il prompt è obbligatorio e senza di esso non è possibile generare. Le immagini di riferimento vengono passate tramite URL e sono al massimo 14. Se l'attività richiede editing a livello di pixel rigoroso, controllo casuale riproducibile o output multipli in batch, si consiglia di verificare prima i risultati su un piccolo campione e poi decidere se inserirlo nel processo produttivo.

Domande frequenti

Vedi tutte le domande →

A quali attività è principalmente adatto Nano Banana 2?

Supporta immagini di riferimento opzionali, formati più ricchi e risoluzioni più elevate; può essere utilizzato per la generazione e il ridisegno di immagini.
Nano Banana 2 supporta le immagini di riferimento?

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

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

In base al 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: nano-banana-2

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

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

promptstringObbligatoriomaxLength 20000

Prompt testuale che descrive l'immagine da generare, fornendo la base contenutistica per la generazione dell'immagine.

resolutionstringOpzionalePredefinito: "1K"

Controlla la risoluzione dell'immagine generata, espresso come stringa, valore predefinito 1K.

Opzioni:1K2K4K

image_inputarrayOpzionalemaxItems 14

Array opzionale di URL di immagini di input, utilizzato per trasformazioni dell'immagine o come immagine di riferimento, supporta fino a 14 immagini.

Array [ string ]

aspect_ratiostringOpzionalePredefinito: "auto"

Controlla le proporzioni dell'immagine generata, espresso come stringa, valore predefinito auto.

Opzioni:1:11:41:82:33:23:44:14:3

Mostra tutto (7)

4:55:48:19:1616:921:9auto

output_formatstringOpzionalePredefinito: "png"

Controlla il formato dell'immagine di output, espresso come stringa, valore predefinito png.

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": "nano-banana-2",
  "input": {
    "prompt": "…",
    "resolution": "1K",
    "aspect_ratio": "auto",
    "output_format": "png"
  }
}'

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",
    input: {
      "prompt": "…",
      "resolution": "1K",
      "aspect_ratio": "auto",
      "output_format": "png"
    }
  }),
});
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",
        "input": {
          "prompt": "…",
          "resolution": "1K",
          "aspect_ratio": "auto",
          "output_format": "png"
        }
    },
)
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"
    }
  }
}