qwen-image-edit 的模型介绍
更新时间：2025-11-06 17:55:57
模型介绍
图片生成
通义千问系列图像编辑Plus模型，在首版Edit模型基础上进一步优化了推理性能与系统稳定性，大幅缩短图像生成与编辑的响应时间；支持单次请求返回多张图片，显著提升用户体验。
模型效果演示
更多效果演示详见：图像编辑-通义千问
适用场景
- 图像编辑
- 图片生成
模型出入参
请求参数（标准调用入参）
字段名 | 字段类型 | 是否必传 | 字段默认值 | 字段说明 |
|---|---|---|---|---|
| messages | Array<{ role: "user"; content: Array<Text|ImageUrl> }> | 是 | - | 标准多模态消息；需至少包含一张图片与一个文本编辑指令 |
| messages.role | "user" | 是 | - | 仅支持 user |
| messages.content | Array<Text | ImageUrl> | 是 | - | 多模态内容数组：文本或图片 URL |
| contenttype=text | { type: "text"; text: string } | 是（至少一项） | - | 编辑说明/指令（可多条） |
| contenttype=image_url | { type: "image_url"; image_url: { url: string } } | 是（至少一项） | - | 待编辑的输入图片 URL（可多张） |
| parameters | QwenImageEditParameters | 否 | - | 模型参数对象 |
| parameters.negative_prompt | string | 否 | - | 负面提示词，用于排除不希望出现的元素 |
| parameters.watermark | boolean | 否 | false | 是否添加水印 |
输入要求：
- 至少一张输入图片与一条文本编辑指令
- 支持多图输入（参考图、风格图等）与多文本输入（分步骤描述编辑需求）
- 图片格式：jpg、png、webp 等
更多通用采样/控制参数见
../COMMON_PARAMS.md
。请求参数（直连 API 入参）
字段名 | 字段类型 | 是否必传 | 字段默认值 | 字段说明 |
|---|---|---|---|---|
| model | string | 是 | qwen-image-edit | 模型名称 |
| input | object | 是 | - | 输入对象 |
| input.messages | Array<{ role: "user"; content: Array<{ image?: string; text?: string }> }> | 是 | - | 用户消息； content 中使用 image 传图片 URL、text 传编辑指令 |
| parameters | QwenImageEditParameters | 否 | - | 参数同上（negative_prompt、watermark） |
响应参数（出参）
后端原始响应（QwenImageEditAPIResponse）：
字段名 | 字段类型 | 是否必传 | 字段默认值 | 字段说明 |
|---|---|---|---|---|
| async | boolean | 否 | - | 是否为异步任务标记（部分返回包含） |
| output | object | 是 | - | 结果对象；可能为异步任务信息或同步图片结果 |
| output.choices | Array<{ finish_reason: string; message: { role: "assistant"|"user"; content: ContentItem } }> | 否 | - | 同步结果时返回； content[0].image 为图片 URL |
| output.task_status | string | 否 | - | 异步任务状态（如存在） |
| output.task_id | string | 否 | - | 异步任务 ID（如存在） |
| output.task_metric | { TOTAL: number; FAILED: number; SUCCEEDED: number } | 否 | - | 任务统计信息（如存在） |
| usage | { width?: number; height?: number; image_count?: number } | 否 | - | 生成图片相关信息（像素/数量） |
| request_id | string | 否 | - | 请求 ID |
| id | string | 否 | - | 响应 ID |
| model | string | 否 | - | 使用的模型名 |
| created | number | 否 | - | 时间戳（秒） |
| object | string | 否 | - | 对象类型 |
| code | number | 否 | 0 | 错误码 |
| error | string | 否 | "" | 错误信息 |
ContentItem（部分字段）：
字段名 | 字段类型 | 是否必传 | 字段默认值 | 字段说明 |
|---|---|---|---|---|
| image | string | 否 | - | 图片 URL（常用返回位） |
| url | string | 否 | - | 备用 URL |
| image_url | string | { url: string } | 否 | - | 图片字段的另一种表示 |
| b64_json | string | 否 | - | Base64 图片内容（如返回） |
标准化输出（SDK 适配后）说明：
- 若后端返回异步任务（存在 task_status和task_id），SDK 会返回一条type = "async_task"的消息，content为任务信息 JSON 字符串，可配合任务查询接口获取图片结果。
- 若为同步生成结果，SDK 返回 type = "image"的消息，content为图片 URL。
使用示例（标准调用）
javascript
{
"messages": [{
"role": "user",
"content": [
{ "type": "image_url", "image_url": { "url": "https://example.com/input-image.jpg" } },
{ "type": "text", "text": "请将这张图片的背景改为海滩场景" },
{ "type": "text", "text": "保持人物的姿势和表情不变" },
{ "type": "text", "text": "添加一些海鸥和夕阳元素" }
]
}],
"parameters": {
"negative_prompt": "模糊, 低质量, 变形",
"watermark": false
}
}