常见问题
模型不可用、图片读取超时、排队、扣费和下载问题。
我的聊天软件能用吗
要看软件是否支持异步视频接口。仅支持聊天补全的软件，填入 WAN3 模型名通常不够；请让 AI 核对适配方式，或使用 示例客户端。
API 地址应该填哪个
视频服务为 https://video.1route.dev。创建路径是 /v1/videos。软件若自动拼接路径，按它要求填写，避免出现 /v1/v1/videos。
找不到模型或提示没有可用渠道
检查 Key 是否来自视频控制台、是否选择“视频”分组、是否启用了模型限制；再查当前模型列表。模型列表包含该名称不保证当时一定有可用生成容量。
read image failed / context deadline exceeded 是谁的问题
这类错误说明处理链路读取素材超时。图片源慢、签名失效、防盗链和模型服务网络波动都可能造成。先检查 素材直链，并保留请求编号供排查，不能单凭这段报错归责给客户端或本站。
为什么进度一直不动
可能在排队或进度更新不频繁。只要没有终态，就继续查询同一编号；不要重复点击生成。没有承诺固定完成时间。
超时了，可以直接再提交吗
不要自动重发创建请求。先核实是否已有任务和扣费。GET 状态查询可在网络错误或临时 5xx 后退避重试；401、403、参数错误应先修正原因。
失败会扣费吗
创建时可能预扣。任务明确失败后需查看本站用量与退款记录；网络超时本身不是失败终态。成功生成但用户没及时下载，也不能据此认定应退款。
为什么 30 秒视频不能带 5 秒参考视频
两者合计达到 35 秒，超过当前 30 秒上限。可以将成片改为 25 秒，或者不传参考视频；不能通过少填参考时长规避。
出现 400、401、429 怎么办
| 情况 | 处理 |
|---|---|
400 参数错误 | 检查 JSON、字符串 seconds、范围和素材字段；不要原样重试 |
401 / 403 | 检查 Key、账户和权限；下载签名过期应查询原任务 |
429 | 降低频率，按 Retry-After 等待 |
500 / 502 / 503 / 504 | 保留错误和请求 ID；查询可重试，创建先核对是否已受理 |
410 / expired | 视频缓存过期，检查本地副本 |
联系客服时发什么
通过站点顶部的社群入口，发送模型、提交时间及其时区、task_...、X-Oneapi-Request-Id、脱敏后的完整错误、是否重复提交。不要发送完整 API Key。若需检查私人素材，先确认合适的私密传递方式。