Skip to main content
阿里云百炼 home page阿里云百炼
万相

万相-图像生成与编辑2.6 API参考

万相图像生成模型支持 图像编辑 、 图文混排输出 ，满足多样化生成与集成需求。

模型概览

模型名称

模型简介

输出图像规格

wan2.6-image

万相2.6 image

支持图像编辑和图文混排输出

如需纯文本生成图片（文生图），建议使用wan2.6-t2i 模型（通义万相-文生图V2）。

图片格式：PNG。

图像分辨率和尺寸请参见size参数。

调用前，请查阅各地域支持的模型列表与价格。

前提条件

您需要已获取与配置 API Key并配置API Key到环境变量。请将示例代码中的 DASHSCOPE_API_HOST 替换为获取的 API Host。
华北2（北京）、新加坡和美国（弗吉尼亚）地域拥有独立的 API Key与请求地址，不可混用，跨地域调用将导致鉴权失败或服务报错，详情请参见选择地域、服务部署范围和接入域名。
阿里云百炼为华北2（北京）、新加坡地域推出了业务空间专属域名，能够为推理请求提供卓越的性能和更高的稳定性，建议迁移至新域名：
  • 华北2（北京）地域：从 https://dashscope.aliyuncs.com 迁移至 https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • 新加坡地域：从 https://dashscope-intl.aliyuncs.com 迁移至 https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
其中 {WorkspaceId} 为您的业务空间 ID，可在阿里云百炼控制台的业务空间详情页面查看。现有域名仍可正常使用。

HTTP同步调用

一次请求即可获得结果，流程简单，推荐大多数场景使用。
  • 华北2（北京）
  • 新加坡
  • 美国（弗吉尼亚）
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation调用时请将{WorkspaceId}替换为真实的Workspace ID。
全球部署范围（法兰克福地域）仅支持异步调用。

请求参数

请求头（Headers）
Content-Typestring（必选）请求内容类型。此参数必须设置为application/json。Authorizationstring（必选）请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值：Bearer sk-xxxx。X-DashScope-Ssestring（可选）用于启用流式输出。
  • 仅当 parameters.enable_interleave=true 时，必须将该字段设为 enable。
  • 其他情况下可不传或忽略。
请求体（Request Body）
model string （必选）模型名称。设置为wan2.6-image。input object （必选）输入的基本信息。

属性

messages array （必选）请求内容数组。当前仅支持单轮对话，即传入一组role、content参数，不支持多轮对话。

属性

rolestring （必选）消息的角色。此参数固定设置为user。contentarray （必选）消息内容数组。

属性

textstring（必选）正向提示词用于描述您期望生成的图像内容、风格和构图。支持中英文，长度不超过2000个字符，每个汉字、字母、数字或符号计为一个字符，超过部分会自动截断。示例值：参考这个风格的图片，生成番茄炒蛋。注意：content数组中，必须且只能包含一个含 text 字段的对象。imagestring（可选）输入图像的URL或Base64编码字符串。图像限制：
  • 图像格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP。
  • 图像分辨率：图像的宽高范围均为[240, 8000]像素。
  • 文件大小：不超过10MB。
图像数量限制：
  • 输入图像数量与parameters.enable_interleave参数有关。
    • 当enable_interleave=true时（图文混排输出），可输入0~1张图像。
    • 当enable_interleave=false时（图像编辑），必须输入1~4张图像。
  • 当输入多张图像时，需在content数组中传入多个image对象，并按照数组顺序定义图像顺序。
支持的输入格式：
  1. 使用公网可访问URL
    • 支持 HTTP 或 HTTPS 协议。
    • 示例值：http://wanx.alicdn.com/material/xxx.jpeg。
  2. 传入 Base64 编码图像后的字符串
    • 格式：data:{MIME_type};base64,{base64_data}
    • 示例：data:image/jpeg;base64,GDU7MtCZzEbTbmRZ...（仅示意，实际需传入完整字符串）
    • Base64 编码规范请参见图像传入方式。
parameters object （可选）图像处理参数。

属性

