Migration von Nano Banana 2 auf 2.1: Welche API-Änderungen nötig sind

Nano Banana 2.1 nutzt weiterhin die asynchrone Task-Schnittstelle von HiAPI, daher ist der Migrationsaufwand im Code gering, aber einige Eingabebeschränkungen müssen erneut überprüft werden. Die offensichtlichste Änderung betrifft den model-Wert; auch die Anzahl der Referenzbilder und die maximale Dateigröße pro Bild haben sich geändert. Preise sollten anhand der aktuellen Seite und der Task-Aufzeichnungen vor der Veröffentlichung geprüft werden.

Dieser Artikel basiert auf dem aktuellen Interface-Vertrag der Nano Banana 2 Modellseite und der Nano Banana 2.1 Modellseite. Die Beispiele verwenden die in der aktuellen Dokumentation beschriebene Anfragestruktur; vor dem Umschalten von Produktionsverkehr sollten sie in einem Testkonto mit Guthaben verifiziert werden.

Minimale Änderung: model ersetzen

Beide Versionen werden über asynchrone Task-Erstellung genutzt:

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": "A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering",
      "resolution": "1K",
      "aspect_ratio": "1:1",
      "output_format": "png"
    }
  }'

Wenn die ursprüngliche Anfrage eine Text-zu-Bild-Generierung war, besteht die Migration im Wesentlichen darin, model zu ändern:

- "model": "nano-banana-2"
+ "model": "gemini-nano-banana-2.1"

Die in der Dokumentation beschriebene Schnittstelle ist weiterhin POST /v1/tasks. Nach Annahme der Anfrage gibt die Erstellungs-Schnittstelle eine Task-ID zurück, die für Polling oder Callback-Verarbeitung verwendet wird. Der bestehende Polling- oder Callback-Prozess kann weiterhin genutzt werden, aber die aktuellen Task-Status- und Ergebnisfelder müssen überprüft werden.

Beibehaltbare Felder und erneut zu prüfende Einschränkungen

Der aktuelle Vertrag von 2.1 behält die in Version 2 häufig verwendeten Eingabefelder bei: prompt, optional image_input, aspect_ratio, resolution und output_format. Der folgende Smoke-Test mit Guthaben hat sowohl Text-zu-Bild als auch Referenzbild-Formen akzeptiert; bei der offiziellen Umstellung sollte der Live-Vertrag weiterhin auf Versionsänderungen geprüft werden.

Die Beschränkung für Referenzbilder hat sich geändert. Die Nano Banana 2 Seite gibt maximal 14 Bilder mit 10 MB pro Bild an; die 2.1 Seite gibt maximal 10 Bilder mit 30 MB pro Bild an. Wenn nur die Modell-ID ersetzt wird und weiterhin die alten 14 Bilder übermittelt werden, überschreitet die Anfrage das neue Limit. Der Client sollte die Anzahl gemäß dem neuen Limit prüfen und entscheiden, ob gekürzt oder der Benutzer direkt informiert wird.

Die 2.1 Modellseite veröffentlicht keine mask-Eingabe. Bei der Migration sollte kein mask-Feld eigenmächtig hinzugefügt werden, es sei denn, die nachfolgende API-Dokumentation stellt es ausdrücklich bereit. Bei der Bildbearbeitung wird das Originalbild über image_input übergeben und im prompt klar beschrieben, welche Inhalte geändert werden sollen und welche Details erhalten bleiben müssen.

{
  "model": "gemini-nano-banana-2.1",
  "input": {
    "prompt": "Keep the amber glass serum bottle and black dropper cap from the reference image. Place it on a sunlit wooden bathroom counter beside a folded cream linen towel and eucalyptus, preserving the bottle shape and blank label.",
    "image_input": ["https://static.hiapi.ai/blog/gemini-nano-banana-2-1-ecommerce-product-images/studio.jpg"],
    "resolution": "1K",
    "aspect_ratio": "16:9",
    "output_format": "png"
  }
}

Diese Anfrage wurde im Smoke-Test mit Guthaben erfolgreich abgeschlossen; das Ergebnisbild kann hier angesehen werden. Die 2.1 Seite gibt derzeit an, dass Referenzbilder JPEG, PNG und WebP unterstützen und pro Bild maximal 30 MB groß sein dürfen.

Preise auf zwei Ebenen prüfen

Zum Zeitpunkt der Überprüfung der Modellseite am 2026-10-16 zeigte Nano Banana 2.1 für die Stufen 1K, 2K und 4K jeweils 44, 72 und 116 Credits an. Vor der Budgetplanung bitte die aktuelle Preisseite und die Modellseite prüfen; das Zurücklesen der Abrechnung muss noch unabhängig verifiziert werden.

Promotionspreise oder Zahlen von einer bestimmten Kontoseite sollten nicht als langfristig feste Preise übernommen werden. Bei der Produktionsvalidierung sollten Auflösung, vor der Übermittlung angezeigter Betrag und tatsächliche Abrechnung nach Abschluss des Tasks aufgezeichnet werden.

