创建视频
通过平台公共字段创建 Wan 3.0 文生、图生或多模态参考任务。
平台格式使用顶层公共参数和 metadata，不要将原生 input/parameters 直接放入此请求。平台自动异步创建任务，提交成功后再查询结果。
/v1/videosAuthorization
bearerAuth 使用平台 API Key：Authorization: Bearer your-api-key。
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
提示词或非空 metadata.media 至少提供一项；使用 JSON，不使用 multipart/input_reference/image/images。
Response Body
application/json
application/json
application/json
参数填写与优先级
| 配置 | 填写方式与优先级 |
|---|---|
| 提示词与素材 | prompt 与非空 metadata.media 至少提供一项；图片不使用顶层 image/images/input_reference |
| 分辨率 | 非空 size → 非空 metadata.resolution → 非空 metadata.size → 1080P；填写档位，不使用像素宽高 |
| 时长 | 显式 duration → 非空 seconds → metadata.duration → 5；duration 是整数，seconds 是整数字符串 |
| 随机种子 | 显式顶层 seed 优先于 metadata.seed；0 是有效值 |
| 其他设置 | 比例、音轨、改写、水印放在 metadata；显式 false 会保留 |
建议每项配置只使用一种填写方式。分辨率和 seconds 的空白字符串按未填写处理；填写素材时可省略 prompt。无效的高优先级参数会报错，不会自动回退到低优先级值。
场景与素材
请求示例提供文生、首帧、首尾帧、混合参考、文件、网页、编辑和延长八种场景。选择素材场景后，将示例地址替换为自己的可访问地址。
首尾帧模式不能混入参考素材；尾帧需要首帧。文件和网页二选一，并开启提示词改写。具体格式、数量、尺寸及时长要求参见素材与组合规则，平台格式使用相同素材规则。
创建结果与兼容路径
创建返回 video 对象；保存 id，后续通过平台查询接口获取结果。task_id 为兼容字段，与 id 相同。queued 表示已接收，不代表视频已生成。
也支持 POST /v1/video/generations 和 POST /v1/videos/generations，请求参数与返回结构相同；新接入使用本页主路径 POST /v1/videos。
常见错误
HTTP 400 时，根据返回的错误信息检查参数类型、分辨率档位、素材组合和 metadata 字段名。错误响应可能使用 code/message/data 结构，也可能包含嵌套的 error 对象。