negative_prompt string （可选）反向提示词，用于描述不希望在图像中出现的内容，对画面进行限制。支持中英文，长度不超过500个字符，超出部分将自动截断。示例值：低分辨率，低画质，肢体畸形，手指畸形，画面过饱和，蜡像感，人脸无细节，过度光滑，画面具有AI感。构图混乱。文字模糊，扭曲。size string （可选）输出图片分辨率参数，支持参考输入图比例和直接指定两种方式。当enable_interleave=false（即图像编辑模式）时：
  • 方式一：参考输入图比例（推荐） 可选的输出分辨率档位：1K（默认）、2K。
    • 1K：输出总像素接近 1280*1280，宽高比与最后一张输入图像一致。
    • 2K：输出总像素接近 2048*2048，宽高比与最后一张输入图像一致。
  • 方式二：指定生成图像的宽高像素值 总像素在 [768768, 20482048] 之间，且宽高比范围为 [1:4, 4:1]。
    实际输出图像的像素值为接近指定值的16的倍数。
当enable_interleave=true（即图文混排输出模式）时：
  • 方式一：参考输入图比例（默认方式）
    • 若输入图像总像素 ≤ 1280*1280，输出总像素和宽高比与输入图像一致。
    • 若输入图像总像素 > 12801280，输出总像素接近 12801280，宽高比与输入图像一致。
    • 若无输入图像，则为1280*1280。
  • 方式二：指定生成图像的宽高像素值 总像素在 [768768, 12801280] 之间，且宽高比范围为 [1:4, 4:1]。
    实际输出图像的像素值为接近指定值的16的倍数。

常见比例推荐的分辨率

  • 1:1：1280*1280
  • 2:3：800*1200
  • 3:2：1200*800
  • 3:4：960*1280
  • 4:3：1280*960
  • 9:16：720*1280
  • 16:9：1280*720
  • 21:9：1344*576
enable_interleave bool （可选）控制生图模式：
  • false：默认值，表示图像编辑模式（支持多图输入及主体一致性生成）。
    • 用途：基于1～4张输入图像进行编辑、风格迁移或主体一致性生成。
    • 输入：必须提供至少1张参考图像。
    • 输出：可生成1至4张结果图像。
  • true ：表示启用图文混排输出模式（仅支持传入一张图像或不传图像）。
    • 用途：根据文本描述生成图文并茂的内容，或进行纯文本生成图像（文生图）。 纯文生图场景建议优先使用wan2.6-t2i 模型（通义万相-文生图V2）。
    • 输入：可以不提供图像（文生图），或提供最多1张参考图像。
    • 输出：生成包含文本和图像的混合内容。
n integer （可选）
n直接影响费用。费用 = 单价 × 成功生成的图片张数，请在调用前确认模型价格。
指定生成图片的数量。该参数的取值范围与含义取决于 enable_interleave（模式开关）的状态：
  • 当 enable_interleave=false（图像编辑模式）：
    • 作用：直接控制生成图像的数量。
    • 取值范围：1～4，默认值为 4。
    • 建议在测试阶段将此值设置为 1，以便低成本验证效果。
  • 当 enable_interleave=true（图文混排模式）：
    • 限制：此参数默认为1，且必须固定为1。若设置为其他值，接口将报错。
    • 说明：在此模式下，如需控制生成图像的数量上限，请使用 max_images 参数。
max_images integer （可选）
max_images影响费用。费用 = 单价 × 成功生成的图片张数，请在调用前确认模型价格。
仅在图文混排模式（即 enable_interleave=true）下生效。
  • 作用：指定模型在单次回复中生成图像的最大数量。
  • 取值范围：1～5，默认值为 5。
  • 注意：该参数仅代表“数量上限”。实际生成的图像数量由模型推理决定，可能会少于设定值（例如：设置为 5，模型可能根据内容仅生成 3 张）。
prompt_extend bool （可选）仅在图像编辑模式（即enable_interleave = false）下生效。是否开启 Prompt（提示词）智能改写功能。该功能仅对正向提示词进行优化与润色，不会改变反向提示词。
  • true：默认值，开启智能改写。
  • false：关闭智能改写，使用原始提示词。
stream bool （可选）控制返回结果是否为流式输出。在图像混排模式（即 enable_interleave = true）下，必须设置为true。
  • false：默认值，非流式输出。
  • true：流式输出。