Denselben Prompt mit zwei model IDs testen

Um den Migrationspfad zu prüfen, haben wir denselben 1K-Prompt im Format 1:1 mit beiden öffentlichen model IDs übermittelt. Beide Anfragen haben erfolgreich Tasks erstellt und den Status success erreicht. Die Details von Flasche und Oberfläche unterscheiden sich in den beiden Bildern; daher eignen sich diese Ergebnisse zur Überprüfung von Routing und Ergebnisverarbeitung, reichen aber nicht für ein Qualitätsranking und belegen auch keine identische Produktidentität.

Der bei beiden Anfragen verwendete Prompt:

A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering

Route	Model ID	Ergebnis
Nano Banana 2	nano-banana-2	1K, 1:1, PNG, Task erfolgreich abgeschlossen
Nano Banana 2.1	gemini-nano-banana-2.1	1K, 1:1, PNG, Task erfolgreich abgeschlossen

Diese Migrationsvalidierung zeigt, dass die model ID von 2.1 die aktuelle dokumentierte Text-zu-Bild-Task-Struktur akzeptiert und Bilder über denselben asynchronen Ablauf zurückgibt. Bildunterschiede in einer einzelnen Stichprobe sind nur Beobachtungen und keine Modellvergleichsergebnisse.

Checkliste vor dem Produktivstart

1. nano-banana-2 durch die exakte neue ID ersetzen: gemini-nano-banana-2.1.
2. Den asynchronen POST /v1/tasks-Ablauf und die bestehende Task-Status-Verarbeitung beibehalten.
3. Prüfen, dass image_input ein Array öffentlicher Bild-URLs mit maximal 10 Bildern ist.
4. Die alte Annahme von 10 MB pro Bild auf das aktuell auf der 2.1 Seite angegebene Limit von 30 MB ändern.
5. prompt, aspect_ratio, resolution und output_format beibehalten und nicht dokumentierte Felder wie mask entfernen.
6. Im Testkonto jeweils einen reinen Text-Task und einen Referenzbild-Bearbeitungs-Task senden und Anfrage, Task-ID, Endstatus, Ergebnis-URL und Abrechnungsbetrag speichern.
7. Ergebnisse und Fehlerbehandlung einmal mit der alten Version vergleichen, bevor das Standardmodell für alle Benutzer umgestellt wird.

Preis-Rücklesen und laufende Pflege

Der obige Smoke-Test hat die Anfragestruktur für Text-zu-Bild und Bild-zu-Bild, die Task-Erstellung, den erfolgreichen Endstatus und die Ergebnis-URL validiert. Die Abrechnung wurde nicht unabhängig aus dem abgeschlossenen Task zurückgelesen; Produktionskosten sollten weiterhin anhand der aktuellen Preisseite und der Task-Aufzeichnungen geprüft werden. Wenn sich vor der Veröffentlichung der Vertrag oder die Beschränkungen auf der Modellseite ändern, müssen diese ebenfalls erneut geprüft werden.

Häufig gestellte Fragen

Muss man bei der Migration auf Nano Banana 2.1 die Schnittstelle wechseln?

Derzeit verwenden beide Modellseiten POST /v1/tasks. Zuerst die Modell-ID ändern, dann mit echten Anfragen die Eingabe- und Rückgabestruktur validieren.

Kann nano-banana-2 weiterhin verwendet werden?

Diese ID steht weiterhin für Nano Banana 2. Wenn 2.1 aufgerufen werden soll, muss gemini-nano-banana-2.1 verwendet werden.

Können nach der Migration noch 14 Referenzbilder übermittelt werden?

Die aktuell auf der 2.1 Modellseite angegebene Obergrenze ist 10 Bilder. Bei Überschreitung sollte der Client die Anzahl reduzieren oder die Anfrage ablehnen.

Muss man für Referenzbild-Bearbeitung eine andere Schnittstelle verwenden?

Die aktuelle Seite hat keine separate Bearbeitungsschnittstelle. Dieselbe Modell-ID weiterverwenden, image_input hinzufügen und im Prompt angeben, was geändert werden soll und welche Details erhalten bleiben müssen.

Ist 2.1 für alle Konten günstiger?

Die öffentliche Seite zeigt derzeit niedrigere Standard-Credit-Zahlen für die jeweiligen Auflösungen, aber Preise können sich ändern und die Seite kann durch Kontostatus oder Aktionen beeinflusst sein. Vor Kostenschlussfolgerungen bitte sowohl den aktuellen Preis als auch die Abrechnungsaufzeichnungen nach abgeschlossenem Task prüfen.

Weiterführende Literatur

• Nano Banana 2.1 API-Integrationsanleitung
• Nano Banana 2.1 API-Preise
• So verwendet man die Nano Banana 2 API

Nano Banana 2.1 auf der HiAPI-Modellseite ausprobieren.