故障排查
先定位出错环节：模型连接、CLI 认证、媒体素材、渲染、保存或账户。保留已有项目再处理失败部分。
开始前
| 你看到的问题 | 先检查什么 | 下一步 |
|---|---|---|
| 401 / 鉴权失败 | Key 是否正确、过期或来自错误平台 | 在对应开发者平台确认有效 Key，更新后重新测试 |
| 403 / 访问被拒绝 | 账户、地区、组织或模型权限 | 按服务商控制台处理权限；不能只靠换模型名称绕过 |
| 找不到模型 / 404 | Base URL 前缀与准确模型 ID | 核对是否把完整请求路径追加到了根地址；从账户列表选择或填写官方 ID |
| 限流 / 429 | 请求频率、并发、额度与窗口 | 以实际错误说明区分限流和额度耗尽，等待或调整使用方式 |
| 超时 / 无法连接 | 网络、代理、接口地址与服务状态 | 先确认地址可达，再用最小请求重试；不要同时改所有字段 |
| Internal IPs blocked | 是否使用公司内网或本地网关 | 交由部署管理员按仓库内网服务指引配置允许主机；不应随意全局放开 |
| 设置显示保存失败 | 本地后台服务是否运行 | 恢复后台服务，重新填写并确认保存；测试成功不等于持久化成功 |
| 模型列表为空 | 服务是否支持自动发现、Key 权限 | 查服务文档；按实际模型 ID 手动填写，Azure 用部署名 |
| 本机代理需要认证 | 代理自身登录状态 | 回到对应代理完成认证，再在 OpenDesign 测试 |
| 图片/配音失败但聊天正常 | 媒体提供商配置与额度 | 检查“媒体生成提供商”，而非只重填聊天模型 Key |
| 已付款但任务仍停止 | 账户、工作区、额度刷新与任务状态 | 确认权益生效后回原项目重试，保留错误与订单信息 |
测试结果只能证明该次连接，不能保证目标模型支持所有图片输入、工具调用和媒体生成。正式做视频前，用同一配置完成一次简短任务更容易定位问题。
只有方案，没有生成视频
如果之前只要求脚本、分镜或方案，可以继续说明：“按这个方案开始制作，并生成 MP4 和可编辑源文件。”
有动画预览，但没有 MP4
先确认任务是否还在渲染。如果已经结束却没有视频，继续要求完成视频渲染，并检查任务中的错误提示。HTML 预览不能代替 MP4 交付。
修改后，下载的视频还是旧内容
要求 AI 根据最新源稿重新渲染，再打开新生成的 MP4 检查。只修改源稿不会自动改变已经生成的视频文件。
为什么预览没有声音？
先点击画面，检查是否受到自动播放限制。如果仍没有声音，确认作品是否被设为无声，以及实际音频素材是否可用。
导出失败后怎么办？
保留已有源文件，查看任务中的错误信息，让 AI 修复后重新渲染。不要把失败或仍在排队的渲染当作已完成视频。
可以不用视频生成模型吗？
代码动效使用本地 HTML-to-MP4 渲染流程，不需要视频生成模型的 API Key。负责创作的 AI 服务，以及额外使用的图片、音频或视频生成服务，仍可能需要相应额度或配置。
membership concurrency limit exceeded 是什么？
这是套餐允许同时运行的 Agent 数已到上限，不等于 Key 无效或模型余额必然用完。当前个人套餐并发上限为 Go 10、Plus 20、Pro/Max 30；以 套餐页 当前权益为准。先停止或等待部分任务，再重试；同时检查是否有外部 API Agent 占用同一账户的并发。
一直 Working，或大 HTML 总在同处停住
网站复刻会连续执行多次模型与工具调用，Working 时间长不一定已经卡死。先查看消息、工具或文件是否还在更新；长时间没有进展时可停止并重试。大 HTML 总在同处停止时，换模型或把页面拆成几个部分分段完成。不要直接丢弃已经生成的源文件。
怎样导出诊断信息？
在问题发生后尽快打开 Settings → About，导出日志或诊断信息。附上客户端版本、Agent/模型、错误原文、复现步骤、发生时间和时区。额度异常再附套餐、工作区和 Usage 截图。通过私信或支持邮件提供；不要在公开频道发布账号信息、Key 或未经检查的日志。