watermark bool （可选）是否添加水印标识，水印位于图片右下角，文案固定为“AI生成”。
  • false：默认值，不添加水印。
  • true：添加水印。
seed integer （可选）随机数种子，取值范围[0,2147483647]。使用相同的seed参数值可使生成内容保持相对稳定。若不提供，算法将自动使用随机数种子。注意：模型生成过程具有概率性，即使使用相同的seed，也不能保证每次生成结果完全一致。
  • 图像编辑
  • 图文混排（仅支持流式）
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
    "model": "wan2.6-image",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "text": "参考图1的风格和图2的背景，生成番茄炒蛋"
                    },
                    {
                        "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"
                    },
                    {
                        "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp"
                    }
                ]
            }
        ]
    },
    "parameters": {
        "prompt_extend": true,
        "watermark": false,
        "n": 1,
        "enable_interleave": false,
        "size": "1K"
    }
}'

响应参数

output object任务输出信息。

属性

choices array of object模型生成的输出内容。

属性

finish_reason string任务停止原因。非流式输出场景：自然停止时为stop。流式输出场景：当开启流式输出时，该参数判断数据流是否传输结束。
  • 传输过程中：前序数据包会持续返回 "finish_reason": "null"，表示内容仍在生成中，请继续接收。
  • 传输结束时：仅在最后一个 JSON 结构体中返回 "finish_reason":"stop"，表示流式请求已全部结束，应停止接收。
message object模型返回的消息。

属性

rolestring消息的角色，固定为assistant。contentarray

属性

type string输出的类型，枚举值为text、image。text string生成的文字。image string生成图像的 URL，图像格式为PNG。链接有效期为24小时，请及时下载并保存图像。
finished bool请求结束标志符。
  • true：表示请求结束。
  • false：表示请求未结束。
usage object输出信息统计。只对成功的结果计数。

属性

image_count integer生成图像的张数。size string生成的图像分辨率。示例值：1376*768。input_tokens integer按图片张数计费。
  • 在图像编辑模式下，固定为0。
  • 在图文混排模式下，此字段统计输入文本的token数量（不计费）。
output_tokens integer按图片张数计费。
  • 在图像编辑模式下，固定为0。
  • 在图文混排模式下，此字段统计输出文本的token数量（不计费）。
total_tokensinteger按图片张数计费。
  • 在图像编辑模式下，固定为0。
  • 在图文混排模式下，此字段统计总token数量（不计费）。
request_idstring请求唯一标识。可用于请求明细溯源和问题排查。codestring请求失败的错误码。请求成功时不会返回此参数，详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误码。
  • 任务执行成功
  • 任务执行成功（流式输出）
  • 任务执行异常
任务数据（如任务状态、图像URL等）仅保留24小时，超时后会被自动清除。请您务必及时保存生成的图像。
{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ],
                    "role": "assistant"
                }
            }
        ],
        "finished": true
    },
    "usage": {
        "image_count": 1,
        "input_tokens": 0,
        "output_tokens": 0,
        "size": "1376*768",
        "total_tokens": 0
    },
    "request_id": "a3f4befe-cacd-49c9-8298-xxxxxx"
}

HTTP异步调用

流程包含 “创建任务 -> 轮询获取” 两个核心步骤，具体如下：

步骤1：创建任务获取任务ID

  • 华北2（北京）
  • 新加坡
  • 美国（弗吉尼亚）
  • 德国（法兰克福）
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation调用时请将{WorkspaceId}替换为真实的Workspace ID。
  • 创建成功后，使用接口返回的 task_id 查询结果，task_id 有效期为 24 小时。请勿重复创建任务，轮询获取即可。
  • 新手指引请参见Postman。

请求参数

请求头（Headers）
Content-Typestring（必选）请求内容类型。此参数必须设置为application/json。Authorizationstring（必选）请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值：Bearer sk-xxxx。X-DashScope-Asyncstring（必选）异步处理配置参数，必须设置为enable。
缺少此请求头将报错：“current user api does not support synchronous calls”。
请求体（Request Body）
model string （必选）模型名称。示例值：wan2.6-imageinput object （必选）输入的基本信息。

属性

messages array （必选）请求内容数组。当前仅支持单轮对话，即传入一组role、content参数，不支持多轮对话。

