# Nano Banana 2

> Genera y edita imágenes con Nano Banana 2 (Gemini 3.1 Flash Image Preview) de Google, para iteración rápida y control de aspect-ratio y resolución de 512px a 4K.

Fuente: https://skillsagentes.com/skills/intellectronica/agent-skills/nano-banana-2
Markdown: https://skillsagentes.com/skills/intellectronica/agent-skills/nano-banana-2.md

Repositorio: https://github.com/intellectronica/agent-skills
Autor: intellectronica
Licencia: CC0-1.0
Actualizado: hace 7 meses
Coste de contexto: 69 tok instalada, 977 tok al activarse, 2.6k tok con todos los archivos del bundle
Bundle: 2 archivos, 10 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add intellectronica/agent-skills --skill nano-banana-2 --agent claude-code
# Cursor
npx -y skills add intellectronica/agent-skills --skill nano-banana-2 --agent cursor
# Codex
npx -y skills add intellectronica/agent-skills --skill nano-banana-2 --agent codex
# Gemini CLI
npx -y skills add intellectronica/agent-skills --skill nano-banana-2 --agent gemini
# Windsurf
npx -y skills add intellectronica/agent-skills --skill nano-banana-2 --agent windsurf
# Cline
npx -y skills add intellectronica/agent-skills --skill nano-banana-2 --agent cline
```

## Qué hace

- Genera imágenes nuevas o edita imágenes existentes con Nano Banana 2 (gemini-3.1-flash-image-preview) vía script uv run generate_image.py
- Controla resolución (512px a 4K) y aspecto (1:1, 9:16, 16:9, etc.) según lenguaje del usuario
- Acepta hasta 14 imágenes de referencia con --input-image para preservar consistencia de personaje u objeto
- Genera nombres de archivo con formato yyyy-mm-dd-hh-mm-ss-name.png y guarda el PNG resultante
- Resuelve la API key vía --api-key o la variable GEMINI_API_KEY, con error claro si falta

## Cuándo usarla

- El usuario pide crear o modificar imágenes
- Se necesita iteración rápida, control explícito de aspect-ratio o control de resolución de 512px a 4K

## Qué la activa

- "Genera una imagen 4K panorámica de un skyline futurista al atardecer"
- "Edita este logo y este personaje para crear una imagen de campaña en 4:5"
- "Crea un borrador rápido en 512px de un jardín japonés"
- "Hazme un wallpaper vertical 9:16 para el teléfono"

## Antes de instalar

- Requiere uv, el script generate_image.py del skill y una API key de Gemini (vía --api-key o GEMINI_API_KEY).
- Variables de entorno: GEMINI_API_KEY
- needs API credentials

## Archivos

- SKILL.md — 4 KB
- scripts/generate_image.py — 7 KB

## SKILL.md

Reproducido tal cual desde intellectronica/agent-skills bajo CC0-1.0. Esta sección es el documento original y está en inglés.

# Nano Banana 2 Image Generation & Editing

Generate new images or edit existing images with Nano Banana 2 (`gemini-3.1-flash-image-preview`).

## Usage

Run the script using absolute or workspace-relative path (do NOT cd into the skill directory first):

**Generate new image:**
```bash
uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "your image description" --filename "output-name.png" [--resolution 512px|1K|2K|4K] [--aspect-ratio RATIO] [--api-key KEY]
```

**Edit image(s) with references:**
```bash
uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "editing instructions" --filename "output-name.png" --input-image "path/to/input1.png" [--input-image "path/to/input2.png" ...] [--resolution 512px|1K|2K|4K] [--aspect-ratio RATIO] [--api-key KEY]
```

Always run from the user's current working directory so outputs are saved in the active project context.

## Model

Use model code:
- `gemini-3.1-flash-image-preview` (Nano Banana 2)

Do not use `gemini-3-pro-image-preview` in this skill.

## Resolution Options

Nano Banana 2 supports:
- `512px` (fastest, low-latency iteration)
- `1K` (default)
- `2K`
- `4K`

Map common user language:
- "quick draft", "thumbnail", "tiny", "512", "0.5K" → `512px`
- no resolution mention → `1K`
- "2K", "medium", "normal" → `2K`
- "4K", "high-res", "ultra", "print quality" → `4K`

Use uppercase `K` for `1K`, `2K`, `4K`.

## Aspect Ratios

Supported aspect ratios:
- `1:1`, `1:4`, `1:8`, `2:3`, `3:2`, `3:4`, `4:1`, `4:3`, `4:5`, `5:4`, `8:1`, `9:16`, `16:9`, `21:9`

Map common requests:
- square post / icon → `1:1`
- phone wallpaper / vertical reel → `9:16`
- widescreen / slide / hero image → `16:9`
- cinematic wide → `21:9`
- portrait print → `2:3` or `3:4`
- panorama banner → `4:1` or `8:1`

If unspecified, let the model default behavior apply.

## Reference Images (New in Gemini 3 Image workflows)

Provide up to 14 reference images when needed by repeating `--input-image`:
- preserve character consistency
- preserve object fidelity
- combine multiple visual references into one output

Use one image for simple edits; use multiple images for composition or consistency-sensitive tasks.

## API Key

Resolve API key in this order:
1. `--api-key` argument
2. `GEMINI_API_KEY` environment variable

If no key is available, stop and report a clear error.

## Filename Generation

Generate filenames as: `yyyy-mm-dd-hh-mm-ss-name.png`

Examples:
- `2026-02-26-17-31-04-japanese-garden.png`
- `2026-02-26-17-31-59-social-banner.png`

## Prompt Handling

For generation, pass the user's request as-is unless critically underspecified.
For editing, include explicit transformation instructions in the prompt and preserve the original intent.

## Output

- Save PNG to the current directory (or to a provided path in `--filename`)
- Return the full saved path(s)
- Do not read the output image back unless explicitly requested

## Examples

**Create a 4K widescreen image:**
```bash
uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "Futuristic city skyline at blue hour with neon reflections" --filename "2026-02-26-17-45-00-futuristic-skyline.png" --resolution 4K --aspect-ratio 16:9
```

**Edit with multiple references:**
```bash
uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "Create a polished campaign image that keeps the exact logo details and character identity" --filename "2026-02-26-17-50-10-campaign-image.png" --input-image "logo.png" --input-image "character.png" --resolution 2K --aspect-ratio 4:5
```

## Dónde encaja

- Categoría: [Diseño y UI](https://skillsagentes.com/categorias/diseno-ui.md) — Sistemas de diseño, trabajo con componentes y acabado visual.
- Creador: [intellectronica](https://skillsagentes.com/creators/intellectronica.md) — 22 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)