Skip to main content
POST
创建万相 3.0 视频任务
万相 3.0 使用 All-in-One 模型:根据 input.media 中的素材类型及提示词意图,自动处理文生视频、首帧或首尾帧图生视频、全模态参考生成、视频编辑和视频延长。与 万相 2.7 视频生成接口 不同,3.0 无需为不同能力选择独立的文生、图生或编辑模型。 接口沿用万相视频任务协议。无需携带 X-DashScope-Async 请求头,网关已内置异步任务语义。

请求结构

请求体由 modelinputparameters 三部分组成: media[].url 可使用可公开访问的 HTTP/HTTPS URL、OSS 临时 URL 或 base64 data URI。使用 base64 data URI 时,网关会先将素材转存后再提交给上游。

认证方式

在请求头中携带 Authorization,格式为 Bearer YOUR_API_KEY

支持的模型

能力与素材类型

万相 3.0 可以生成带原生同步声音的视频,最长 30 秒。通过 input.media 提供素材:
first_frame / last_framereference_image / reference_video / reference_audio / file / link 互斥,不能出现在同一请求中。filelink 二选一,但都可以与参考图、参考视频和参考音频组合使用;三个 reference_* 类型可以自由组合。
首帧或首尾帧模式仅能传入 first_frame 和可选的 last_frame,不能同时传入音频等其他媒体。需要用声音驱动画面时,请使用全模态参考模式,例如 reference_imagereference_audio

关键参数

对于视频编辑,使用 reference_video 并在提示词中明确说明替换、删除或修改的目标。对于视频延长,在提示词中说明延长、续写、向前或向后延伸等意图。编辑或延长视频时,建议使用 ratio: "adaptive"duration: -1

快速提交

下面以文生视频为例。创建成功后使用响应中的 output.task_id 查询任务结果。

场景示例

首尾帧图生视频

首尾帧模式只放入首帧和尾帧,不要混入 reference_*filelink

文件参考生成

file 最多传一个,且不能与 link 一起使用。该模式必须开启或省略 prompt_extend

网页与参考图生成

link 使用公开且无需登录的网页。它可以与 reference_image 等参考媒体组合。

全模态参考生成

参考图、参考视频和参考音频可组合使用。数组中图、视频和音频分别按出现顺序编号。

视频编辑

使用 reference_video,并把编辑目标直接写进提示词。

视频延长

使用 reference_video,并明确说明续写方向或后续画面。
创建成功后会返回任务 ID:

下一步

请求头

Authorization
string
必填

API Key,格式为 Bearer YOUR_API_KEY

示例:

"Bearer YOUR_API_KEY"

Content-Type
string
必填

请求体类型

示例:

"application/json"

请求体

application/json
model
string
必填

万相 3.0 All-in-One 模型标识:wan3.0-video 或 wan3.0-video-prime

input
object
必填

输入内容(提示词与媒体元素)

parameters
object

生成参数

响应

200 - application/json

任务创建成功

request_id
string

网关请求 ID

output
object