属性

rolestring （必选）消息的角色。此参数固定设置为user。contentarray （必选）消息内容数组。

属性

textstring（必选）正向提示词用于描述您期望生成的图像内容、风格和构图。支持中英文，长度不超过2000个字符，每个汉字、字母、数字或符号计为一个字符，超过部分会自动截断。示例值：参考这个风格的图片，生成番茄炒蛋。注意：content数组中，必须且只能包含一个含 text 字段的对象。imagestring（可选）输入图像的URL或Base64编码字符串。图像限制：
  • 图像格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP。
  • 图像分辨率：图像的宽高范围均为[240, 8000]像素。
  • 文件大小：不超过10MB。
图像数量限制：
  • 输入图像数量与parameters.enable_interleave参数有关。
    • 当enable_interleave=true时（图文混排输出），可输入0~1张图像。
    • 当enable_interleave=false时（图像编辑），必须输入1~4张图像。
  • 当输入多张图像时，需在content数组中传入多个image对象，并按照数组顺序定义图像顺序。
支持的输入格式：
  1. 使用公网可访问URL
    • 支持 HTTP 或 HTTPS 协议。
    • 示例值：http://wanx.alicdn.com/material/xxx.jpeg。
  2. 传入 Base64 编码图像后的字符串
    • 格式：data:{MIME_type};base64,{base64_data}
    • 示例：data:image/jpeg;base64,GDU7MtCZzEbTbmRZ...（仅示意，实际需传入完整字符串）
    • Base64 编码规范请参见图像传入方式。
parameters object （可选）图像处理参数。

属性

negative_prompt string （可选）反向提示词，用于描述不希望在图像中出现的内容，对画面进行限制。支持中英文，长度不超过500个字符，超出部分将自动截断。示例值：低分辨率，低画质，肢体畸形，手指畸形，画面过饱和，蜡像感，人脸无细节，过度光滑，画面具有AI感。构图混乱。文字模糊，扭曲。size string （可选）输出图片分辨率参数，支持参考输入图比例和直接指定两种方式。当enable_interleave=false（即图像编辑模式）时：
  • 方式一：参考输入图比例（推荐） 可选的输出分辨率档位：1K（默认）、2K。
    • 1K：输出总像素接近 1280*1280，宽高比与最后一张输入图像一致。
    • 2K：输出总像素接近 2048*2048，宽高比与最后一张输入图像一致。
  • 方式二：指定生成图像的宽高像素值 总像素在 [768768, 20482048] 之间，且宽高比范围为 [1:4, 4:1]。
    实际输出图像的像素值为接近指定值的16的倍数。
当enable_interleave=true（即图文混排输出模式）时：
  • 方式一：参考输入图比例（默认方式）
    • 若输入图像总像素 ≤ 1280*1280，输出总像素和宽高比与输入图像一致。
    • 若输入图像总像素 > 12801280，输出总像素接近 12801280，宽高比与输入图像一致。
    • 若无输入图像，则为1280*1280。
  • 方式二：指定生成图像的宽高像素值 总像素在 [768768, 12801280] 之间，且宽高比范围为 [1:4, 4:1]。
    实际输出图像的像素值为接近指定值的16的倍数。

常见比例推荐的分辨率

  • 1:1：1280*1280
  • 2:3：800*1200
  • 3:2：1200*800
  • 3:4：960*1280
  • 4:3：1280*960
  • 9:16：720*1280
  • 16:9：1280*720
  • 21:9：1344*576
enable_interleave bool （可选）控制生图模式：
  • false：默认值，表示图像编辑模式（支持多图输入及主体一致性生成）。
    • 用途：基于1～4张输入图像进行编辑、风格迁移或主体一致性生成。
    • 输入：必须提供至少1张参考图像。
    • 输出：可生成1至4张结果图像。
  • true ：表示启用图文混排输出模式（仅支持传入一张图像或不传图像）。
    • 用途：根据文本描述生成图文并茂的内容，或进行纯文本生成图像（文生图）。 纯文生图场景建议优先使用wan2.6-t2i 模型（通义万相-文生图V2）。
    • 输入：可以不提供图像（文生图），或提供最多1张参考图像。
    • 输出：生成包含文本和图像的混合内容。
