Qwen-Image 2.0 图片生成 Skill
通过 Gitee AI Images API 调用 qwen-image-2.0 模型：
- Endpoint:
https://ai.gitee.com/v1/images/generations - Model:
qwen-image-2.0 - 认证：环境变量
API_TOKEN - 请求方式：
POST - 请求类型：
application/json
使用前检查
确保已经设置 API Token：
export API_TOKEN="your-gitee-api-token"
不要把 token 写入 prompt、文件、日志或回复中。
支持的尺寸
size 使用宽度和高度以 x 连接，必须是以下值之一：
1024x10241152x864864x11521344x768768x13441248x832832x12481536x10241024x1536
用户未指定尺寸时使用 1024x1024。用户指定比例或宽高时，选择比例最接近的合法尺寸，并说明实际使用的尺寸。不要使用 1024*1024；请求中应使用 1024x1024 格式。
标准文生图调用
curl https://ai.gitee.com/v1/images/generations \
-X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_TOKEN" \
-d '{
"prompt": "一位女生站在阳光明亮的室内，穿着简洁优雅的黑色裙子，写实摄影风格。",
"model": "qwen-image-2.0",
"images": [],
"n": 1,
"negative_prompt": "模糊、低质量、变形、构图混乱、主体缺失",
"watermark": false,
"seed": 0,
"size": "1024x1024"
}'
多图参考生成
images 是参考图片数组，支持传入多张图片。按照图片在数组中的顺序，在 prompt 中明确说明每张图的用途，例如“图1中的人物穿着图2中的服装，并采用图3的姿势”。
图片应按 Gitee AI 接口实际支持的格式传入（例如图片 URL 或接口要求的 base64 数据）；不要把本地路径直接当作图片内容发送。使用 base64 时，建议由程序读取并安全注入 JSON，避免手工拼接造成转义错误。
示例：
curl https://ai.gitee.com/v1/images/generations \
-X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_TOKEN" \
-d '{
"prompt": "图1中的女生穿着图2中的黑色裙子，按照图3的姿势坐下；保留人物的面部特征和服装细节，画面自然、写实。",
"model": "qwen-image-2.0",
"images": [
"<IMAGE_1_URL_OR_BASE64>",
"<IMAGE_2_URL_OR_BASE64>",
"<IMAGE_3_URL_OR_BASE64>"
],
"n": 1,
"negative_prompt": "模糊、低质量、人物变形、肢体错位、服装细节错误、重复人物、乱码",
"watermark": false,
"seed": 0,
"size": "1024x1024"
}'
多图使用规则：
images为空数组表示纯文生图；有参考图时传入一张或多张图片。- 在 prompt 中使用“图1”“图2”等明确指代，避免模型混淆参考图的作用。
- 需要保留某张图的身份、服装、姿势、构图或风格时，应逐项说明优先级。
- 不要在
images中混入无法访问的 URL、未编码的二进制内容或本地文件路径。
常用请求字段
| 字段 | 类型 | 说明 |
|---|---|---|
prompt |
string | 必填。描述生成内容，并在多图场景中说明各参考图的用途。支持中文。 |
model |
string | 必填，固定为 qwen-image-2.0。 |
images |
array | 可选。参考图片数组，可为空；支持多图传入，具体元素格式以接口要求为准。 |
n |
integer | 可选。生成图片数量，通常使用 1。 |
negative_prompt |
string | 可选。描述不希望出现的内容。 |
watermark |
boolean | 可选。是否添加水印；按用户要求设置，示例为 false。 |
seed |
integer | 可选。随机种子；使用 0 表示采用默认随机行为或服务端定义的行为。 |
size |
string | 可选。必须使用上方列出的合法尺寸；默认 1024x1024。 |
调用规则
- 使用
model: "qwen-image-2.0"，默认images: []、n: 1、watermark: false、seed: 0和size: "1024x1024"。 - 用户提供参考图时，将其按顺序放入
images，并在 prompt 中明确“图1”“图2”等对应关系。 - 用户指定负面要求时放入
negative_prompt，不要重复堆入正向 prompt。 - 只使用支持列表中的尺寸，并使用
x而不是*连接宽高。 - 解析成功响应中的图片 URL 或图片数据；若接口返回任务 ID，应根据服务端响应继续查询任务状态，不得伪造生成成功。
- 发生 HTTP 错误时保留状态码和服务端错误信息摘要，隐藏 Authorization 头和 token；先检查 token、JSON、图片格式、模型名和尺寸，再进行有针对性的重试。
安全与质量提示
- 不要把 API token 写入代码、prompt、文件或日志。
- 涉及真实人物、版权角色或敏感内容时，遵守上层安全政策及服务端限制。
- 多图融合结果可能无法完全保持人物身份、服装细节或姿势，应在交付前检查结果。
- 不要伪造接口响应、图片 URL 或本地生成文件。
