提交万相 3.0 视频任务

万相 3.0 全能参考视频生成 (All-in-One): 文生视频 / 图生视频 / 参考生视频, 最长 30 秒 · 30fps

POST /v1/videos/generations

鉴权: Bearer sk-xxx

万相 3.0 是**全能参考视频生成模型 (All-in-One)**，一个模型统一支持文生视频、图生视频（首帧/首尾帧）与参考生视频，最长可生成 **30 秒**、输出帧率 **30fps**。视频生成耗时较长（通常 1–5 分钟），本接口为**异步**：提交后立即返回 `task_id`，再用 [查询视频任务](/docs/get-video-task) 轮询结果。 ## ⚠️ 请求体必须「双写」万相系列采用**原生透传**：`input` / `parameters` 会原样送达模型，因此请求体需要同时包含两部分—— | 位置 | 作用 | 说明 | |---|---|---| | **顶层** `model` / `duration` / `resolution` | 计费与额度预估 | 平台按这里的值预扣费用 | | **嵌套** `input` / `parameters` | 实际生成参数 | 原样传给模型 | **两处的 `duration` / `resolution` 请保持一致**。若只写嵌套而顶层留空，平台会按默认值（5 秒 / 720P）预估额度，与实际生成不符。 ## 三种用法 - **文生视频**：`input.prompt` 写提示词即可 - **图生视频**：`input.media` 传入图片 URL（首帧，或首帧+尾帧） - **参考生视频**：`input.media` 传入图片 / 视频 / 音频 / 文件 / 网页链接，模型自动理解内容 ## 可用模型 | 模型 | 说明 | |---|---| | `wan3.0-video` | 万相 3.0 标准版 |

请求体

`model`	string	required	模型 ID，固定填 `wan3.0-video`
`duration`	integer		顶层计费字段。视频时长（秒），最长 30。需与 `parameters.duration` 保持一致。默认 5
`resolution`	string		顶层计费字段。分辨率档位：`480P` / `720P` / `1080P`。需与 `parameters.resolution` 保持一致。默认 `720P`
`input`	object	required	生成输入（原样传给模型）。子字段见下方 `input.*`
`input.prompt`	string	required	提示词，描述想要生成的画面内容
`input.media`	array		参考素材数组。每项形如 `{"type": "image"\|"video"\|"audio"\|"file", "url": "https://..."}`。用于图生视频（传首帧图）或参考生视频（传图片/视频/音频/文件/网页链接）
`input.negative_prompt`	string		反向提示词，描述不希望出现的内容
`parameters`	object		生成参数（原样传给模型）。子字段见下方 `parameters.*`
`parameters.resolution`	string		分辨率：`480P` / `720P` / `1080P`。默认 `720P`
`parameters.duration`	integer		视频时长（秒），最长 30。默认 5
`parameters.ratio`	string		画面宽高比。`adaptive` 表示由模型按输入素材自适应（推荐）。也可指定如 `16:9` / `9:16` / `1:1`
`parameters.seed`	integer		随机种子，用于复现生成结果。取值范围 `[0, 2147483647]`
`parameters.prompt_extend`	boolean		是否开启提示词智能改写。开启后由大模型对 prompt 智能扩写，短提示词的生成效果提升明显，但会增加耗时。默认 `true`
`parameters.audio`	boolean		是否生成同步音频
`parameters.watermark`	boolean		是否添加水印。默认 `false`

响应

200 — 任务已提交，返回 `task_id`，请用查询接口轮询结果

调用示例

curl https://api.router.ai/v1/videos/generations \
  -H "Authorization: Bearer $ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "duration": 10,
    "resolution": "480P",
    "input": {
      "prompt": "一只橘猫在窗台上伸懒腰，阳光透过纱帘洒进来，慢镜头，电影质感"
    },
    "parameters": {
      "resolution": "480P",
      "ratio": "adaptive",
      "duration": 10,
      "prompt_extend": true
    }
  }'

## 图生视频示例 ```json { "model": "wan3.0-video", "duration": 5, "resolution": "720P", "input": { "prompt": "镜头缓缓推进，人物转头微笑", "media": [ { "type": "image", "url": "https://example.com/first-frame.jpg" } ] }, "parameters": { "resolution": "720P", "duration": 5, "ratio": "adaptive" } } ``` ## 参考生视频示例 `input.media` 支持混合传入图片、视频、音频、文件与网页链接，模型会自动理解素材内容： ```json { "model": "wan3.0-video", "duration": 10, "resolution": "720P", "input": { "prompt": "根据参考素材生成产品宣传片", "media": [ { "type": "image", "url": "https://example.com/product.jpg" }, { "type": "file", "url": "https://example.com/brief.pptx" } ] }, "parameters": { "resolution": "720P", "duration": 10, "ratio": "adaptive" } } ``` ## 查询结果提交成功后用返回的 `task_id` 轮询： ```bash curl https://api.router.ai/v1/videos/generations/{task_id} \ -H "Authorization: Bearer $ROUTER_API_KEY" ``` 任务完成后（`status` 为 `succeeded`）响应中会带视频下载链接。建议轮询间隔 5–10 秒。 ## 常见问题 - **提示词越具体效果越好**：包含主体、动作、镜头运动、光线、风格等描述 - **`prompt_extend` 默认开启**：短提示词会被智能扩写，若希望严格按原文生成可设为 `false` - **时长与分辨率影响费用**：分辨率越高、时长越长费用越高，具体价格见模型广场

API 文档