认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: wan22_i2v_plus
input object 必需
输入的基本信息对象, 包含提示词和首帧图像
prompt
string文本提示词, 用于描述生成视频中期望包含的元素和视觉特点
支持中英文, 每个汉字或字母占一个字符, 超过部分会自动截断
对wan2.2和wan2.1系列模型, 长度不超过800个字符
negative_prompt
string反向提示词, 用于描述不希望在视频画面中看到的内容, 可对画面进行限制
支持中英文, 长度不超过500个字符, 超过部分会自动截断
img_url
string必需首帧图像的 URL 或 Base64 编码数据
图像限制:
格式: JPEG, JPG, PNG（不支持透明通道）, BMP, WEBP
分辨率: 宽和高范围360-2000像素
文件大小: 不超过10MB支持的输入格式:
公网 URL（HTTP 或 HTTPS）
Base64 字符串, 格式为data:{MIME_type};base64,{base64_data}
parameters object
视频处理参数, 如分辨率档位、时长、prompt 智能改写、水印和随机种子
resolution
string指定生成视频的分辨率档位, 模型会缩放到相近总像素, 且尽量保持与
img_url接近的宽高比可选值:
480P,1080P默认值:
1080P
duration
integer对
wan2.2-i2v-plus, 时长固定为5秒, 不支持修改值:
5
prompt_extend
boolean是否开启 prompt 智能改写, 开启后用大模型改写输入 prompt, 对较短 prompt 生成效果提升明显, 但会增加耗时
可选值:
true,false默认值:
true
watermark
boolean是否添加水印标识, 水印位于视频右下角
可选值:
false,true默认值:
false
seed
integer随机数种子范围为
0到2147483647, 未指定时系统自动生成随机种子
固定seed可提升结果可复现性, 但即使 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
元数据信息