提交万相 3.0 原生视频任务

按百炼原生参数异步提交万相 3.0 视频任务；使用返回的任务 ID 查询结果。

POST /api/v1/services/aigc/video-generation/video-synthesis

鉴权: Bearer sk-xxx

本页说明万相 3.0 原生视频提交接口；它与 `/v1/videos/generations` 通用接口使用不同的响应结构。本站提交时无需客户端发送 `X-DashScope-Async`；网关转发百炼时会设置 `X-DashScope-Async: enable`。直接请求百炼官方地址仍须按其文档携带该头。 | 入口 | 新异步任务提交 HTTP 状态 | 查询用的任务 ID | 提交状态字段 | |---|---:|---|---| | 本页原生 `POST /api/v1/services/aigc/video-generation/video-synthesis` | `200` | `output.task_id` | `output.task_status=PENDING` | | 旧通用 `POST /v1/videos/generations` | 通常 `202` | 顶层 `id` | 顶层 `status=submitted` | 两条入口共用本站任务与计费流程，但分别按各自协议构造客户响应。**原生响应采用百炼的字段层级，不是把百炼原始 HTTP 正文逐字节透传。**例如本页 `request_id` 是本站请求追踪标识，`output.task_status` 由本站任务状态转换；请按所调用入口读取 ID，后续查询路径也不能混用。 ## 两步调用 1. **提交：**`POST /api/v1/services/aigc/video-generation/video-synthesis`，保存响应中的 `output.task_id`。 2. **查询：**`GET /api/v1/tasks/{task_id}`，用同一账号的 `Authorization: Bearer <TOKEN>`。`PENDING`／`RUNNING` 时继续查同一 ID；`SUCCEEDED` 时读取 `output.video_url` 与顶层 `usage`。完整 GET 命令及成功、处理中、失败响应见[查询万相 3.0 原生视频任务](/docs/get-wan3-native-task)。 提交请求仅含顶层 `model`、`input`、`parameters`；`duration` 与 `resolution` 只放在 `parameters` 内。客户端无需传异步请求头；受理后返回 `output.task_id`，再按本页下方的查询示例请求 `GET /api/v1/tasks/{task_id}`。不支持 `wait=true`；任务已受理时不要重复 POST。 `parameters.duration` 可填 2–30 的整数或 `-1`（智能时长），省略默认为 5 秒；`parameters.resolution` 可用 `480P`、`720P`、`1080P`，省略默认为 `1080P`。有参考视频时，输入与输出总时长不能超过 30 秒。最终费用以成功任务的实际用量为准。 可用模型为 `wan3.0-video`、`wan3.0-video-prime`。本页任务 ID、请求 ID、时间、提示词及地址均为虚构示例；字段层级对照[百炼万相 3.0 官方文档](https://docs.modelstudio.console.alibabacloud.com/zh/model-studio/wan3-video-generation-api-reference)和本站已验收的原生返回结构。

请求体

modelstringrequired模型 ID。
inputobjectrequired生成输入；`prompt` 与 `media` 至少提供一项。
input.promptstring描述视频内容的提示词。
input.mediaarray可选参考素材；每项包含 `type` 和 `url`。
input.media[].typestring素材用途。首帧／尾帧与参考素材不能混用。
input.media[].urlstring可公开读取的 HTTPS 素材 URL；图片也可使用符合格式的数据 URI。
parametersobject视频参数对象；建议显式传入时长与分辨率。
parameters.durationinteger输出时长：2–30 的整数；`-1` 为智能时长。默认 5 秒。有视频输入时，输入与输出总时长不超过 30 秒。
parameters.resolutionstring输出分辨率，默认 `1080P`。
parameters.ratiostring画面比例，可用 `adaptive`、`16:9` 等官方支持的值。
parameters.audioboolean是否生成音频。
parameters.prompt_extendboolean是否开启提示词改写；使用 `file` 或 `link` 时必须为 `true`。
parameters.seedinteger可选随机种子。
parameters.watermarkboolean是否添加水印。

响应

调用示例

curl --request POST 'https://api.router.ai/api/v1/services/aigc/video-generation/video-synthesis' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "wan3.0-video",
    "input": {"prompt": "蓝色圆点沿白色背景向右移动，简洁动画。"},
    "parameters": {"resolution": "480P", "ratio": "adaptive", "duration": 2, "prompt_extend": true}
  }'

## 查询结果 提交后保存 `output.task_id`，按[查询万相 3.0 原生视频任务](/docs/get-wan3-native-task)轮询同一任务；不要重复提交。 ## 智能时长与参考素材 把提交示例中的 `parameters.duration` 改为 `-1` 即可启用智能时长。`input.media` 可传带 `type` 和 `url` 的素材对象；首帧／尾帧不能与参考素材混用。传 `file` 或 `link` 时须设 `parameters.prompt_extend=true`。完整素材组合、格式、大小限制以百炼官方文档为准。 ## 提交错误 额外传顶层 `duration`／`resolution`、传入 `wait` 或无效时长时会在提交前拒绝。右侧响应选项卡描述本页的 POST 提交；GET 的完整响应见独立查询文档。

API 文档