---
name: image-generation
description: 使用 AI 模型（Nano Banana）生成图片。适用于通用图片生成：包括照片、插画、艺术作品、视觉素材、概念设计、以及任何非技术示意图/非结构化示意的图片。
allowed_tools: Bash(python:*) Bash(python3:*) Read Write
---

# 生成图片（Generate Image）

使用 MakeCoder 的图片生成模型（Nano Banana 和 Nano Banana Pro）生成高质量图片。

## 何时使用本技能

**以下情况使用 generate-image：**
- 照片与写实风格图片
- 艺术插画与艺术作品
- 概念图与视觉概念设计
- 用于演示文稿或文档的视觉素材
- 任何通用的图片生成需求

## 快速开始

使用 `~/.claude/skills/image-generation/scripts/generate_image.py` 脚本来生成图片：

```bash
# 生成一张新图片
python ~/.claude/skills/image-generation/scripts/generate_image.py "一幅美丽的群山日落景色"
```

脚本会生成图片，并将其保存为当前目录下的 generated_image.png。

## 模型选择

**默认模型**：`Nano Banana`（质量高，速度快，性价比高，推荐）

**可用于生成的模型：**

* `Nano Banana` - 快速、高质量，支持生成
* `Nano Banana Pro` - 极高质量，支持生成

选择建议：

* **追求质量**：用 `Nano Banana Pro`
* **控制成本**：用 `Nano Banana`

## 常见用法模式

### 基础生成

```bash
python ~/.claude/skills/image-generation/scripts/generate_image.py "你的提示词写这里"
```

### 指定模型

```bash
python ~/.claude/skills/image-generation/scripts/generate_image.py "一只在太空里的猫" --model "Nano Banana"
```

### 自定义输出路径

```bash
python ~/.claude/skills/image-generation/scripts/generate_image.py "抽象艺术" --output artwork.png
```

### 多张图片

用不同的提示词或不同输出路径，多跑几次脚本即可：

```bash
python ~/.claude/skills/image-generation/scripts/generate_image.py "图片 1 描述" --output image1.png
python ~/.claude/skills/image-generation/scripts/generate_image.py "图片 2 描述" --output image2.png
```

## 脚本参数说明

* `prompt`（必填）：要生成的图片文本描述指令
* `--model` 或 `-m`：OpenRouter 模型 ID（默认：Nano Banana）
* `--output` 或 `-o`：输出文件路径（默认：generated_image.png）

## 示例使用场景

### 科研文档

```bash
# 为论文生成概念插图
python ~/.claude/skills/image-generation/scripts/generate_image.py "免疫治疗药物攻击癌细胞的显微视角，科学插画风格" --output figures/immunotherapy_concept.png

# 为演示文稿生成可视化图
python ~/.claude/skills/image-generation/scripts/generate_image.py "DNA 双螺旋结构，突变位点高亮，现代科学可视化风格" --output slides/dna_mutation.png
```

### 演示文稿与海报

```bash
# 标题页背景图
python ~/.claude/skills/image-generation/scripts/generate_image.py "蓝白抽象背景，带细微分子纹理，专业演示风格" --output slides/background.png

# 海报主视觉（hero image）
python ~/.claude/skills/image-generation/scripts/generate_image.py "现代实验室场景，设备先进，写实风，光线充足" --output poster/hero.png
```

### 通用视觉内容

```bash
# 网站或文档插图
python ~/.claude/skills/image-generation/scripts/generate_image.py "现代办公室里团队围绕数字白板协作，专业商务风" --output docs/team_collaboration.png

# 市场营销素材
python ~/.claude/skills/image-generation/scripts/generate_image.py "未来感 AI 大脑概念，发光的神经网络" --output marketing/ai_concept.png
```

## 错误处理

脚本会对以下问题给出清晰报错信息：

* API 错误（带状态码）
* 响应格式不符合预期
* 缺少依赖（例如 requests 库）

如果脚本失败，请先阅读错误信息并修复问题，再重试。

## 备注

* 图片以 base64 编码的 data URL 形式返回，并会自动保存为 PNG 文件
* 生成耗时因模型而异（通常 5–30 秒）
* 费用信息请查看 MakeCoder 图片模型定价：[https://makecoder.com/wiki/doc/OMnPQEcONL](https://makecoder.com/wiki/doc/OMnPQEcONL)

## 图片编辑小贴士

* 尽量明确你想改什么（例如“把天空改成日落颜色”，比“编辑天空”更好）
* 尽可能指向具体元素（人物、背景、文字区域等）
* 写清楚、细节充分的生成指令通常效果更好
