Google

Nano Banana

gemini-nano-banana-2.1

Für die natürlichsprachliche Bildgenerierung und mehrrundige konversationsbasierte Bildbearbeitung, wobei bei der Bearbeitung die Konsistenz von Charakteren und Motiven gut erhalten bleibt und Generierung, Bearbeitung und Verbesserung abgedeckt werden

gemini-nano-banana-2.1 nano-banana

gemini-nano-banana-2.1 ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

image

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

Preise

gemini-nano-banana-2.1 per image

Spezifikationen	Einzelpreis
1K	$0.022
2K	$0.036
4K	$0.058

Einordnung und Kurzprofil

gemini-nano-banana-2.1 ist ein Modell für Bildgenerierung und -bearbeitung, das sowohl Text-zu-Bild als auch Bild-zu-Bild unterstützt. Entwickler übergeben über die einheitliche Schnittstelle von HiAPI.ai einen Prompt, um ein Bild zu erzeugen, oder laden bis zu 10 Referenzbilder hoch, um lokale Änderungen, Multi-Bild-Fusion und subjektkonsistente fortlaufende Bearbeitung durchzuführen. Die Ausgabe ist optional in 1K- bis 4K-Auflösung und verschiedenen Seitenverhältnissen verfügbar und eignet sich für Teams, die schnell kommerzielle visuelle Assets produzieren, kreative Iterationen durchführen oder Bildverbesserungen abschließen möchten.

Kernhighlights

Generierung und Bearbeitung in einem einzigen Modell abgedeckt – Dasselbe Modell unterstützt sowohl reine Textgenerierung als auch Änderungen und Fusionen auf Basis von Referenzbildern, wodurch der Aufwand für den Modellwechsel zwischen verschiedenen Aufgaben reduziert wird.
Mehrrundige Bearbeitung mit Subjektkonsistenz – Bei konversationeller, fortlaufender Bearbeitung bleibt die Konsistenz von Personen und Subjekten gut erhalten, ideal für kreative Iterationen, bei denen dieselbe Figur über mehrere Runden fortgeführt werden soll.
Fusion von bis zu 10 Referenzbildern – Es können mehrere Bilder gleichzeitig für Aufgaben wie Szenenkomposition und Farbkombination übergeben werden, wodurch der Vorverarbeitungsaufwand für das Zusammensetzen mehrerer Materialien sinkt.
Feine Kontrolle über Auflösung und Bildformat – Unterstützt die drei Klarheitsstufen 1K, 2K und 4K sowie über zehn Seitenverhältnisse, sodass Ausgabespezifikationen direkt auf den Ausspielkanal abgestimmt werden können.

Funktionsbeschreibung

Text-zu-Bild mit natürlicher Sprache: Beschreiben Sie das Bild mit einem Prompt, um ein Bild zu erzeugen. Das Modell versteht komplexe Anweisungen gut und eignet sich dafür, aus einer Konzeptbeschreibung direkt einen verwendbaren visuellen Entwurf zu erhalten.

Referenzbildgestützte Bildbearbeitung: Durch Hochladen von Referenzbildern zusammen mit Änderungsanforderungen können Hintergrundaustausch, Hinzufügen oder Entfernen von Objekten, Anpassung von Textur und Beleuchtung sowie lokale Feinkorrekturen durchgeführt werden.

Multi-Bild-Fusion und Szenenkomposition: Es können bis zu 10 Referenzbilder gleichzeitig übergeben werden, um Objekte in eine bestimmte Szene zu platzieren oder Farbschemata zusammenzuführen – geeignet für Produktszenenbilder und die Erstellung von Compositing-Materialien.

Ausgabespezifikationen nach Bedarf: Wählbar sind Auflösungen von 1K bis 4K, fünfzehn Seitenverhältnisse sowie die Formate JPG oder PNG. Die Ausgabe entspricht direkt den Kanalanforderungen und reduziert Nachbearbeitung.

Anwendungsfälle

