What is nano-banana-skill?

The Nano Banana Skill integrates Google Gemini's powerful image generation and editing capabilities directly into the Claude environment. It enables users to generate high-quality visual assets from text prompts, perform AI-driven image modifications, and manage creative workflows with granular control over aspect ratios, quality levels, and model selection (Flash vs. Pro).

When should I use nano-banana-skill?

nano-banana-skill is useful in the following scenarios: • Marketing & Social Media: Rapidly generate tailored visuals for different platforms using specific aspect ratios like 16:9 for banners or 9:16 for stories. • Brand Identity Design: Create professional logos, icons, and minimalist brand assets by leveraging the high-precision Gemini Pro model. • AI Image Transformation: Edit existing photographs to add new elements, change backgrounds, or apply artistic style transfers such as watercolor or cyberpunk aesthetics. • Concept Art & Prototyping: Visualize complex ideas and environments for creative projects, providing a fast way to iterate on visual concepts through natural language.

name	nano-banana-skill
description	Generate and edit images using Google Gemini's Nano Banana image generation API via undyapi.com proxy. Use when users want to generate images from text descriptions, edit existing images with AI, or create visual content. Supports aspect ratio and quality control.

Nano Banana Skill

A Claude Code Skill for AI-powered image generation and editing using Google Gemini's Nano Banana models.

When to Use This Skill

Activate this skill when users request:

Image generation from text descriptions
AI image editing or modification
Creating visual content with specific styles
Generating images with custom aspect ratios

Trigger phrases:

"Generate an image of..."
"Create a picture of..."
"Edit this image to..."
"Make an image with..."
"生成图片"
"创建图片"
"编辑图片"
"AI 绘图"

Prerequisites

API Key: Set environment variable NANO_BANANA_API_KEY
```
export NANO_BANANA_API_KEY="your-api-key"
```
Required tools: curl, jq, base64

Available Models

Model	ID	Best For
Flash	`gemini-2.5-flash-image`	Fast generation, high volume
Pro	`gemini-3-pro-image-preview`	Professional quality, complex prompts

Quick Start

Text to Image Generation

# Basic generation
bash ~/.claude/skills/nano-banana-skill/scripts/generate.sh \
  -p "A cute cat wearing a space helmet on Mars" \
  -o ./output

# With aspect ratio
bash ~/.claude/skills/nano-banana-skill/scripts/generate.sh \
  -p "A panoramic mountain landscape at sunset" \
  -o ./output \
  -r 16:9

# Using Pro model for higher quality
bash ~/.claude/skills/nano-banana-skill/scripts/generate.sh \
  -p "A detailed portrait of a robot philosopher" \
  -o ./output \
  -m pro \
  -q high

Image Editing

# Edit an existing image
bash ~/.claude/skills/nano-banana-skill/scripts/generate.sh \
  -p "Add a rainbow in the sky" \
  -i ./input/photo.jpg \
  -o ./output

# Style transfer
bash ~/.claude/skills/nano-banana-skill/scripts/generate.sh \
  -p "Transform this photo into a watercolor painting" \
  -i ./input/photo.png \
  -o ./output \
  -m pro

Parameters

Parameter	Short	Description	Default
`--prompt`	`-p`	Text description (required)	-
`--image`	`-i`	Input image path for editing	-
`--output`	`-o`	Output directory	`./`
`--ratio`	`-r`	Aspect ratio	`1:1`
`--quality`	`-q`	Quality level	`medium`
`--model`	`-m`	Model: flash/pro	`flash`

Aspect Ratios

1:1 - Square (default)
16:9 - Widescreen landscape
9:16 - Portrait (stories/reels)
4:3 - Standard landscape
3:4 - Standard portrait

Quality Levels

low - Faster generation, smaller file
medium - Balanced (default)
high - Best quality, slower

Examples

1. Generate a Logo

bash ~/.claude/skills/nano-banana-skill/scripts/generate.sh \
  -p "A minimalist logo for a coffee shop called 'Bean Dreams', modern flat design, warm colors" \
  -o ./logos \
  -r 1:1 \
  -m pro \
  -q high

2. Create Social Media Content

# Instagram post (square)
bash ~/.claude/skills/nano-banana-skill/scripts/generate.sh \
  -p "Aesthetic flat lay of coffee and pastries, soft morning light" \
  -o ./social \
  -r 1:1

# Instagram story (portrait)
bash ~/.claude/skills/nano-banana-skill/scripts/generate.sh \
  -p "Motivational quote background, gradient sunset colors" \
  -o ./social \
  -r 9:16

3. Edit Product Photos

bash ~/.claude/skills/nano-banana-skill/scripts/generate.sh \
  -p "Remove the background and add a professional studio backdrop" \
  -i ./product.jpg \
  -o ./edited \
  -m pro

4. Concept Art

bash ~/.claude/skills/nano-banana-skill/scripts/generate.sh \
  -p "Futuristic cyberpunk city street at night, neon lights reflecting on wet pavement, detailed concept art" \
  -o ./concept \
  -r 16:9 \
  -m pro \
  -q high

API Endpoints

Primary: https://undyapi.com
Backup 1: https://vip.undyingapi.com
Backup 2: https://vip.undyingapi.site

For detailed API documentation, see REFERENCE.md.

Troubleshooting

API Key Not Found

Error: NANO_BANANA_API_KEY environment variable not set

Solution: Export your API key: export NANO_BANANA_API_KEY="your-key"

Rate Limited

Error: 429 Too Many Requests

Solution: Wait a moment and retry, or use the backup endpoints

Invalid Image Format

Error: Unsupported image format

Solution: Supported formats are JPEG, PNG, GIF, WebP

Best Practices

Be specific in prompts: Include style, mood, lighting, and composition details
Use Pro model for text rendering: Flash model may not render text accurately
Choose appropriate aspect ratios: Match the intended use case
Start with medium quality: Upgrade to high only when needed

Output

Generated images are saved to the specified output directory with timestamped filenames:

nano_banana_20260109_143052.png

The script also outputs:

The full path to the generated image
Any text response from the model (if applicable)

nano-banana-skill

When & Why to Use This Skill

Use Cases