CommunityBildgithub.com

Nano Banana 2 Bildgenerierung & -bearbeitung

Erzeuge oder bearbeite Bilder mit Googles Nano Banana 2 API (Gemini 3.1 Flash Image). Unterstützt Texteingabe, Bildeingabe und Auflösungen von 512 bis 4K.

Was ist Nano Banana 2 Bildgenerierung & -bearbeitung?

Diese Skill („Nano Banana 2“) ermöglicht es KI-Agenten wie Claude Code, Cursor oder Codex, Bilder zu generieren oder zu bearbeiten – basierend auf der Google Gemini 3.1 Flash Image API. Sie unterstützt die Erstellung völlig neuer Bilder aus Textprompts sowie die Bearbeitung vorhandener Bilder durch Anweisungen wie „füge Regenbogen hinzu“ oder „ändere Stil zu Aquarell“. Die Auflösung kann über Parameter von 512 (klein) bis 4K (ultra-hoch) gesteuert werden, wobei ein empfohlener Workflow (Entwurf → Iteration → Final) clevere API-Nutzung und schnelle Iterationen fördert, ohne frühzeitig teure 4K-Aufrufe zu verschwenden. Der Skill speichert Bilder direkt im aktuellen Arbeitsverzeichnis des Benutzers, verwendet ein konsistentes Dateinamenschema (Zeitstempel + Beschreibung) und prüft automatisch auf API-Key (per Kommandozeilenargument oder Umgebungsvariable GEMINI_API_KEY) sowie auf häufige Fehlerquellen. Er eignet sich besonders für Entwickler, die schnell visuelle Prototypen oder Illustrationen in ihre Projekte integrieren möchten.

Funktioniert mit~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/nano-banana-pro

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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-image für jede Iteration, bis das Ergebnis zufriedenstellend ist.
  • 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:

  1. --api-key Argument (verwenden, wenn der Benutzer einen Schlüssel im Chat angegeben hat)
  2. GEMINI_API_KEY Umgebungsvariable

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. → setze GEMINI_API_KEY oder übergib --api-key
    • Error loading input image: → falscher Pfad / nicht lesbare Datei; prüfe, ob --input-image auf 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:

  1. Prüfe, ob er einen Bildpfad angibt oder auf ein Bild im aktuellen Verzeichnis verweist
  2. Verwende den Parameter --input-image mit dem Pfad zum Bild
  3. Der Prompt sollte Bearbeitungsanweisungen enthalten (z. B. „mach den Himmel dramatischer“, „entferne die Person“, „ändere in Cartoon-Stil“)
  4. 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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Verwandte Skills