Submit Wan 3.0 native video task

Submit an asynchronous native Wan 3.0 task and save its ID for querying.

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

Auth: Bearer sk-xxx

This page covers the native POST submission endpoint, whose response structure differs from `/v1/videos/generations`. Step 1: POST `/api/v1/services/aigc/video-generation/video-synthesis` and save `output.task_id`. Step 2: GET `/api/v1/tasks/{task_id}` with the same account API key. See [Get Wan 3.0 native video task](/docs/get-wan3-native-task) for the GET request and complete success, pending, and failed responses. Submit `model`, `input`, and `parameters`; save `output.task_id` and query `GET /api/v1/tasks/{task_id}`. Do not use `wait=true` or resubmit an accepted task. All IDs, timestamps, prompt text, and URLs in the examples are fictional. This gateway adds `X-DashScope-Async: enable` to its outgoing Alibaba Cloud request, so clients do not send that header. Direct calls to Alibaba Cloud still require it.

Request body

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

Responses

200 — 任务已接收；保存 `output.task_id` 以查询结果。
400 — 提交参数无效；在创建任务前返回。
401 — API Key 无效或缺失。
402 — 可用余额不足。
503 — 服务暂不可用或当前档位不可用。

Example

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}
  }'

Save `output.task_id` and query the same task at [Get Wan 3.0 native video task](/docs/get-wan3-native-task). The response examples on this page apply to POST.

API reference