n integer （可选）
n直接影响费用。费用 = 单价 × 成功生成的图片张数，请在调用前确认模型价格。
指定生成图片的数量。该参数的取值范围与含义取决于 enable_interleave（模式开关）的状态：
  • 当 enable_interleave=false（图像编辑模式）：
    • 作用：直接控制生成图像的数量。
    • 取值范围：1～4，默认值为 4。
    • 建议在测试阶段将此值设置为 1，以便低成本验证效果。
  • 当 enable_interleave=true（图文混排模式）：
    • 限制：此参数默认为1，且必须固定为1。若设置为其他值，接口将报错。
    • 说明：在此模式下，如需控制生成图像的数量上限，请使用 max_images 参数。
max_images integer （可选）
max_images影响费用。费用 = 单价 × 成功生成的图片张数，请在调用前确认模型价格。
仅在图文混排模式（即 enable_interleave=true）下生效。
  • 作用：指定模型在单次回复中生成图像的最大数量。
  • 取值范围：1～5，默认值为 5。
  • 注意：该参数仅代表“数量上限”。实际生成的图像数量由模型推理决定，可能会少于设定值（例如：设置为 5，模型可能根据内容仅生成 3 张）。
prompt_extend bool （可选）仅在图像编辑模式（即enable_interleave = false）下生效。是否开启 Prompt（提示词）智能改写功能。该功能仅对正向提示词进行优化与润色，不会改变反向提示词。
  • true：默认值，开启智能改写。
  • false：关闭智能改写，使用原始提示词。
watermark bool （可选）是否添加水印标识，水印位于图片右下角，文案固定为“AI生成”。
  • false：默认值，不添加水印。
  • true：添加水印。
seed integer （可选）随机数种子，取值范围[0,2147483647]。使用相同的seed参数值可使生成内容保持相对稳定。若不提供，算法将自动使用随机数种子。注意：模型生成过程具有概率性，即使使用相同的seed，也不能保证每次生成结果完全一致。
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--data '{
    "model": "wan2.6-image",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "text": "参考图1的风格和图2的背景，生成番茄炒蛋"
                    },
                    {
                        "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"
                    },
                    {
                        "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp"
                    }
                ]
            }
        ]
    },
    "parameters": {
        "prompt_extend": true,
        "watermark": false,
        "n": 1,
        "enable_interleave": false,
        "size": "1K"
    }
}'

响应参数

output object任务输出信息。

属性

task_id string任务ID。查询有效期24小时。task_status string任务状态。

枚举值

  • PENDING：任务排队中
  • RUNNING：任务处理中
  • SUCCEEDED：任务执行成功
  • FAILED：任务执行失败
  • CANCELED：任务已取消
  • UNKNOWN：任务不存在或状态未知
request_idstring请求唯一标识。可用于请求明细溯源和问题排查。codestring请求失败的错误码。请求成功时不会返回此参数，详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误码。
  • 成功响应
  • 异常响应
请保存 task_id，用于查询任务状态与结果。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

步骤2：根据任务ID查询结果

  • 华北2（北京）
  • 新加坡
  • 美国（弗吉尼亚）
  • 德国（法兰克福）
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}调用时请将{WorkspaceId}替换为真实的Workspace ID。
  • 轮询建议：图像生成过程耗时较长，建议采用轮询机制，并设置合理的查询间隔（如 10 秒）来获取结果。
  • 任务状态流转：PENDING（排队中）→ RUNNING（处理中）→ SUCCEEDED（成功）/ FAILED（失败）。
  • 结果链接：任务成功后返回图像链接，有效期为 24 小时。建议在获取链接后立即下载并转存至永久存储（如阿里云 OSS）。
  • RPS 限制：查询接口默认RPS为20。如需更高频查询或事件通知，建议配置异步任务回调。
  • 更多操作：如需批量查询、取消任务等操作，请参见管理异步任务。

请求参数

请求头（Headers）
Authorizationstring（必选）请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值：Bearer sk-xxxx。
URL路径参数（Path parameters）
task_id string（必选）任务ID。
  • 查询任务结果
