Nano Banana Image Generation & Editing
Multi-provider image generation and editing. Default provider: Tuzi (兔子API, api.tu-zi.com).
Script Directory
Agent Execution:
SKILL_DIR = this SKILL.md file's directory- Script path =
${SKILL_DIR}/scripts/main.ts
Usage
Run the script using absolute path (do NOT cd to skill directory first):
Generate new image:
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "your image description" --filename "output.png" [--resolution 1K|2K|4K] [--provider tuzi|google|openai|dashscope|replicate] [--model MODEL_ID]
Edit existing image:
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "editing instructions" --filename "output.png" --input-image "path/to/input.png" [--resolution 1K|2K|4K]
Important: Always run from the user's current working directory so images are saved where the user is working.
Default Workflow (draft → iterate → final)
Goal: fast iteration without burning time on 4K until the prompt is correct.
- Draft (1K): quick feedback loop
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "<draft prompt>" --filename "yyyy-mm-dd-hh-mm-ss-draft.png" --resolution 1K
- Iterate: adjust prompt in small diffs; keep filename new per run
- If editing: keep the same
--input-image for every iteration until you're happy.
- Final (4K): only when prompt is locked
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "<final prompt>" --filename "yyyy-mm-dd-hh-mm-ss-final.png" --resolution 4K
Options
| Option |
Description |
--prompt <text>, -p |
Prompt text (required) |
--filename <path>, -f |
Output filename (required) |
--input-image <path>, -i |
Input image for editing |
--resolution 1K|2K|4K, -r |
Output resolution (default: 1K) |
--provider tuzi|google|openai|dashscope|replicate |
Force provider (default: auto-detect, Tuzi first) |
--model <id>, -m |
Model ID |
--api-key <key>, -k |
API key (overrides env var) |
Resolution Options
- 1K (default) - ~1024px resolution
- 2K - ~2048px resolution
- 4K - ~4096px resolution
Map user requests:
- No mention of resolution →
1K
- "low resolution", "1080", "1080p", "1K" →
1K
- "2K", "2048", "normal", "medium resolution" →
2K
- "high resolution", "high-res", "hi-res", "4K", "ultra" →
4K
Provider Selection
--provider specified → use it--api-key provided (no --provider) → Google (direct Gemini API)- Only one API key available → use that provider
- Multiple available → Tuzi first
Tuzi Models
| Model ID |
Quality |
Notes |
gemini-3-pro-image-preview |
1k/2k/4k |
Default. High quality |
gemini-3.1-flash-image-preview |
1k/2k/4k |
Fast, extended aspect ratios |
gemini-3-pro-image-preview-vip |
1k built-in |
VIP |
gemini-3-pro-image-preview-2k-vip |
2k built-in |
VIP |
gemini-3-pro-image-preview-4k-vip |
4k built-in |
VIP |
Environment Variables
| Variable |
Description |
TUZI_API_KEY |
Tuzi API key (https://api.tu-zi.com) |
TUZI_IMAGE_MODEL |
Tuzi default model |
TUZI_BASE_URL |
Custom Tuzi endpoint |
GEMINI_API_KEY |
Google Gemini API key |
GOOGLE_API_KEY |
Google API key (alias) |
OPENAI_API_KEY |
OpenAI API key |
DASHSCOPE_API_KEY |
DashScope API key |
REPLICATE_API_TOKEN |
Replicate API token |
Load Priority: CLI --api-key > env vars > <cwd>/.tuzi-skills/.env > ~/.tuzi-skills/.env
Image Editing
When the user wants to modify an existing image:
- Use
--input-image parameter with the path to the image
- The prompt should contain editing instructions
- Resolution auto-detects from input image size if not specified
Prompt Handling
For generation: Pass user's image description as-is to --prompt. Only rework if clearly insufficient.
For editing: Pass editing instructions in --prompt (e.g., "add a rainbow in the sky")
Prompt Templates
- Generation: "Create an image of: . Style: . Composition: <camera/shot>. Lighting: . Background: ."
- Editing: "Change ONLY: . Keep identical: subject, composition, pose, lighting, color palette, background, text, and overall style."
Filename Generation
Pattern: yyyy-mm-dd-hh-mm-ss-name.png
- Timestamp: Current date/time in 24-hour format
- Name: Descriptive lowercase text with hyphens (1-5 words)
Preflight + Common Failures
command -v npx (must exist)- API key must be available (env or
--api-key)
- If editing: input image must exist
Output
- Saves PNG to current directory (or specified path)
- Script outputs the full path to the generated image
- Do not read the image back - just inform the user of the saved path
1---2name: tuzi-nano-banana3description: Generate/edit images via Tuzi API (default), Google Gemini, OpenAI, DashScope, Replicate. Text-to-image + image-to-image editing; 1K/2K/4K resolution. Use for image create/modify/edit requests incl. --input-image.4---56# Nano Banana Image Generation & Editing78Multi-provider image generation and editing. Default provider: Tuzi (兔子API, api.tu-zi.com).910## Script Directory1112**Agent Execution**:131. `SKILL_DIR` = this SKILL.md file's directory142. Script path = `${SKILL_DIR}/scripts/main.ts`1516## Usage1718Run the script using absolute path (do NOT cd to skill directory first):1920**Generate new image:**21```bash22npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "your image description" --filename "output.png" [--resolution 1K|2K|4K] [--provider tuzi|google|openai|dashscope|replicate] [--model MODEL_ID]23```2425**Edit existing image:**26```bash27npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "editing instructions" --filename "output.png" --input-image "path/to/input.png" [--resolution 1K|2K|4K]28```2930**Important:** Always run from the user's current working directory so images are saved where the user is working.3132## Default Workflow (draft → iterate → final)3334Goal: fast iteration without burning time on 4K until the prompt is correct.3536- Draft (1K): quick feedback loop37 - `npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "<draft prompt>" --filename "yyyy-mm-dd-hh-mm-ss-draft.png" --resolution 1K`38- Iterate: adjust prompt in small diffs; keep filename new per run39 - If editing: keep the same `--input-image` for every iteration until you're happy.40- Final (4K): only when prompt is locked41 - `npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "<final prompt>" --filename "yyyy-mm-dd-hh-mm-ss-final.png" --resolution 4K`4243## Options4445| Option | Description |46|--------|-------------|47| `--prompt <text>`, `-p` | Prompt text (required) |48| `--filename <path>`, `-f` | Output filename (required) |49| `--input-image <path>`, `-i` | Input image for editing |50| `--resolution 1K\|2K\|4K`, `-r` | Output resolution (default: 1K) |51| `--provider tuzi\|google\|openai\|dashscope\|replicate` | Force provider (default: auto-detect, Tuzi first) |52| `--model <id>`, `-m` | Model ID |53| `--api-key <key>`, `-k` | API key (overrides env var) |5455## Resolution Options5657- **1K** (default) - ~1024px resolution58- **2K** - ~2048px resolution59- **4K** - ~4096px resolution6061Map user requests:62- No mention of resolution → `1K`63- "low resolution", "1080", "1080p", "1K" → `1K`64- "2K", "2048", "normal", "medium resolution" → `2K`65- "high resolution", "high-res", "hi-res", "4K", "ultra" → `4K`6667## Provider Selection68691. `--provider` specified → use it702. `--api-key` provided (no `--provider`) → Google (direct Gemini API)713. Only one API key available → use that provider724. Multiple available → Tuzi first7374## Tuzi Models7576| Model ID | Quality | Notes |77|----------|---------|-------|78| `gemini-3-pro-image-preview` | 1k/2k/4k | Default. High quality |79| `gemini-3.1-flash-image-preview` | 1k/2k/4k | Fast, extended aspect ratios |80| `gemini-3-pro-image-preview-vip` | 1k built-in | VIP |81| `gemini-3-pro-image-preview-2k-vip` | 2k built-in | VIP |82| `gemini-3-pro-image-preview-4k-vip` | 4k built-in | VIP |8384## Environment Variables8586| Variable | Description |87|----------|-------------|88| `TUZI_API_KEY` | Tuzi API key (https://api.tu-zi.com) |89| `TUZI_IMAGE_MODEL` | Tuzi default model |90| `TUZI_BASE_URL` | Custom Tuzi endpoint |91| `GEMINI_API_KEY` | Google Gemini API key |92| `GOOGLE_API_KEY` | Google API key (alias) |93| `OPENAI_API_KEY` | OpenAI API key |94| `DASHSCOPE_API_KEY` | DashScope API key |95| `REPLICATE_API_TOKEN` | Replicate API token |9697**Load Priority**: CLI `--api-key` > env vars > `<cwd>/.tuzi-skills/.env` > `~/.tuzi-skills/.env`9899## Image Editing100101When the user wants to modify an existing image:1021. Use `--input-image` parameter with the path to the image1032. The prompt should contain editing instructions1043. Resolution auto-detects from input image size if not specified105106## Prompt Handling107108**For generation:** Pass user's image description as-is to `--prompt`. Only rework if clearly insufficient.109110**For editing:** Pass editing instructions in `--prompt` (e.g., "add a rainbow in the sky")111112## Prompt Templates113114- Generation: "Create an image of: <subject>. Style: <style>. Composition: <camera/shot>. Lighting: <lighting>. Background: <background>."115- Editing: "Change ONLY: <single change>. Keep identical: subject, composition, pose, lighting, color palette, background, text, and overall style."116117## Filename Generation118119Pattern: `yyyy-mm-dd-hh-mm-ss-name.png`120- Timestamp: Current date/time in 24-hour format121- Name: Descriptive lowercase text with hyphens (1-5 words)122123## Preflight + Common Failures124125- `command -v npx` (must exist)126- API key must be available (env or `--api-key`)127- If editing: input image must exist128129## Output130131- Saves PNG to current directory (or specified path)132- Script outputs the full path to the generated image133- **Do not read the image back** - just inform the user of the saved path
dvcrn