# 常见问题

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



## 我的聊天软件能用吗 [#我的聊天软件能用吗]

要看软件是否支持异步视频接口。仅支持聊天补全的软件，填入 WAN3 模型名通常不够；请让 AI 核对适配方式，或使用 [示例客户端](/zh/docs/api/)。

## API 地址应该填哪个 [#api-地址应该填哪个]

视频服务为 `https://video.1route.dev`。创建路径是 `/v1/videos`。软件若自动拼接路径，按它要求填写，避免出现 `/v1/v1/videos`。

## 找不到模型或提示没有可用渠道 [#找不到模型或提示没有可用渠道]

检查 Key 是否来自视频控制台、是否选择“视频”分组、是否启用了模型限制；再查当前模型列表。模型列表包含该名称不保证当时一定有可用生成容量。

## read image failed / context deadline exceeded 是谁的问题 [#read-image-failed--context-deadline-exceeded-是谁的问题]

这类错误说明处理链路读取素材超时。图片源慢、签名失效、防盗链和模型服务网络波动都可能造成。先检查 [素材直链](/zh/docs/materials/)，并保留请求编号供排查，不能单凭这段报错归责给客户端或本站。

## 为什么进度一直不动 [#为什么进度一直不动]

可能在排队或进度更新不频繁。只要没有终态，就继续查询同一编号；不要重复点击生成。没有承诺固定完成时间。

## 超时了，可以直接再提交吗 [#超时了可以直接再提交吗]

不要自动重发创建请求。先核实是否已有任务和扣费。GET 状态查询可在网络错误或临时 5xx 后退避重试；401、403、参数错误应先修正原因。

## 失败会扣费吗 [#失败会扣费吗]

创建时可能预扣。任务明确失败后需查看本站用量与退款记录；网络超时本身不是失败终态。成功生成但用户没及时下载，也不能据此认定应退款。

## 为什么 30 秒视频不能带 5 秒参考视频 [#为什么-30-秒视频不能带-5-秒参考视频]

两者合计达到 35 秒，超过当前 30 秒上限。可以将成片改为 25 秒，或者不传参考视频；不能通过少填参考时长规避。

## 出现 400、401、429 怎么办 [#出现-400401429-怎么办]

| 情况                      | 处理                                 |
| ----------------------- | ---------------------------------- |
| `400` 参数错误              | 检查 JSON、字符串 seconds、范围和素材字段；不要原样重试 |
| `401 / 403`             | 检查 Key、账户和权限；下载签名过期应查询原任务          |
| `429`                   | 降低频率，按 Retry-After 等待              |
| `500 / 502 / 503 / 504` | 保留错误和请求 ID；查询可重试，创建先核对是否已受理        |
| `410 / expired`         | 视频缓存过期，检查本地副本                      |

## 联系客服时发什么 [#联系客服时发什么]

通过站点顶部的社群入口，发送模型、提交时间及其时区、`task_...`、`X-Oneapi-Request-Id`、脱敏后的完整错误、是否重复提交。不要发送完整 API Key。若需检查私人素材，先确认合适的私密传递方式。