Google

Nano Banana 2

nano-banana-2

Googles schnelles Bildmodell für die Bilderzeugung in großem Maßstab, unterstützt 512px bis natives 4K und verschiedene Seitenverhältnisse, generiert mit Echtzeitinformationen aus der Suche und eignet sich für häufige kreative Arbeit

nano-banana-2

nano-banana-2 ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

image

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

nano-banana-2 per image

Spezifikationen	Einzelpreis
1K	$0.036
2K	$0.057
4K	$0.086

Positionsübersicht

nano-banana-2 ist ein von Google entwickeltes Bildgenerierungsmodell, das sowohl Text-zu-Bild als auch referenzbildbasierte Bearbeitung unterstützt. Es ermöglicht Entwicklern, mit einem Prompt von bis zu 20000 Zeichen und bis zu 14 Referenzbildern in einem Durchgang ein Bild im gewählten Seitenverhältnis und in der gewählten Auflösung zu erzeugen. Es eignet sich für Teams, die Marketingmaterialien in großen Mengen produzieren, kreative Entwürfe schnell iterieren oder die Stilkonsistenz mithilfe von Referenzbildern sicherstellen möchten – aufrufbar über die einheitliche Schnittstelle von HiAPI.ai.

Kernhighlights

Bis zu 14 Referenzbilder pro Durchgang – In der Bild-zu-Bild-Pipeline können bis zu 14 Referenzbilder auf einmal übergeben werden, um Figuren, Stil oder Layout mit mehreren Bildern zu steuern und den Aufwand für das Zusammensetzen mehrerer Generierungsrunden zu reduzieren.
Drei Auflösungsstufen direkt verfügbar – Die Ausgabeauflösung kann zwischen 1K, 2K und 4K gewählt werden; hochauflösende Bilder benötigen keinen zusätzlichen Upscaling-Schritt.
15 Seitenverhältnisse – Von 1:1 quadratisch bis 8:1 ultrawide und 9:16 Hochformat kann alles direkt in den Parametern angegeben werden, oder man überlässt es dem auto-Modus.

Funktionsübersicht

Text-zu-Bild und referenzbildbasierte Bearbeitung: Der Prompt ist die Haupteingabe, optional können Referenzbilder für Transformationen oder zur Stilübernahme angehängt werden; dieselbe Schnittstelle deckt sowohl die Generierung von Grund auf als auch die Bearbeitung auf Basis von Vorlagen ab.

Parametrisierte Steuerung der Ausgabespezifikationen: Auflösung, Seitenverhältnis und Ausgabeformat werden explizit in den Anforderungsparametern angegeben; zurückgegeben wird jpg oder png, sodass die Ergebnisse direkt in die nachgelagerte Materialpipeline einfließen können.

Aufnahme langer Prompts: Das Feld prompt hat eine Obergrenze von 20000 Zeichen und kann ausführliche Bildbeschreibungen, Stilvorgaben und Kompositionshinweise aufnehmen, ohne dass wegen der Länge stark gekürzt werden muss.

Einheitlicher Schnittstellenzugang: Bildresultate werden über die einheitliche Aufrufmethode von HiAPI.ai abgerufen; Entwickler müssen für eine einzelne Bildfunktion keine separate Upstream-Anbindung pflegen.

Anwendungsfälle

Massenproduktion von Begleitbildern für Marketingteams – Werbebilder für verschiedene Plattformformate werden per Text-Prompt in großen Mengen generiert, jeweils in 1:1, 16:9 und 9:16 ausgegeben und direkt für Social Media und Werbematerialien verwendet.
Erkundung konsistenter Stile über mehrere Bilder durch Designer – Mehrere Referenzbilder werden hochgeladen, um Figuren oder visuellen Stil zu steuern, und es entstehen Serienbilder mit einheitlichem Stil für Konzeptvergleiche und die Iteration von Entwürfen.
4K-Ausgabe für Druck- und Ausstellungsmaterialien – Bilder werden mit 4K-Auflösung und im angegebenen Seitenverhältnis erzeugt, für Poster, Ausstellungstafeln und andere Materialien mit klaren Anforderungen an Schärfe und Seitenverhältnis.

Einschränkungen und Auswahlhinweise

Die Leistungsgrenzen richten sich nach den aktuellen Parametern: Pro Durchgang wird nur ein Bild ausgegeben; es gibt keine Steuerungsoptionen für Stückzahl, Generierungsdauer oder Video, und auch reproduzierbare Parameter wie Seeds werden nicht angeboten. prompt ist ein Pflichtfeld; ohne Prompt ist keine Generierung möglich. Referenzbilder werden per URL übergeben, maximal 14 Stück. Wenn die Aufgabe eine strenge pixelgenaue Bearbeitung, reproduzierbare Zufallssteuerung oder die Ausgabe mehrerer Bilder in großer Zahl erfordert, empfiehlt es sich, die Ergebnisse zunächst an einer kleinen Stichprobe zu prüfen und dann zu entscheiden, ob der Einsatz in den Produktionsprozess aufgenommen wird.

Häufige Fragen

Alle Fragen ansehen →

Für welche Aufgaben ist Nano Banana 2 hauptsächlich geeignet?

Unterstützt optionale Referenzbilder, vielfältige Bildformate und höhere Auflösungen; einsetzbar für Bildgenerierung und Neugestaltung.
Unterstützt Nano Banana 2 Referenzbilder?

Unterstützt bis zu 14 optionale Referenzbilder; ohne Upload kann es als reine Text-zu-Bild-Generierung verwendet werden.
Welche Ausgabespezifikationen werden unterstützt?

Die aktuelle Seite zeigt 1K, 2K, 4K sowie 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; die final verfügbaren Optionen richten sich nach den Playground-Parametern.
Wie wird Nano Banana 2 abgerechnet?

Die Abrechnung erfolgt nach der Anzahl erfolgreich generierter Bilder; etwaige Unterschiede je nach Auflösung oder Qualitätsstufe werden im Echtzeitpreis auf der Seite angezeigt.

Generierungsaufgabe erstellen

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

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: nano-banana-2

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für nano-banana-2 und Route default — siehe Parametertabelle unten.

promptstringPflichtmaxLength 20000

Der Text-Prompt zur Beschreibung des zu generierenden Bildes, der die inhaltliche Grundlage für die Bilderzeugung liefert.

resolutionstringOptionalStandard: "1K"

Steuert die Auflösung des generierten Bildes, als Zeichenkette, Standardwert 1K.

Optionen:1K2K4K

image_inputarrayOptionalmaxItems 14

Optionales Array von Eingabebild-URLs für Bildtransformationen oder als Referenzbilder, unterstützt bis zu 14 Bilder.

Array [ string ]

aspect_ratiostringOptionalStandard: "auto"

Steuert das Seitenverhältnis des generierten Bildes, als Zeichenkette, Standardwert auto.

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

Alle anzeigen (7)

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

output_formatstringOptionalStandard: "png"

Steuert das Format des Ausgabebildes, als Zeichenkette, Standardwert png.

Optionen:jpgpng

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
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"
}

Aufgabendetails abrufen

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

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "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 Bearbeitung (nicht final)

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

Fehlgeschlagen

{
  "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"
    }
  }
}