qwen-image 的模型介绍
更新时间：2025-11-06 18:19:58
模型介绍
图片生成
通义千问-文生图模型（Qwen-Image）是一款通用图像生成模型，支持多种艺术风格，尤其擅长复杂文本渲染，特别是中英文文本渲染。模型支持多行布局、段落级文本生成以及细粒度细节刻画，可实现复杂的图文混合布局设计。
模型效果演示
适用场景
- 图像内容解析与信息提取：适用于电商、零售等场景，可自动识别商品图片中的关键信息（如服饰的颜色、款式、材质，家具的风格、尺寸等），辅助商品分类、标签生成或智能搜索，提升内容处理效率。
- 文本驱动的图像生成：适用于创意设计、营销素材制作等场景，能根据文字描述（如“生成一张蓝色调的未来感城市夜景，带悬浮车辆”）生成符合要求的图像，快速产出广告图、社交媒体配图等，降低设计门槛。
- 图像优化与编辑辅助：适用于个人或企业的图像处理需求，可实现老照片修复（去除噪点、补全残缺）、背景虚化/替换、尺寸适配（如自动调整图片至适配移动端显示）等，简化图像后期处理流程。
模型出入参
请求参数（标准调用入参）
字段名 | 字段类型 | 是否必传 | 字段默认值 | 字段说明 |
|---|---|---|---|---|
| messages | Array<{ role: "user"; content: Array<{ type: "text"; text: string }> }> | 是 | - | 标准对话入参；需包含一条 user 文本提示 |
| messages.role | "user" | 是 | - | 仅支持 user （内部会取第一条 user 文本） |
| messages.content | Array | 是 | - | 文本内容数组，仅使用第一条文本作为提示词 |
| contenttype=text | { type: "text"; text: string } | 是 | - | 生成图片的文本提示词 |
| parameters | QwenImageParameters | 否 | - | 模型参数对象 |
| parameters.negative_prompt | string | 否 | - | 负面提示词，用于排除不希望出现的元素 |
| parameters.size | "1664928" | "14721140" | "13281328" | "11401472" | "928*1664" | string | 否 | - | 图片尺寸（宽*高），支持列出的常用规格或自定义 |
| parameters.n | 1 | 否 | 1 | 生成图片数量，当前仅支持 1 |
| parameters.prompt_extend | boolean | 否 | true | 是否扩展提示词 |
| parameters.watermark | boolean | 否 | false | 是否添加水印 |
说明：SDK 默认走异步合成流程（便于长耗时任务），会自动提取第一条
user
文本作为提示词。更多通用采样/控制参数见
../COMMON_PARAMS.md
。请求参数（直连 API 入参）
字段名 | 字段类型 | 是否必传 | 字段默认值 | 字段说明 |
|---|---|---|---|---|
| model | string | 是 | qwen-image | 模型名称 |
| input | object | 是 | - | 输入对象 |
| input.messages | Array<{ role: "user"; content: Array<{ text: string }> }> | 否（同步） | - | 同步生成接口使用；传 user 文本消息 |
| input.prompt | string | 否（异步） | - | 异步合成接口使用；直接传提示词文本 |
| parameters | QwenImageParameters | 否 | - | 参数同上（negative_prompt、size、n、prompt_extend、watermark） |
提示：异步合成接口通常使用
input.prompt
；同步生成接口使用 input.messages
。响应参数（出参）
后端原始响应（QwenImageAPIResponse）：
字段名 | 字段类型 | 是否必传 | 字段默认值 | 字段说明 |
|---|---|---|---|---|
| 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。