Wan 3.0 Video Prime API

萬相 3.0 影片生成 Prime 版，畫質更高（480P/720P/1080P 按秒計費）

模型名: wan3.0-video-prime
厂商: Wan
类型: video

POST /v1/videos/generations

支援文本、首幀/首尾幀、多模態參考、編輯與延長；480P/720P/1080P、2–30 秒。

文生视频

必填参数: model, input, input.prompt

可用参数: model, input, input.prompt, input.media, input.media[].type, input.media[].url, parameters, parameters.resolution, parameters.ratio, parameters.duration, parameters.audio, parameters.prompt_extend, parameters.watermark, wait, idempotency_key

首帧图生视频

必填参数: model, input, input.media

首尾帧生视频

必填参数: model, input, input.media

多模态参考生视频

必填参数: model, input, input.media

参考文件/网页生视频

必填参数: model, input, input.media

视频编辑

必填参数: model, input, input.prompt, input.media

视频延长

必填参数: model, input, input.prompt, input.media

请求参数

参数	类型	必填	说明
`model`	string	是	本页模型名称。可选: wan3.0-video-prime
`input`	object	是	输入对象，prompt 与 media 至少提供一项。
`input.prompt`	string	否	视频内容描述，支持中英文，最多 20000 字符。
`input.media`	array	否	素材数组，每项包含 type 与 url；按所选场景配置。
`input.media[].type`	string	否	素材用途。首帧/首尾帧与参考素材两类不能混用。可选: first_frame / last_frame / reference_image / reference_video / reference_audio / file / link
`input.media[].url`	string	否	你自己的公网可访问素材地址；示例域名是占位值。
`parameters`	object	否	视频参数对象，按下面字段嵌套填写。
`parameters.resolution`	string	否	分辨率档位，默认 1080P。可选: 480P / 720P / 1080P
`parameters.ratio`	string	否	画面比例，默认 adaptive；首帧/编辑/延长建议 adaptive。可选: adaptive / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16
`parameters.duration`	integer	否	输出秒数，默认 5；可设 2–30，或 -1 智能时长。有视频输入时输入与输出总时长不超过 30 秒。
`parameters.audio`	boolean	否	是否生成音频，默认 true。
`parameters.prompt_extend`	boolean	否	提示词智能改写，默认 true；file/link 场景必须 true。
`parameters.watermark`	boolean	否	是否添加水印，默认 false。
`wait`	boolean	否	默认 false，提交后取得任务 ID，再按查询步骤获取结果。
`idempotency_key`	string	否	可选请求标识；一次生成请求保持同一个值。

## 查询生成结果将 `TASK_ID` 替换为提交响应中的 `id`： ```bash curl --request GET 'https://api.router.ai/v1/videos/generations/TASK_ID' \ -H "Authorization: Bearer $ROUTER_API_KEY" ``` `pending`、`submitted`、`processing` 表示尚未完成；`succeeded` 表示成功，可读取 `output.video_url`；`failed`、`timeout`、`canceled` 表示任务终止。完整成功响应见下方示例。结果可用后请及时下载保存。 ## 素材与场景约束 - 首帧与尾帧各最多 1 张；这类控制不能和参考素材、文件、网页混用。 - 参考图最多 10 张；参考视频与音频各最多 5 个、各合计不超过 15 秒；混合参考总数不超过 20。 - `file` 与 `link` 二选一、最多 1 个；可搭配参考素材，必须设置 `parameters.prompt_extend=true`。网页应无需登录即可访问。网页用法将文件场景的 `type` 换成 `link`。 - 有视频输入时，输入与输出总时长不超过 30 秒；编辑/延长可使用 `parameters.duration=-1`。 - 生成中的任务不支持取消。提交后请查询原任务，避免重复创建。 ## 官方文档地址 [万相 3.0 视频生成 API 参考](https://docs.modelstudio.console.alibabacloud.com/zh/model-studio/wan3-video-generation-api-reference) ## 视频生成成功：完整响应任务生成成功后，`GET /v1/videos/generations/{id}` 返回以下结构。**全部 ID、时间、提示词、视频地址与数值均为虚构示例，不含真实客户数据或凭据。** ```json { "request_id": "example-request-id", "output": { "task_id": "example-task-id", "task_status": "SUCCEEDED", "submit_time": "2000-01-01 00:00:00.000", "scheduled_time": "2000-01-01 00:00:01.000", "end_time": "2000-01-01 00:00:30.000", "orig_prompt": "这是一条虚构的视频提示词，仅用于说明响应格式。", "video_url": "https://example.com/generated-example.mp4" }, "usage": { "video_count": 1, "duration": 5.0, "input_video_duration": 0.0, "output_video_duration": 5.0, "fps": 30, "SR": 720, "ratio": "16:9" }, "id": "example-task-id", "model": "wan3.0-video-prime", "status": "succeeded", "created_at": 946656000, "error": null } ``` 以顶层 `status=succeeded` 判断生成成功，通过 `output.video_url` 获取视频。`usage` 提供视频数量、输入/输出/总时长、帧率、分辨率与宽高比；有参考视频输入时，`usage.duration` 是输入与输出时长之和。响应中 `model` 对应本页模型名，两款模型的响应结构相同。

请求示例

curl --request POST 'https://api.router.ai/v1/videos/generations' \
  -H "Authorization: Bearer $ROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "wan3.0-video-prime",
  "input": {
    "prompt": "一只橘猫在阳光下的花园散步，镜头缓慢推进。"
  },
  "parameters": {
    "resolution": "720P",
    "ratio": "adaptive",
    "duration": 5,
    "prompt_extend": true
  }
}'

接口通用说明: 提交影片任務