将{task_id}完整替换为上一步接口返回的task_id的值。task_id查询有效期为24小时，并请将{WorkspaceId}替换为真实的业务空间ID。
curl -X GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

响应参数

output object任务输出信息。

属性

task_id string任务ID。查询有效期24小时。task_status string任务状态。

枚举值

  • PENDING：任务排队中
  • RUNNING：任务处理中
  • SUCCEEDED：任务执行成功
  • FAILED：任务执行失败
  • CANCELED：任务已取消
  • UNKNOWN：任务不存在或状态未知
轮询过程中的状态流转：
  • PENDING（排队中） → RUNNING（处理中）→ SUCCEEDED（成功）/ FAILED（失败）。
  • 初次查询状态通常为 PENDING（排队中）或 RUNNING（处理中）。
  • 当状态变为 SUCCEEDED 时，响应中将包含生成的图像URL。
  • 若状态为 FAILED，请检查错误信息并重试。
submit_time string任务提交时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。scheduled_time string任务执行时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。end_time string任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。finished bool请求结束标志符。
  • true：表示请求结束。
  • false：表示请求未结束。
choices array of object模型生成的输出内容。

属性

finish_reason string任务停止原因，自然停止时为stop。message object模型返回的消息。

属性

rolestring消息的角色，固定为assistant。contentarray

属性

type string输出的类型，枚举值为text、image。text string生成的文字。image string生成图像的 URL，图像格式为PNG。链接有效期为24小时，请及时下载并保存图像。
usage object输出信息统计。只对成功的结果计数。

属性

image_count integer生成图像的张数。size string生成的图像分辨率。示例值：1376*768。input_tokens integer输入token数量。按图片张数计费，当前固定为0。output_tokens integer输出token数量。按图片张数计费，当前固定为0。total_tokensinteger总token数量。按图片张数计费，当前固定为0。
request_idstring请求唯一标识。可用于请求明细溯源和问题排查。codestring请求失败的错误码。请求成功时不会返回此参数，详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误码。
  • 任务执行成功
  • 任务执行异常
任务数据（如任务状态、图像URL等）仅保留24小时，超时后会被自动清除。请您务必及时保存生成的图像。
{
    "request_id": "43d9e959-25bc-4dc7-9888-xxxxxx",
    "output": {
        "task_id": "858cad55-4bdc-4ba3-ae6c-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-12-16 04:21:02.275",
        "scheduled_time": "2025-12-16 04:21:02.304",
        "end_time": "2025-12-16 04:24:46.658",
        "finished": true,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/1xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            },
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/1xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ]
    },
    "usage": {
        "size": "1376*768",
        "total_tokens": 0,
        "image_count": 2,
        "output_tokens": 0,
        "input_tokens": 0
    }
}

DashScope Python SDK调用

SDK 的参数命名与HTTP接口基本一致，参数结构根据语言特性进行封装。 由于任务耗时较长，SDK 在底层封装了 HTTP 异步调用流程，支持同步、异步两种调用方式。
具体耗时受限于排队任务数和服务执行情况，请在获取结果时耐心等待。
请确保 DashScope Python SDK 版本不低于1.25.8，再运行以下代码。更新请参考安装SDK。
各地域的base_url和 API Key 不通用，以下示例以北京地域为例进行调用：
  • 华北2（北京）
  • 新加坡
  • 美国（弗吉尼亚）
  • 德国（法兰克福）
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1调用时请将{WorkspaceId}替换为真实的Workspace ID。
全球部署范围（法兰克福地域）仅支持异步调用。

图像编辑

  • 同步调用
  • 异步调用
请求示例 
import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# 以下为华北2（北京）地域的URL。请将{WorkspaceId}替换为您的百炼业务空间ID，各地域的URL不同。
dashscope.base_http_api_url = 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1'

# 若没有配置环境变量，请用百炼API Key将下行替换为：api_key="sk-xxx"
# 各地域的API Key不同。获取API Key：https://help.aliyun.com/zh/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

message = Message(
    role="user",
    # 支持本地文件 如 "image": "file://umbrella1.png"
    content=[
        {
            "text": "参考图1的风格和图2的背景，生成番茄炒蛋"
        },
        {
            "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"
        },
        {
            "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp"
        }
    ]
)
print("----sync call, please wait a moment----")
rsp = ImageGeneration.call(
        model='wan2.6-image',
        api_key=api_key,
        messages=[message],
        negative_prompt="",
        prompt_extend=True,
        watermark=False,
        n=1,
        enable_interleave=False,
        size="1K"
    )

