认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID
值: wan25_i2i_preview_intl
input object 必填
生成请求的输入数据
prompt
string必填正向提示词, 用来描述生成图像中期望包含的元素和视觉特点. 支持中英文. 每个汉字或字母占一个字符. 超过部分会自动截断.
最大长度：
2000个字符示例：
一只坐着的橘黄色的猫, 表情愉悦, 活泼可爱, 逼真准确.
images
array of string必填图像 URL 数组或 Base64 编码字符串数组. 支持单图编辑和多图融合.
数组最大长度：
3张图片. 多图输入时, 按照数组顺序定义图像顺序.图像限制：
图像格式：JPEG, JPG, PNG（不支持透明通道）, BMP, WEBP
图像分辨率：图像的宽高范围均为384到5000像素
文件大小：不超过10MB输入格式：
方式 1：公开可访问的 URL（HTTP 或 HTTPS）
示例：http://wanx.alicdn.com/material/xxx.jpeg方式 2：Base64 编码
格式：data:{MIME_type};base64,{base64_data}
示例：data:image/jpeg;base64,GDU7MtCZzEbTbmRZ...
negative_prompt
string反向提示词, 用来描述不希望在画面中看到的内容, 可以对画面进行限制. 支持中英文. 超过部分会自动截断.
最大长度：
500个字符示例：
低分辨率, 错误, 最差质量, 低质量, 残缺, 多余的手指, 比例不良.
parameters object
图像处理参数
size
string输出图像分辨率, 格式为
宽*高. 总像素在[768×768, 1280×1280]之间, 且宽高比范围为[1:4, 4:1].若未指定, 系统将默认生成总像素为 1280×1280 的图像, 并按以下规则保持宽高比（近似值）：
单图输入——宽高比与输入图像一致
多图输入——宽高比与最后一张输入图像一致常见宽高比推荐分辨率：
1:1：1280×1280或1024×1024
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默认值:
1280×1280
n
integer生成图片的数量. 该参数直接影响费用——n 越大费用越高, 请在调用前确认模型价格. 建议在测试阶段显式设置为
1以控制成本.范围:
1-4默认值:
4
watermark
boolean是否添加水印标识. 水印位于图像右下角, 文案固定为「AI生成」.
可选值:
false,true默认值:
false
prompt_extend
boolean是否开启 prompt 智能改写. 开启后使用大模型对输入 prompt 进行智能改写, 提升综合表现, 但会增加耗时.
可选值:
true,false默认值:
true
seed
integer随机数种子. 若不提供, 算法自动生成一个随机数作为种子. 若提供, 则根据
n的值分别为每张图片生成 seed 参数——例如n=4时, 算法将分别生成seed、seed+1、seed+2、seed+3作为参数.注意： 模型生成具有概率性, 即使使用相同 seed, 也不能保证每次生成结果完全一致.
范围:
0-2147483647
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息, 仅在状态为 failed 时存在
code
string错误码
message
string详细错误信息
output array
生成结果, 仅在状态为 completed 时存在
content
array生成的资源内容列表
type
string资源类型
值:
image｜videourl
string处理后的资源 URL
jobId
string远端任务 ID
usage object
使用统计, 仅在状态为 completed 时存在
cost
string总费用（美元）
discount
number折扣金额
metadata object
元数据信息