# WAN 3.0 视频生成

https://video-doc.1route.dev/zh/docs



请帮我把 1Route WAN3 视频生成接入正在使用的工具或项目，我不懂代码。
先阅读：https://video-doc.1route.dev/zh/llms-full.txt
只问缺少的信息：我用什么工具、它是否支持异步视频、想做文生还是图生/参考视频、测试预算。已有明确要求不要重复问。只支持聊天的工具不能仅靠填写模型名使用视频接口。
服务地址：https://video.1route.dev。在 https://video.1route.dev/keys/ 创建“视频”分组密钥；不要默认生图 Key 能用。
让程序从本地私密配置或受保护的输入读取 WAN3_API_KEY，不打印、不写公开代码，不让用户手动改大量代码。保留已有配置。
先 GET /v1/models，确认 Key 的模型权限。第一次付费测试优先提议 480p、2 秒；先展示模型、素材用途、预计费用和计价单位，得到确认后执行。
POST /v1/videos 只接受 JSON，seconds 用字符串，例如 "2"。图片使用 reference_images:[{url:"HTTPS直链"}]；参考视频使用 reference_videos:[{url:"HTTPS直链",duration:5}]。本地路径、网盘预览页不能当直链；未经同意不要把私人素材传到陌生图床。
成片 2–30 整数秒；参考视频最多 5 条，单条 1–15 整数秒，合计不超过 15 秒，成片+参考视频不超过 30 秒。image 系列不支持参考视频。若素材有小数秒，不猜计费取整规则。
image 费用=每秒价×成片秒数；video 费用=每秒价×（成片+去重后的参考视频秒数）。从 https://video.1route.dev/pricing/ 核对对应账户/分组的售价和单位。
只创建一次，立即保存完整 id 和 X-Oneapi-Request-Id。每 15 秒 GET /v1/videos/{id}；queued、in_progress 继续等待，不能仅凭进度数值判断完成。
completed 后读取 metadata.url，立即自动保存 MP4。链接最长约 5 分钟，文件从本站准备好起保留约 10 分钟。完整使用返回地址，不向任意下载域名转发 API Key。
创建超时或结果不明确时，不自动重发 POST。保留请求信息，核对任务/用量记录。GET 临时错误可退避重查；退出后从保存的任务 ID 恢复，不能因停止等待而重新生成。不假设支持取消或幂等创建。
请完成创建、保存任务 ID、查询、自动下载的整条流程，给出适合我工具的具体操作。没有我的确认不要执行付费测试。

## 先选一条适合你的路线 [#先选一条适合你的路线]

| 你现在的情况        | 从这里开始                           |
| ------------- | ------------------------------- |
| 不懂代码，希望 AI 帮忙 | [让 AI 帮我接入](/zh/docs/ai/)       |
| 想知道每一步需要准备什么  | [第一次生成视频](/zh/docs/quickstart/) |
| 已经有应用或工作流     | [WAN3 接口说明](/zh/docs/api/)      |
| 已提交任务，想找回结果   | [任务与下载](/zh/docs/tasks/)        |

## 你会用到什么 [#你会用到什么]

视频控制台：[video.1route.dev](https://video.1route.dev/)。在其中创建“视频”分组的 API Key，再把连接信息填到支持视频任务的工具里。

有图片就先做图生视频；只有文字可以选择 `wan3.0-video-480p`。第一条建议 480p、2 秒，确认费用后提交。

本站提供接入文档，不是在线生成画布。没有支持视频的工具时，可让能够运行代码的 AI 帮你配置调用程序。

## 提交以后 [#提交以后]

保存任务编号，等待任务完成，立即下载 MP4。生成期间进度可能停留不动；完成后文件在本站临时保留约 **10 分钟**，下载链接最长约 **5 分钟**有效。请让接入程序自动保存结果。

## 图片生成在这里 [#图片生成在这里]

[打开图片文档 ↗](https://doc.1route.dev/zh/docs/)。图片与视频使用不同接口和计费规则；本页规则仅适用于视频服务。
