Google Nano Banana 2: Schritt-für-Schritt-Anleitung
MidassAI Team · 11. Juli 2026 · 5 min read

Voraussetzungen
Stellen Sie sicher, dass Sie ein Google Cloud-Projekt mit aktivierter Abrechnung und der aktivierten Vertex AI-API (nicht nur der AI Platform-API) besitzen. Installieren Sie die nanobanana-cli ab Version 2.1 über pip install nanobanana-cli==2.1.0.
Schritt 1: Authentifizierung & Konfiguration
Führen Sie nb-auth login aus und folgen Sie dem OAuth-Fluss. Konfigurieren Sie anschließend Ihre Standardregion und Modell-Stufe:
nb-config set region us-central1
cb-config set tier nano-proSchritt 2: Workflow definieren
Erstellen Sie eine Datei workflow.yaml mit einer minimalen, über HTTP ausgelösten Aufgabe:
name: text-summarize-v2
trigger: http
steps:
- model: banana-summarizer-v3
input: "{{ request.body.text }}"
output: summarySchritt 3: Bereitstellen & Testen
Stellen Sie den Workflow mit nb-deploy --file workflow.yaml bereit und rufen Sie ihn auf:
curl -X POST https://us-central1-myproject.cloudfunctions.net/text-summarize-v2 \
-H "Content-Type: application/json" \
-d '{"text":"Nano Banana 2 bietet Unter-100-ms-Latenz und 99,98 % Genauigkeit bei Kurztextaufgaben."}'Schritt 4: Überwachen & Optimieren
Nutzen Sie nb-logs --tail, um Echtzeit-Ausführungsprotokolle zu streamen. Passen Sie bei Latenzspitzen max-concurrency oder timeout-ms in workflow.yaml an.
| Feature | Benefit |
|---|---|
| Speed | Up to 3.2x faster than Nano Banana 1 |
| Quality | +4.7% F1-score on multilingual summarization |
Quick Takeaways
Voraussetzungen und Einrichtung
Bevor Sie Ihren ersten Nano Banana 2-Workflow starten, prüfen Sie drei Grundlagen: Tools, Cloud-Infrastruktur und Modellverfügbarkeit. Erforderlich sind:
nanobanana-cliab Version 2.1.0 (installieren viapip install nanobanana-cli==2.1.0),- Python 3.9+,
gcloudCLI ab Version 425.0.0, authentifiziert mitgcloud auth login.
Ihr Google Cloud-Projekt muss Abrechnung aktiviert haben und die Vertex AI-API (nicht nur die AI Platform-API) – Nano Banana 2 nutzt Vertexs optimierte Inferenz-Endpunkte. Wichtig: Das Modell banana-summarizer-v3 muss in Ihrer Region (us-central1, europe-west3 oder asia-east1) bereitgestellt und im Model Registry Ihres Projekts mit dem Versions-Tag v3.2.1 oder neuer registriert sein. Ältere Versionen fehlen die Latenzoptimierungen und JSON-Schema-Validierung, die Nano Banana 2 für strikte Eingabebindung benötigt.
Auch Kontoberechtigungen sind entscheidend: Ihr Dienstkonto benötigt die Rollen roles/aiplatform.user, roles/cloudfunctions.developer und roles/storage.objectAdmin – nicht nur die Rolle editor. Falls Sie ein benutzerdefiniertes Dienstkonto verwenden (empfohlen statt des Standard-Compute-Kontos), führen Sie folgenden Befehl aus, um stille Bereitstellungsfehler in Schritt 2 zu vermeiden:
gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
--member="serviceAccount:YOUR_SA@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
--role="roles/aiplatform.user"Erweiterter Prompt-Workflow
Nano Banana 2 unterstützt neben einfachen HTTP-Triggern auch mehrstufige, bedingte und parametrisierte Workflows. So erweitern Sie Ihre erste workflow.yaml zu einer produktionsreifen Pipeline:
Dynamisches Routing hinzufügen: Fügen Sie einen bedingten Schritt ein, der Eingaben nach Länge oder Spracherkennung weiterleitet. Beispiel unter
steps:- name: route-by-length type: condition condition: "{{ len(request.body.text) <= 256 }}" true: summarizer-short false: summarizer-longAusgaben zwischen Modellen verketten: Verwenden Sie
{{ steps.summarizer-short.output.summary }}, um Ausgaben vorheriger Schritte zu referenzieren. Um eine Zusammenfassung mit Sentiment-Analyse anzureichern:- model: banana-sentiment-v2 input: "{{ steps.summarizer-short.output.summary }}" output: sentiment_scoreUmgebungsabhängige Parameter einfügen: Nutzen Sie Variablen aus
nb-config, statt Werte fest einzukodieren. Legen Sie lokalnb-config set env stagingfest und referenzieren Sie sie in YAML:- model: banana-ner-v4 input: "{{ request.body.text }}" parameters: confidence_threshold: "{{ env == 'staging' ? 0.7 : 0.85 }}" max_entities: "{{ env == 'staging' ? 3 : 10 }}"Eingaben vor Ausführung validieren: Fügen Sie einen Vorab-Validierungsschritt ein, um fehlerhafte Payloads frühzeitig abzulehnen:
- name: validate-input type: validator schema: type: object required: [text] properties: text: type: string minLength: 1 maxLength: 2000Wiederholungslogik für instabile externe Dienste konfigurieren: Wenn Sie eine externe API (z. B. Übersetzung) aufrufen, umschließen Sie sie mit einem robusten Schritt:
- model: banana-translate-v1 input: "{{ steps.summarizer-short.output.summary }}" retries: 2 backoff: exponential timeout-ms: 800
Häufige Fehler
Verwendung veralteter Modellversionen: Die Bereitstellung von
banana-summarizer-v3ohne explizite Angabe vonversion: v3.2.1im Workflow-YAML führt zur Standardversionv3.0.0, die Nano Banana 2s Token-Bucket-Rate-Limiting fehlt und bei Hochlast-Bursts HTTP 422 zurückgibt. Lösung: Geben Sie in jedem Schritt explizitmodel: [email protected]an.Überschreiben von
nb-config-Einstellungen pro Bereitstellung: Der Befehlnb-deploy --region europe-west3überschreibt zwar die globale Konfiguration, speichert sie aber nicht dauerhaft – späterenb-logs-Aufrufe schlagen fehl, da sie standardmäßigus-central1lesen. Lösung: Führen Sie vor der Bereitstellungnb-config set region europe-west3aus und überprüfen Sie mitnb-config get region.Ignorieren der Payload-Größenbegrenzung bei HTTP-Triggern: Nano Banana 2 erzwingt strikt eine maximale Request-Body-Größe von 1,5 MB für HTTP-getriggerte Workflows. Das Senden einer 2-MB-JSON mit base64-kodierten Bildern führt stumm zu HTTP 400 – ohne Log-Eintrag. Lösung: Komprimieren Sie große Payloads clientseitig (z. B.
gzip -c payload.json | curl -H "Content-Encoding: gzip" ...) oder wechseln Sie bei Daten >1 MB zu Pub/Sub-Triggern.
Probieren Sie es in MidassAI aus
Sie können diesen Workflow – inklusive bedingtem Routing, Multi-Modell-Verkettung und umgebungsabhängigen Parametern – direkt in MidassAI Studio reproduzieren und iterativ verbessern, ohne CLI-Tools zu installieren oder Google Cloud IAM-Rollen zu verwalten. Öffnen Sie MidassAI Studio unter https://www.midassai.com/studio/nano/, wählen Sie „Nano Banana 2“ aus dem Runtime-Dropdown-Menü, fügen Sie Ihren workflow.yaml-Inhalt in den visuellen Editor ein und klicken Sie auf „Run Test“. Studio richtet automatisch einen isolierten Vertex AI-Endpunkt ein, validiert Ihre YAML in Echtzeit anhand der Nano Banana 2-Schemaregeln und zeigt Latenz-Heatmaps sowie Fehlerprotokolle direkt in der Oberfläche an. Keine Projekt-ID, kein Dienstkonto, keine Abrechnungseinrichtung nötig – einfach einfügen, anpassen und innerhalb von 90 Sekunden bereitstellen.