Skip to main content
POST

Wan 3.0 视频生成

Wan 3.0 通过 POST /v1/videos 提交异步视频任务。请求体使用 application/json,客户端统一访问 https://magic666.top

方法与路径

认证

请求示例

响应示例

Body

string
required
模型名称。支持 wan3.0-video(标准版)和 wan3.0-video-prime(优速版)。模型必须已在当前账户分组中开通。
string
required
视频生成提示词。建议描述主体、动作、镜头运动、构图、光影和风格。文生、图生和参考素材场景都建议传入。
string | integer
生成时长,单位为秒。支持 230 秒,默认值为 5。可以传数字 5,也可以传字符串 "5"
integer
时长兼容字段,单位为秒。与顶层 seconds 同时传入时,优先使用 seconds
string
输出分辨率档位。支持 480P720P1080P,未传时默认使用 1080P。Wan 3.0 不使用 WxH 字符串作为主分辨率字段。
string
输出画幅比例。支持 16x9 / 16:99x16 / 9:161x1 / 1:14x3 / 4:33x4 / 3:4adaptive
string
单张首帧图或参考图 URL。必须是服务端可访问的 http://https:// 地址。单独传一张图时会映射为上游的 first_frame
array<string>
多张参考图 URL。没有首尾帧标记且传入至少两张时,会映射为多个 reference_image;参考图最多 10 张。
string | array<string>
OpenAI Videos 兼容的参考图字段。传字符串时等同于一张图片,传数组时会并入 images
string
生成模式提示。first-last-framefirst_last_framekf2v 表示首尾帧;all-referencereferencer2v 表示全能参考。
object
扩展参数。常用字段包括 first_frame_urllast_frame_urlreference_image_urlsreference_video_urlsreference_audio_urlsparameters.audio
object
高级原生请求结构。input.media 存在时会原样透传,媒体类型使用 first_framelast_framereference_imagereference_videoreference_audio
object
高级参数对象。原生结构中常用 resolutionratiodurationaudio

参数优先级

时长优先级:
  1. 顶层 seconds
  2. 顶层 duration
  3. metadata.parameters.duration
  4. 默认值 5
分辨率优先级:
  1. 顶层 size
  2. metadata.parameters.resolution
  3. 默认值 1080P
画幅优先级:
  1. 顶层 aspect_ratio
  2. metadata.parameters.ratio

请求构造规则

首尾帧和参考素材是互斥场景。不要在同一个请求中混合 first_frame / last_framereference_image / reference_video / reference_audio。需要首尾帧时,显式传 mode 和首尾帧 URL。

相关接口