Erstellung von Marketing- und Social-Media-Materialien – Geben Sie das Kampagnenthema und eine Beschreibung der Markenelemente ein, um Werbebilder in verschiedenen Seitenverhältnissen zu erzeugen, die für Social-Media-Ausspielung und schnelle Erstellung von Werbematerialien genutzt werden können.
Fortlaufende kreative Iteration mit konsistenten Figuren – Kombinieren Sie Personen-Referenzbilder mit mehrrundigen Bearbeitungsanweisungen, um Storyboards und Charakterdesigns zu erstellen, die für Animationsvorvisualisierungen oder Serieninhalte verwendet werden.
Produktszenenbilder und Hintergrundaustausch – Laden Sie Produktbilder hoch und beschreiben Sie die Zielszene, um Produktpräsentationsbilder mit Umgebungslicht und -schatten zu synthetisieren, die für E-Commerce-Detailseiten und Katalogmaterialien genutzt werden.
Restaurierung und Kolorierung alter Fotos – Geben Sie das zu restaurierende Foto ein und beschreiben Sie die Verbesserungsanforderungen, um ein geschärftes oder koloriertes Bild zu erhalten, das für die Archivpflege und die Bewahrung von Familienbildern genutzt wird.
Konzeptprototypen und Illustrationen für schematische Darstellungen – Erzeugen Sie Konzeptbilder auf Basis von Textbeschreibungen oder Strukturskizzen für Design-Reviews, Lehrmaterialien und visuelle Erläuterungen in Präsentationen.

Einschränkungen und Auswahlhinweise

Das Modell ist auf Bildausgaben ausgerichtet und verarbeitet weder Text-Frage-Antworten noch Videogenerierung; die maximale Auflösung liegt bei 4K, bei Bedarf an höher aufgelösten Ausgaben ist eine separate Hochskalierung erforderlich. Die Ergebnisse von mehrrundiger Bearbeitung und Multi-Bild-Fusion hängen von der Qualität der Prompts und Referenzbilder ab; bei komplexen Compositing-Aufgaben wird empfohlen, zunächst in kleinen Stichproben zu validieren. Wenn die Aufgabe vor allem in der schnellen Massenbilderzeugung besteht, kann die Modellfamilie nano-banana geprüft werden; wenn komplexe Workflows mit langem Kontext benötigt werden, sollte die Versionsfähigkeit vor der Auswahl bestätigt werden. Ausgaben können unsichtbare Herkunftskennzeichnungen enthalten, was bei der Nutzung für Urheberrechtszuordnungszwecke im Voraus zu bewerten ist.

Häufige Fragen

Alle Fragen ansehen →

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

Ein universelles Bildgenerierungsmodell für Illustrationen, Fotografie, Produktkonzepte und Social-Media-Visuals.
Unterstützt Nano Banana Referenzbilder?

Die aktuelle Leitung ist reine Text-zu-Bild-Generierung und akzeptiert keine Referenzbilder.
Welche Ausgabespezifikationen werden unterstützt?

Die aktuelle Seite zeigt 1K sowie auto, 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9; die letztendlich verfügbaren Optionen richten sich nach den Playground-Parametern.
Wie wird Nano Banana abgerechnet?

Die Abrechnung erfolgt nach der Anzahl erfolgreich generierter Bilder; etwaige Unterschiede bei verschiedenen Auflösungen oder Qualitätsstufen 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: gemini-nano-banana-2.1

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

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

promptstringPflichtminLength 1maxLength 20000

Prompt zur Beschreibung des zu generierenden Bildinhalts oder zur Angabe von Änderungswünschen an ein Referenzbild; als String übergeben.

resolutionstringOptionalStandard: "1K"

Klarheitsstufe des Ausgabebildes, als String; Standard 1K.

Optionen:1K2K4K

image_inputarrayOptionalmaxItems 10

Array von Referenzbildern, deren Elemente Bilder zur Bildbearbeitung oder -zusammenführung sind; unterstützt JPEG, PNG, WebP, jeweils maximal 30 MB; die Unterfelder verfügen über eigene Erläuterungen.

Array [ string ]

aspect_ratiostringOptionalStandard: "auto"

Seitenverhältnis des Bildes, als String; Standard auto, wobei der automatische Modus das Verhältnis anhand der Eingabe bestimmt.

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

Alle anzeigen (7)

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

output_formatstringOptionalStandard: "jpg"

Dateiformat des Ausgabebildes, als String; Standard jpg.

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

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