万相-通用图像编辑wan2.5模型仅需文本指令,即可基于单张或多张参考图像,实现主体一致的图像编辑、多图融合等能力。
快速入口:使用指南
在调用前,先获取与配置 API Key,再配置API Key到环境变量。如需通过SDK进行调用,请安装DashScope SDK。
由于图像编辑任务耗时较长(通常为1-2分钟),API采用异步调用。整个流程包含 “创建任务 -> 轮询获取” 两个核心步骤,具体如下:
北京地域:
SDK 的参数命名与HTTP调用基本一致,参数结构根据语言特性进行封装。
由于图像编辑任务耗时约30秒~60秒,SDK 在底层封装了 HTTP 异步调用流程,支持同步、异步两种调用方式。
如果模型调用失败并返回报错信息,请参见错误码进行解决。
模型概览
模型功能 | 输入示例 | 输出图像 |
|---|---|---|
单图编辑 | ![]() | ![]() 将花卉连衣裙换成一件复古风格的蕾丝长裙,领口和袖口有精致的刺绣细节。 |
多图融合 | ![]() | ![]() 将图1中的闹钟放置到图2的餐桌的花瓶旁边位置 |
模型名称 | 模型简介 | 输出图像规格 |
|---|---|---|
wan2.5-i2i-preview | 万相2.5 preview 支持单图编辑、多图融合 | 图片格式:PNG。 图像分辨率:
|
调用前,请查阅各地域支持的模型列表与价格。
前提条件
在调用前,先获取与配置 API Key,再配置API Key到环境变量。如需通过SDK进行调用,请安装DashScope SDK。
HTTP调用
由于图像编辑任务耗时较长(通常为1-2分钟),API采用异步调用。整个流程包含 “创建任务 -> 轮询获取” 两个核心步骤,具体如下:
具体耗时受限于排队任务数和服务执行情况,请在获取结果时耐心等待。
步骤1:创建任务获取任务ID
北京地域:POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
新加坡地域:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
调用时请将{WorkspaceId}替换为真实的业务空间ID。
- 创建成功后,使用接口返回的
task_id查询结果,task_id 有效期为 24 小时。请勿重复创建任务,轮询获取即可。 - 新手指引请参见Postman。
请求参数请求头(Headers)Content-Typestring(必选)请求内容类型。此参数必须设置为application/json。Authorizationstring(必选)请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值:Bearer sk-xxxx。X-DashScope-Asyncstring(必选)异步处理配置参数。HTTP请求只支持异步,必须设置为enable。请求体(Request Body)modelstring (必选)模型名称。详情参见模型列表与价格。示例值:wan2.5-i2i-preview。input object (必选)输入的基本信息,如提示词等。
属性 prompt string (必选)正向提示词,用来描述生成图像中期望包含的元素和视觉特点。支持中英文,长度不超过2000个字符,每个汉字/字母占一个字符,超过部分会自动截断。提示词的使用技巧请参见文生图Prompt指南。示例值:一只坐着的橘黄色的猫,表情愉悦,活泼可爱,逼真准确。images array of string (必选)图像URL数组。
string (可选)反向提示词,用来描述不希望在画面中看到的内容,可以对画面进行限制。支持中英文,长度不超过500个字符,超过部分会自动截断。示例值:低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。object (可选)图像处理参数。如设置图像分辨率、开启prompt智能改写、添加水印等。
属性 size string (可选)设置输出图像的分辨率,格式为宽*高。默认值为 1280*1280。
推荐分辨率及对应宽高比
size,系统将默认生成总像素为 1280*1280 的图像,并按以下规则保持宽高比(近似值):
integer (可选)生成图片的数量。取值范围为1~4张,默认为4。为控制成本,测试建议显式设置为1。watermark boolean (可选)是否添加水印标识,水印位于图片右下角,文案固定为“AI生成”。
boolean (可选)是否开启prompt智能改写。开启后使用大模型对输入prompt进行智能改写,提升综合表现,但会增加耗时。
integer (可选)随机数种子,取值范围是[0, 2147483647]。如果不提供,则算法自动生成一个随机数作为种子。如果提供,则根据n的值分别为n张图片生成seed参数,例如n=4,算法将分别生成seed、seed+1、seed+2、seed+3作为参数的图片。若需提升生成结果的可复现性,建议固定seed值。请注意,由于模型生成具有概率性,即使使用相同 seed,也不能保证每次生成结果完全一致。 |
响应参数outputobject任务输出信息。
属性 task_id string任务ID。查询有效期24小时。task_status string任务状态。
枚举值
string请求唯一标识。可用于请求明细溯源和问题排查。codestring请求失败的错误码。请求成功时不会返回此参数,详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误码。 |
请保存 task_id,用于查询任务状态与结果。 |
步骤2:根据任务ID查询结果
- 华北2(北京)
- 新加坡
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}调用时请将{WorkspaceId}替换为真实的Workspace ID。请求参数请求头(Headers)Authorizationstring(必选)请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值:Bearer sk-xxxx。URL路径参数(Path parameters)task_idstring(必选)任务ID。 |
请将 86ecf553-d340-4e21-xxxxxxxxx替换为真实的task_id。若使用新加坡地域的模型,需将base_url替换为https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx,其中{WorkspaceId}需替换为真实的业务空间ID。 |
响应参数outputobject任务输出信息。
属性 task_id string任务ID。查询有效期24小时。task_status string任务状态。
枚举值
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。results array of object任务结果列表,包括图像URL、prompt、部分任务执行失败报错信息等。
属性 orig_prompt string原始输入的prompt,对应请求参数prompt。actual_prompt string开启 prompt 智能改写后,返回实际使用的优化后 prompt。若未开启该功能,则不返回此字段。url string模型生成图片的URL地址。code string图像错误码。部分任务执行失败时会返回该字段。message string图像错误信息。部分任务执行失败时会返回该字段。object任务结果统计。
属性 TOTAL integer总的任务数。SUCCEEDED integer任务状态为成功的任务数。FAILED integer任务状态为失败的任务数。string请求失败的错误码。请求成功时不会返回此参数,详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误码。object输出信息统计。只对成功的结果计数。
属性 image_count integer模型成功生成图片的数量。计费公式:费用 = 图片数量 × 单价。string请求唯一标识。可用于请求明细溯源和问题排查。 |
图像URL仅保留24小时,超时后会被自动清除,请及时保存生成的图像。 |
DashScope SDK调用
SDK 的参数命名与HTTP调用基本一致,参数结构根据语言特性进行封装。
由于图像编辑任务耗时约30秒~60秒,SDK 在底层封装了 HTTP 异步调用流程,支持同步、异步两种调用方式。
具体耗时受限于排队任务数和服务执行情况,请在获取结果时耐心等待。
Python SDK调用
- 同步调用
- 异步调用
请求示例
本示例支持三种图像输入方式:公网URL、Base64编码、本地文件路径。响应示例
url 有效期24小时,请及时下载图像。
Java SDK调用
- 同步调用
- 异步调用
请求示例
本示例支持三种图像输入方式:公网URL、Base64编码、本地文件路径。响应示例
url 有效期24小时,请及时下载图像。
使用限制
- 数据时效:任务task_id和 图像url均只保留 24 小时,过期后将无法查询或下载。
- 内容审核:输入prompt、图像和输出图像均会经过内容安全审核,包含违规内容的请求将报错“IPInfringementSuspect”或“DataInspectionFailed”,具体参见错误码。