print(rsp)
响应示例
url 有效期24小时，请及时下载图像。 
{
    "status_code": 200,
    "request_id": "b6a4c68d-3a91-4018-ae96-3cf373xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "audio": null,
        "finished": true
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "characters": 0,
        "image_count": 1,
        "size": "1376*768",
        "total_tokens": 0
    }
}

图文混合输出

  • 同步调用（仅支持流式）
  • 异步调用
请求示例 
import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# 以下为华北2（北京）地域的URL。请将{WorkspaceId}替换为您的百炼业务空间ID，各地域的URL不同。
dashscope.base_http_api_url = 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1'

# 若没有配置环境变量，请用百炼API Key将下行替换为：api_key="sk-xxx"
# 各地域的API Key不同。获取API Key：https://help.aliyun.com/zh/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

def sync_call_with_stream():
    print("\n========== 同步调用 - 流式图文输出 ==========")

    image_message = Message(
        role="user",
        content=[
            {
                "text": "给我一个3张图辣椒炒肉教程"
            }
        ]
    )

    image_stream_res = ImageGeneration.call(
        model="wan2.6-image",
        api_key=api_key,
        messages=[image_message],
        stream=True,  # 仅支持流式调用
        negative_prompt="",
        enable_interleave=True,
        max_images=3,
        size="1280*1280"
    )

    print("流式输出结果:")
    for stream_res in image_stream_res:
        print(stream_res)

if __name__ == "__main__":
    sync_call_with_stream()
响应示例
url 有效期24小时，请及时下载图像。 
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "辣椒"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 0, "characters": 0, "total_tokens": 28, "image_count": 0, "size": "0*0"}}
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "炒"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 1, "characters": 0, "total_tokens": 29, "image_count": 0, "size": "0*0"}}
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "肉"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 2, "characters": 0, "total_tokens": 30, "image_count": 0, "size": "0*0"}}

......

