千问图像生成与编辑助手

技能文档

---
name: qwen-image-edit
title: 千问图像生成与编辑助手
category: 内容创作
description: "千问图像生成与编辑助手。支持文生图、图像编辑（增删改元素 / 修改文字 / 风格迁移）、多图融合，擅长复杂中文文字渲染，可生成海报、封面、展板、宣传图等商用素材。当用户需要生成图片、画图、做海报、P图、改图、修图、抠图、换背景、加文字、融合图片时触发。"
---

# Qwen Image

  千问图像生成与编辑助手。支持文生图、图像编辑（增删改元素 / 修改文字 / 风格迁移）、多图融合。擅长复杂中文文字渲染，可生成海报、封面、展板、宣传图等商用素材。触发词：生成图片、画图、做海报、P图、改图、修图、抠图、换背景、加文字、融合图片。

## 用法

### 文生图

生成图像（仅返回 URL）：
```bash
python {baseDir}/scripts/generate_image.py --prompt "一只橘猫坐在窗台上晒太阳"
```

生成并保存到本地：
```bash
python {baseDir}/scripts/generate_image.py --prompt "a beautiful sunset over mountains" --filename sunset.png
```

自定义尺寸生成：
```bash
python {baseDir}/scripts/generate_image.py --prompt "城市夜景" --size "2688*1536" --filename city.png
```

生成多张图像：
```bash
python {baseDir}/scripts/generate_image.py --prompt "水彩风格的花卉" --n 4 --filename flower.png
```

### 图像编辑

单图编辑：
```bash
python {baseDir}/scripts/generate_image.py --images photo.png --prompt "在画面左下角加一只猫" --filename edited.png
```

多图融合（最多 3 张图像）：
```bash
python {baseDir}/scripts/generate_image.py --images bg.png style.png --prompt "将图二的风格应用到图一" --filename fused.png
```

通过 URL 输入进行编辑：
```bash
python {baseDir}/scripts/generate_image.py --images https://example.com/photo.jpg --prompt "remove the text on the wall" --filename cleaned.png
```

使用专用编辑模型：
```bash
python {baseDir}/scripts/generate_image.py --images input.png --prompt "把天空改成星空" -m qwen-image-edit-max --filename starry.png
```

## API 密钥

按以下优先级获取 API 密钥：

1. `--api-key` 命令行参数
3. 从以下地址获取 API 密钥：https://dashscope.console.aliyun.com/

## 模型

|---|---|---|

| 模型 | 模式 | 说明 |
|---|---|---|

## 参数选项

- qwen-image-2.0 系列（512x512 ~ 2048x2048）：
- 编辑模型（宽高各在 [512, 2048] 范围内）：

## 技能工作流

1. 如果用户提供了图像，通过 `--images` 参数传入（本地路径或 URL）。
2. 使用用户的提示词和选项执行 `generate_image.py`。
3. 解析输出中以 `MEDIA_URL:` 开头的行。
4. 使用 markdown 格式展示每张图像：`![生成图像](URL)`。
5. 除非用户明确要求，否则不要下载或保存图像（使用 `--filename` 指定保存）。

## 注意事项

- 支持中英文提示词。
- 图像编辑支持本地文件（自动 Base64 编码，最大 10MB）或 URL（http/https/oss）。
- 输出图像为 PNG 格式。图像 URL 在 24 小时后过期。
- `qwen-image-edit` 模型不支持 `--size` 和 `--no-prompt-extend` 参数。
- 默认的反向提示词有助于避免常见 AI 伪影（肢体扭曲、低质量等）。
- 北京和新加坡区域拥有独立的 API 密钥和端点——请勿混用。

使用说明

# 千问图像生成与编辑助手

支持文生图、图像编辑与多图融合，擅长复杂中文文字渲染，可生成海报、封面、展板等商用素材。需要配置 DASHSCOPE_API_KEY。

## 快速开始

```text
画一张橘猫坐在窗台上晒太阳的水彩风插画
```

## 使用说明

详细的工作流、参数与计费说明见 SKILL.md；按任务的深入指引见 references/ 目录。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。