Skip to main content

Wan 3.0 视频

Wan 3.0 是通义万相视频生成系列,统一通过 Magic API 视频接口调用。客户端使用 POST /v1/videos 创建异步任务,使用 GET /v1/videos/{task_id} 查询任务状态,并可通过 GET /v1/videos/{task_id}/content 下载生成结果。

接口信息

创建视频任务

使用 wan3.0-videowan3.0-video-prime 提交文生、图生、首尾帧和多图参考任务。

查询视频任务

轮询任务状态,读取结果地址,并在需要时下载生成的视频内容。

支持模型

模型是否可用取决于当前账户分组和渠道配置。请求中的 model 必须与已开通的模型名称一致。

支持能力

请求字段速览

分辨率与画幅

size 只表示分辨率档位,不使用 1280x720 这类 WxH 字符串作为 Wan 3.0 的主分辨率字段。画幅请通过 aspect_ratio 指定。

参考素材限制

  • 参考图最多 10 张。
  • 参考视频最多 5 个。
  • 参考音频最多 5 个。
  • 参考素材应使用服务端可访问的 http://https:// URL。
  • first_frame / last_frame 不能与 reference_imagereference_videoreference_audiofilelink 混传。

媒体类型判定

如果不直接使用原生 input.media,接口按以下顺序判断媒体类型:
  1. 已提供 input.media 时,原样透传给上游,不再自动映射。
  2. 存在首尾帧字段或 mode: first-last-frame 时,映射为 first_framelast_frame
  3. 存在参考类 metadata、mode: all-reference 或至少两张图片时,映射为 reference_image
  4. 只有一张图片时,映射为 first_frame
  5. 没有图片或其他媒体时,按文生视频处理。
需要首尾帧时,不要仅依赖 images 数组顺序,建议同时传 modemetadata.first_frame_url / metadata.last_frame_url

相关页面