Was macht Nano Banana 2 Bildgenerierung & -bearbeitung?
Generiere neue Bilder oder bearbeite vorhandene Bilder mit der Google Nano Banana 2 API (Gemini 3.1 Flash Image).
Verwendung
Führe das Skript mit absolutem Pfad aus (nicht in das Skill-Verzeichnis wechseln):
Neues Bild generieren:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "deine Bildbeschreibung" --filename "ausgabename.png" [--resolution 512|1K|2K|4K] [--api-key SCHLÜSSEL]
Vorhandenes Bild bearbeiten:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "Bearbeitungsanweisungen" --filename "ausgabename.png" --input-image "pfad/zum/eingabe.png" [--resolution 512|1K|2K|4K] [--api-key SCHLÜSSEL]
Wichtig: Führe das Skript immer vom aktuellen Arbeitsverzeichnis des Benutzers aus, damit die Bilder dort gespeichert werden, wo der Benutzer arbeitet – nicht im Skill-Verzeichnis.
Standard-Workflow (Entwurf → Iterieren → Final)
Ziel: Schnelle Iteration, ohne Zeit mit 4K zu verschwenden, bis der Prompt richtig ist.
- Entwurf (1K): schnelle Rückmeldung
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<Entwurf-Prompt>" --filename "yyyy-mm-dd-hh-mm-ss-entwurf.png" --resolution 1K
- Iterieren: Prompt in kleinen Änderungen anpassen; Dateiname pro Durchlauf neu vergeben
- Beim Bearbeiten: Verwende denselben
--input-imagefür jede Iteration, bis das Ergebnis zufriedenstellend ist.
- Beim Bearbeiten: Verwende denselben
- Final (4K): Erst wenn der Prompt final ist
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<finaler Prompt>" --filename "yyyy-mm-dd-hh-mm-ss-final.png" --resolution 4K
Auflösungsoptionen
Die Gemini 3.1 Flash Image API unterstützt diese Ausgabegrößen:
- 512 - kompakt, etwa 512px-Klasse
- 1K (Standard) - etwa 1024px
- 2K - etwa 2048px
- 4K - etwa 4096px
Zugehörigkeit von Benutzeranfragen zu API-Parametern:
- "512", "512px", "0,5K", "thumbnail", "winzig" →
512 - Keine Angabe zur Auflösung →
1K - "niedrige Auflösung", "1080", "1080p", "1K" →
1K - "2K", "2048", "normal", "mittlere Auflösung" →
2K - "hohe Auflösung", "hochauflösend", "4K", "ultra" →
4K
API-Key
Das Skript prüft den API-Key in dieser Reihenfolge:
--api-keyArgument (verwenden, wenn der Benutzer einen Schlüssel im Chat angegeben hat)GEMINI_API_KEYUmgebungsvariable
Wenn keiner verfügbar ist, beendet sich das Skript mit einer Fehlermeldung.
Vorab-Prüfung + Häufige Fehler (schnelle Lösungen)
-
Vorab-Prüfung:
command -v uv(muss existieren)test -n "$GEMINI_API_KEY"(oder--api-keyübergeben)- Beim Bearbeiten:
test -f "pfad/zum/eingabe.png"
-
Häufige Fehler:
Error: No API key provided.→ setzeGEMINI_API_KEYoder übergib--api-keyError loading input image:→ falscher Pfad / nicht lesbare Datei; prüfe, ob--input-imageauf ein echtes Bild verweist- „quota/permission/403“-API-Fehler → falscher Schlüssel, kein Zugriff oder Kontingent überschritten; versuche einen anderen Schlüssel / Account
Dateinamen-Generierung
Generiere Dateinamen nach dem Schema: yyyy-mm-dd-hh-mm-ss-name.png
Format: {Zeitstempel}-{beschreibender-name}.png
- Zeitstempel: Aktuelles Datum/Uhrzeit im Format
yyyy-mm-dd-hh-mm-ss(24-Stunden-Format) - Name: Beschreibender Kleinbuchstaben-Text mit Bindestrichen
- Halte den beschreibenden Teil kurz (typisch 1–5 Wörter)
- Nutze Kontext aus dem Prompt oder der Unterhaltung des Benutzers
- Bei Unklarheit verwende eine zufällige Kennung (z. B.
x9k2,a7b3)
Beispiele:
- Prompt „Ein ruhiger japanischer Garten“ →
2025-11-23-14-23-05-japanischer-garten.png - Prompt „Sonnenuntergang über Bergen“ →
2025-11-23-15-30-12-sonnenuntergang-berge.png - Prompt „Erstelle ein Bild eines Roboters“ →
2025-11-23-16-45-33-roboter.png - Unklarer Kontext →
2025-11-23-17-12-48-x9k2.png
Bildbearbeitung
Wenn der Benutzer ein vorhandenes Bild ändern möchte:
- Prüfe, ob er einen Bildpfad angibt oder auf ein Bild im aktuellen Verzeichnis verweist
- Verwende den Parameter
--input-imagemit dem Pfad zum Bild - Der Prompt sollte Bearbeitungsanweisungen enthalten (z. B. „mach den Himmel dramatischer“, „entferne die Person“, „ändere in Cartoon-Stil“)
- Typische Bearbeitungsaufgaben: Elemente hinzufügen/entfernen, Stil ändern, Farben anpassen, Hintergrund unscharf machen usw.
Prompt-Handhabung
Bei Generierung: Gib die Bildbeschreibung des Benutzers unverändert an --prompt weiter. Nur überarbeiten, wenn sie eindeutig unzureichend ist.
Bei Bearbeitung: Übergib die Bearbeitungsanweisungen an --prompt (z. B. „füge einen Regenbogen in den Himmel ein“, „mach es wie ein Aquarellgemälde“)
Bewahre in beiden Fällen die kreative Absicht des Benutzers.
Prompt-Vorlagen (hohe Trefferquote)
Nutze diese Vorlagen, wenn der Benutzer vage ist oder Änderungen präzise sein müssen.
-
Generierungsvorlage:
- „Erstelle ein Bild von: . Stil: . Komposition: <Kamera/Einstellung>. Beleuchtung: . Hintergrund: . Farbpalette: . Vermeide: .“
-
Bearbeitungsvorlage (alles andere beibehalten):
- „Ändere NUR: <einzelne Änderung>. Behalte identisch: Motiv, Komposition/Beschnitt, Pose, Beleuchtung, Farbpalette, Hintergrund, Text und Gesamtstil. Füge keine neuen Objekte hinzu. Falls Text vorhanden, lass ihn unverändert.“
Ausgabe
- Speichert PNG im aktuellen Verzeichnis (oder im angegebenen Pfad, falls der Dateiname ein Verzeichnis enthält)
- Das Skript gibt den vollständigen Pfad zum generierten Bild aus
- Lese das Bild nicht erneut ein - informiere den Benutzer einfach über den gespeicherten Pfad
Beispiele
Neues Bild generieren:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "Ein ruhiger japanischer Garten mit Kirschblüten" --filename "2025-11-23-14-23-05-japanischer-garten.png" --resolution 4K
Vorhandenes Bild bearbeiten:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "mach den Himmel dramatischer mit Sturmwolken" --filename "2025-11-23-14-25-30-dramatischer-himmel.png" --input-image "original-foto.jpg" --resolution 2K