报错与故障排查

支持 Linux、macOS 和 Windows，需要 Node.js 18+ 和现代浏览器。所有 AI 处理都在云端 API 完成，所以本地机器配置再普通也不会拖后腿，高性能显卡完全用不上。

只要一个 Agnes AI 的 API Key。到 Agnes AI 官网（agnes-ai.com）注册就能免费拿到，文本、图片、视频生成和语音合成都用它。所有能力来自 Agnes AI 免费模型，不用额外配置。

支持。稿件长视频模式就是为批量处理设计的：丢一篇长文进来，自动拆成多段，逐段生成视频，再统一加上旁白和字幕。

有断点续传。生成任务要是中断了（断网、重启之类的），重新启动会自动从上一个成功的检查点接着跑，进度不会丢。大多数失败由模型服务波动、网络超时或限流等偶发因素导致，先在失败面板点击「重试任务」即可从失败环节断点续传，多数情况能直接自愈。

大多数失败由模型服务波动、网络超时或限流等偶发因素导致。请在应用内的失败面板先点击「重试任务」，任务会从失败环节断点续传，多数情况下即可自愈，无需重新提交。若多次重试（≥ 2 次）仍失败，失败面板会自动展开反馈区，支持一键复制诊断信息并跳转到预填好的 GitHub Issue，无需手动描述环境。

Agnes 为 Video 2.5 Flash 这类视频模型维护了一条共享的免费推理队列，高峰期可能持续饱和 10 分钟以上。队列满时，每次提交都会被拒绝，返回 HTTP 503 · video_queue_full，原始消息为「video queue is full, please retry later (request id: …)」。此时不会创建任务、不消耗配额，也没有任何内容丢失——这是 Agnes 服务端的容量问题，与你的提示词或配置无关。自 v7.0 起，队列满的拒绝不再占用普通重试额度，而是进入独立的重试轨道（默认最多 15 次，可通过 AGNES_VIDEO_BUSY_RETRY_ATTEMPTS 调整），首次重试立即发起，之后间隔 30–60 秒。自 v7.1 起，失败面板与创建任务的提示还会给出上游历史上更空闲的错峰时段（按你所在时区显示）。想避开 Agnes 503 报错：在错峰时段重试、换用其他视频模型（Video 2.0 使用独立队列，通常仍能正常提交），或添加更多 API Key（每个 key 有独立配额）。另据上游官方说明：Agnes 中国站自 2026-10-26 12:00（北京时间）起实行实名认证，未完成实名认证的账号 API 调用频率会被降低；上游预计该时点之后 503、queue is full 等繁忙报错将有较大改善。

401 Unauthorized 或「无效的令牌」通常意味着 API Key 与请求的域名不匹配——例如在国际站领取的 key 用到了国内站专属域名 api.agnes-ai.cn（或反之），不同站点签发的 key 在域名不对时会被拒绝。自 v6.4.2 起，每个 key 可绑定自己的接入域名，并新增一键「自动探测域名」按钮，逐 key 在 com / cn / cn_bak 中探测并自动填入匹配的域名。在 API Key 面板选择与你的 key 匹配的域名，或直接点击自动探测即可。国际站 key 应使用 apihub.agnes-ai.com，或使用 cn_bak 兜底域名（apihub.agnes-ai.cn，同时兼容国内与国际 key）。

应用内与官网提供双向反馈入口：应用内任务失败时，失败面板会提供「复制诊断信息」与「去 GitHub 提 Issue」按钮，自动拼接版本号、任务类型、失败环节、错误信息与重试次数，帮助维护者快速定位。也可直接访问 GitHub Issues 页面（github.com/lcy362/agnes-video-generator/issues）查看已有报告或提交新 Issue。