常见问题
本文汇总统一平台中最常见的账号、制作、任务与排障问题。第一次使用时，建议先阅读完整入门教程。具体模型能力以设置页当前显示为准。
使用 ZaiDrama 前需要了解哪些能力边界？
- 媒体生成由平台统一调度上游模型服务，生成速度、可用性和内容策略会随当前能力状态变化。
- 长篇内容仍需要人工审核分集、角色资产和关键剧情节点，ZaiDrama 的目标是增强创作者，而不是完全取消审核。
- 不同视频模型对参考图数量、视频时长、首尾帧、音频和地区可用性的支持不同。
- 普通用户无需安装服务器、维护数据库或配置第三方 API Key；统一平台负责 HTTPS、存储、备份和运行资源。
- 平台管理员按内部运行手册处理服务、队列、数据库、凭据和安全边界。
注册、登录与平台服务
普通用户怎样开始？
注册或登录统一平台账号即可开始。注册需要邮箱验证码和符合要求的密码；账户中心负责密码重置、资料和会话管理。进入首页后打开 Zai 对话，提交想法、长文本、源文件、图片附件或商品目标。
平台会统一提供当前可用的模型能力、任务资源、HTTPS、存储和备份。普通用户不需要安装服务端组件、维护数据库或申请第三方 API Key。
平台页面打不开或请求失败怎么办？
先确认账号会话、平台状态和网络连接，再查看页面显示的 request/task 标识。若只有单个项目或任务失败，优先查看任务错误；持续失败时联系平台支持。不要尝试修改服务器、上传环境文件或在聊天中粘贴密钥。
默认登录账号是什么？忘记密码怎么办？
使用注册时的邮箱登录。忘记密码时在登录页申请验证码并重置密码；无法收到邮件或怀疑会话异常时联系平台支持。不要要求运营人员通过聊天发送密码或验证码。
平台怎样更新？会丢失项目吗？
版本发布、数据库迁移、备份和回滚由平台运营方执行。发布前会验证项目、任务、版本和导出；用户无需操作服务器。若更新后发现异常，请提供项目和任务标识，不要重复提交整集任务。
项目和配置存在哪里？怎样备份或迁移？
平台运营方负责数据库、项目元数据、媒体、任务审计和必要配置的备份与灾备。用户可导出项目 ZIP 进行单项目迁移或后期处理，但它不包含账户、订阅、额度、全局模型配置或平台级任务审计。
首次配置与智能体
开始制作前需要配置哪些凭据？
普通用户只需统一平台账号。Zai 对话、文本/图像/视频/TTS 能力、额度和任务资源由平台配置；供应商凭据、模型路由和并发属于管理员范围。
怎样让 AI 助手开始或继续制作？
在首页或项目内打开 Zai，直接说明创作目标、“开始制作”或“继续制作”即可。助手会检查项目当前状态，从尚未完成的阶段继续，并在需要审核剧本、资产或分镜时等待确认。
如果助手提示未登录、无法启动或没有可用模型，先确认统一平台会话和账户额度，再查看页面提供的 request 标识。无需在助手面板另行登录第三方网页账号。
出现旧版 Agent 启动错误怎么办？
Failed to start Claude Code、启动超时或 Control request timeout 等旧版 Agent 进程错误不是普通用户需要修复的部署步骤。记录页面上的 request/task 标识和发生时间，联系平台支持；运营人员按内部服务和 Zai bridge 运行手册排查。
供应商、模型与 API
ZaiDrama 支持哪些供应商和模型？
支持范围以设置页当前的模型列表和能力标记为准。一个供应商被平台接入，不代表它的所有模型和输入形式都可用；图片、视频、文本、语音以及参考图、尾帧、时长和分辨率能力都按具体模型判断。
不要仅根据模型名称猜测能力。新增或调整模型后，由平台管理员确认媒体类型、调用端点和账号权限。
Base URL 应该怎样填写？
普通用户不需要填写 Base URL。管理员接入新端点时，应按受限运行手册和供应商官方契约配置，不要把控制台地址或内部 URL 写入项目内容。
怎样接入自定义供应商？
统一平台不向普通用户开放自定义供应商。若平台新增端点，由管理员完成安全评估、能力登记、真实小任务验证和错误/取消/重试验证。
获取模型列表失败，或者出现 model_not_found 怎么办？
模型列表由平台运行时能力注册表维护。若所需模型暂时不可见，记录项目、任务和时间联系平台支持；管理员再核对模型声明、权限和执行端点。
为什么连接测试成功，实际生成仍然失败？
连接测试只覆盖基础连通性，不代表真实媒体生成一定可用。先确认项目实际使用的模型、输入参考图和任务错误；仍失败时联系平台支持。
遇到 401/403、429 或网络超时怎么办？
- 401/403：记录任务标识联系平台支持，由运营人员核对服务凭据和模型权限。
- 429：平台会统一处理队列和并发；等待任务恢复或联系支持，不要重复提交。
- 网络或超时：记录发生时间和 request/task 标识，由运营人员检查平台网络与上游状态。
提交生成请求后发生读超时，可能出现上游任务已经创建的情况。不要连续盲目重试，先提供任务标识让平台核对状态。
项目流程与任务
项目模式以及分镜、宫格和参考生视频路线怎样选择？创建后能改吗？
创建时需要分别确定两个维度：
- 内容模式：说书、剧集动画或广告/短片，决定剧本结构和制作流程；
- 视频生成路线：分镜路线或参考生视频路线，决定视频使用分镜图还是资产参考图。
内容模式可以在项目设置中调整创作方向；视频生成路线创建后不可更改。宫格不是第三条路线，而是分镜路线中的出图方式；广告/短片项目不支持宫格。创建前请先用短样本确认路线是否符合预期。
- 分镜路线：剧本 → 角色/场景/道具设计图 → 分镜图 → 视频；
- 宫格：仍属于分镜路线，先生成宫格并切分成各镜头的起始分镜；
- 参考生视频路线：跳过分镜图，直接使用剧本引用的资产设计图作为视频参考。
源文件支持哪些格式？
当前支持 .txt、.md、.docx、.epub 和 .pdf。首页和项目对话还支持长文本与图片附件；来源会先持久化，再由用户选择提取、摘要、规范化或仅作参考。扫描版 PDF 没有可提取文本时应先进行 OCR，旧式 .doc 文件请先转换为 .docx。
为什么下一阶段不能进入，或助手没有继续执行？
通常是前置审核或资产尚未完成：检查脚本预处理、角色/场景/道具设计图、目标分镜图、项目引用和仍在运行的任务。不要仅根据顶部阶段编号判断完成状态；时间线、来源页和任务错误会提供更具体的缺失项。
任务排队、运行、失败、取消或服务异常后应该怎么办？
图片、视频和语音使用独立任务通道。排队或运行中的任务可以取消；取消后恢复只重建取消或缺失的子任务，并复用已完成结果。服务异常或网络中断后，平台会尝试恢复仍有上游任务标识的工作；无法恢复的任务会标记失败。
失败任务先查看原因和恢复动作，再只重跑受影响的资产、镜头或阶段。局部重跑会产生新版本，审核无误后再激活；不要为了修复一个镜头重新提交整集。
画面、视频与声音
怎样提高角色一致性？
先审核角色身份特征和正面/侧面/背面/头肩组图，再生成分镜和视频。全局资产库支持搜索、分页和复用；角色视图可单独或整组重生成，设定历史可恢复。资产定义变化不会静默覆盖已有媒体，受影响的结果需要明确重跑。
怎样让相邻镜头更连贯？
锁定资产和分镜后再生成视频，保持地点、时间、服装和出场角色描述一致。分镜路线会把相邻分镜作为衔接参考；重要转场可使用支持尾帧的模型或后期工具。
首帧和尾帧怎样使用？
分镜路线中的分镜图就是视频首帧。尾帧只有在当前模型明确支持时才能生成；更换分镜或尾帧后，已有视频不会自动更新。
为什么场景设计图里出现了人物？
场景设计图会要求不出现人物，但图片模型可能不完全遵循约束。可以重新生成场景图或使用图片编辑移除人物；场景设计图与剧情分镜图的用途不同。
ZaiDrama 支持配音吗？
独立旁白 TTS 目前对说书模式开放，可逐段试听或生成全集旁白，并随项目导出。成片播放器可以在可用时切换原生音频与项目 TTS，并查看字幕。
费用、数据与导出
在哪里查看费用和 Token？怎样控制成本？
平台账户中心显示订阅、额度和使用记录；项目与任务会记录调用明细。生成前先用少量镜头验证模型和提示词，审核通过后再批量生成，避免返工。
项目 ZIP 与全站备份有什么区别？
项目 ZIP 用于导出、单项目迁移和后期处理，可选择当前版本或版本历史。它不包含账户、订阅、额度、全局模型配置、其他项目或平台任务审计，不能代替平台级备份。
项目导出包为什么缺少片段？
项目导出包只包含已成功生成并记录的资源；缺失片段应先回到 ZaiDrama 查看任务错误并只补生成缺失部分，再重新下载。
有手机 App 吗？支持哪些平台？
ZaiDrama 是统一平台 Web 应用，目前没有独立的 iOS 或 Android 原生 App。手机可以通过浏览器访问，但复杂时间线编辑和批量生产更适合桌面端。
可以商用或二次开发吗？
ZaiDrama 按 AGPL-3.0 发布，并附带 NOTICE 中的署名和修改声明要求。ZaiDrama 名称与 Logo 不在 AGPL-3.0 授权范围内。
效果与成本最佳实践
- 用少量镜头测试目标模型的画风、参考图、时长和审核限制。
- 先确定角色、场景和道具设计图，再批量生成分镜。
- 让相邻镜头保持地点、时间、服装和角色描述一致。
- 只引用当前镜头真正需要的资产，避免参考图过多稀释约束。
- 重要转场使用支持尾帧的模型，或交给后期编辑。
- 以账户中心额度和任务调用明细规划生产范围。