POST
支持模型 wan3.0-video 和 wan3.0-video-prime。两者使用相同请求结构,但模型权限和价格独立。

请求参数

string
required
wan3.0-video 或 wan3.0-video-prime。模型必须在当前 Key 的目录中。
string
required
描述主体、动作、构图、镜头和光影。也兼容 input.prompt,顶层 prompt 优先。
integer | string
default:"5"
视频时长,取值为 2–30 秒,支持整数或整数字符串。
string
default:"1080P"
视频分辨率,取值为 480P、720P 或 1080P。
string
画面宽高比,例如 16:9、9:16、1:1、4:3、3:4。可用比例见所选模型的分组说明。
string
首帧或参考图的公开 URL。参考图模式需在所选分组中开通。
array<string>
参考图 URL 数组,用于已开通多图参考能力的分组。
string
生成模式:first-last-frame 为首尾帧,all-reference 为参考素材;选择分组已开通的模式。
object
扩展素材参数,例如 first_frame_url、last_frame_url、reference_image_urls、reference_video_urls、reference_audio_urls。

参数优先级

建议统一使用 seconds 和 size。同时提交别名字段时,按上表优先级读取。 普通版与 Prime 的价格分别列在模型广场。

使用参考素材

参考图示例中的 URL 需要替换为实际素材地址,并确保链接可被服务端访问。首帧、首尾帧和多素材模式需使用支持对应功能的分组。

查询生成结果

保存创建响应中的任务 ID,通过Wan 3.0 查询与下载查看进度,完成后下载视频。