{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "。"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 398, "characters": 0, "total_tokens": 426, "image_count": 2, "size": "1280*1280"}}
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "stop", "message": {"role": "assistant", "content": [{"type": "image", "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}], "audio": null, "finished": true}, "usage": {"input_tokens": 28, "output_tokens": 523, "characters": 0, "total_tokens": 551, "image_count": 3, "size": "1280*1280"}}

DashScope Java SDK调用

SDK 的参数命名与HTTP接口基本一致，参数结构根据语言特性进行封装。 由于任务耗时较长，SDK 在底层封装了 HTTP 异步调用流程，支持同步、异步两种调用方式。
具体耗时受限于排队任务数和服务执行情况，请在获取结果时耐心等待。
请确保 DashScope Java SDK 版本不低于2.22.6，再运行以下代码。
各地域的base_url和 API Key 不通用，以下示例以北京地域为例进行调用：
  • 华北2（北京）
  • 新加坡
  • 美国（弗吉尼亚）
  • 德国（法兰克福）
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1调用时请将{WorkspaceId}替换为真实的Workspace ID。
全球部署范围（法兰克福地域）仅支持异步调用。

图像编辑

  • 同步调用
  • 异步调用
请求示例 
import com.alibaba.dashscope.aigc.imagegeneration.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.util.Arrays;
import java.util.Collections;

/**
 * wan2.6-image 图像编辑 - 同步调用示例
 */
public class Main {

    static {
        // 以下为北京地域url，各地域的base_url不同
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1";
    }

    // 若没有配置环境变量，请用百炼API Key将下行替换为：apiKey="sk-xxx"
    // 各地域的API Key不同。获取API Key：https://help.aliyun.com/zh/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void basicCall() throws ApiException, NoApiKeyException, UploadFileException {
        // 构建多图输入消息
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Arrays.asList(
                        // 支持多图输入，可以提供多张参考图片
                        Collections.singletonMap("text", "参考图1的风格和图2的背景，生成番茄炒蛋"),
                        Collections.singletonMap("image", "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"),
                        Collections.singletonMap("image", "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp")
                )).build();

        // 图像编辑使用普通同步调用，不需要设置stream和enable_interleave
        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.6-image")
                .messages(Collections.singletonList(message))
                .n(1)
                .size("1K")
                .negativePrompt("")
                .promptExtend(true)
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        ImageGenerationResult result = null;
        try {
            System.out.println("---sync call for image editing, please wait a moment----");
            result = imageGeneration.call(param);
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            basicCall();
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            System.out.println(e.getMessage());
        }
    }
}
响应示例
url 有效期24小时，请及时下载图像。 
{
    "requestId": "b148327e-830f-414c-a8df-724dec28exxx",
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "total_tokens": 0,
        "image_count": 1,
        "size": "1376*768"
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "finished": true
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

图文混合输出

  • 同步调用（仅支持流式）
  • 异步调用
请求示例 
import com.alibaba.dashscope.aigc.imagegeneration.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;
import io.reactivex.Flowable;

import java.util.Collections;

/**
 * wan2.6-image 图文输出 - 流式调用示例
 */
public class Main {

    static {
        // 以下为北京地域url，各地域的base_url不同
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1";
    }

    // 若没有配置环境变量，请用百炼API Key将下行替换为：apiKey="sk-xxx"
    // 各地域的API Key不同。获取API Key：https://help.aliyun.com/zh/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void streamCall() throws ApiException, NoApiKeyException, UploadFileException {
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Collections.singletonList(
                        Collections.singletonMap("text", "给我一个3张图辣椒炒肉教程")
                )).build();

        // 图文输出必须使用流式调用
        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.6-image")
                .messages(Collections.singletonList(message))
                .stream(true) // 必须开启流式输出
                .enableInterleave(true)
                .size("1280*1280")
                .negativePrompt("")
                .maxImages(3)
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        try {
            System.out.println("---stream call for image interleave----");
            Flowable<ImageGenerationResult> resultFlowable = imageGeneration.streamCall(param);
            resultFlowable.blockingForEach(result -> {
                System.out.println(JsonUtils.toJson(result));
            });
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
    }

    public static void main(String[] args) {
        try {
            streamCall();
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}
响应示例
url 有效期24小时，请及时下载图像。 
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":0,"total_tokens":28,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"辣椒"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":1,"total_tokens":29,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"炒"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":2,"total_tokens":30,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"肉"}]}}],"finished":false},"status_code":200,"code":"","message":""}

......

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":73,"total_tokens":101,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"。"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":198,"total_tokens":226,"image_count":1,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"image","image":"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":199,"total_tokens":227,"image_count":1,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"接下来"}]}}],"finished":false},"status_code":200,"code":"","message":""}

......

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":245,"total_tokens":273,"image_count":1,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"。"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":368,"total_tokens":396,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"image","image":"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":369,"total_tokens":397,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"最后"}]}}],"finished":false},"status_code":200,"code":"","message":""}

......

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":416,"total_tokens":444,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"锅"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":417,"total_tokens":445,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"。"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":541,"total_tokens":569,"image_count":3,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"stop","message":{"role":"assistant","content":[{"type":"image","image":"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}],"finished":true},"status_code":200,"code":"","message":""}

使用限制

  • 数据时效：任务task_id和 图像url均只保留 24 小时，过期后将无法查询或下载。
  • 内容审核：输入的 prompt 和输出的图像均会经过内容安全审核，包含违规内容的请求将报错“IPInfringementSuspect”或“DataInspectionFailed”，具体参见错误码。

计费与限流

  • 模型免费额度和计费单价请参见模型价格。
  • 模型限流请参见万相。
  • 计费说明：按成功生成的 图像张数 计费。模型调用失败或处理错误不产生任何费用，也不消耗新人免费额度。

错误码

如果模型调用失败并返回报错信息，请参见错误码进行解决。

常见问题

Q：为什么代码示例无法调用？ A：请升级您的SDK版本到最新版，更新请参考安装SDK。
阿里云百炼 home page阿里云百炼
使用 API
文本生成
图像生成
视频生成
3D模型生成
音频
实时多模态
Realtime API
  • 概述
向量与排序
更多模型
工具包/框架
模型生产
文件管理
更多