Wan 3.0 视频
Wan 3.0 是通义万相视频生成系列,统一通过 Magic API 视频接口调用。客户端使用POST /v1/videos 创建异步任务,使用 GET /v1/videos/{task_id} 查询任务状态,并可通过 GET /v1/videos/{task_id}/content 下载生成结果。
接口信息
创建视频任务
使用
wan3.0-video 或 wan3.0-video-prime 提交文生、图生、首尾帧和多图参考任务。查询视频任务
轮询任务状态,读取结果地址,并在需要时下载生成的视频内容。
支持模型
模型是否可用取决于当前账户分组和渠道配置。请求中的
model 必须与已开通的模型名称一致。
支持能力
请求字段速览
分辨率与画幅
size 只表示分辨率档位,不使用 1280x720 这类 WxH 字符串作为 Wan 3.0 的主分辨率字段。画幅请通过 aspect_ratio 指定。
参考素材限制
- 参考图最多
10张。 - 参考视频最多
5个。 - 参考音频最多
5个。 - 参考素材应使用服务端可访问的
http://或https://URL。 first_frame/last_frame不能与reference_image、reference_video、reference_audio、file或link混传。
媒体类型判定
如果不直接使用原生input.media,接口按以下顺序判断媒体类型:
- 已提供
input.media时,原样透传给上游,不再自动映射。 - 存在首尾帧字段或
mode: first-last-frame时,映射为first_frame和last_frame。 - 存在参考类 metadata、
mode: all-reference或至少两张图片时,映射为reference_image。 - 只有一张图片时,映射为
first_frame。 - 没有图片或其他媒体时,按文生视频处理。
images 数组顺序,建议同时传 mode 和 metadata.first_frame_url / metadata.last_frame_url。