模型能力与管理员配置
ZaiDrama 现在由统一平台运营。普通用户不需要申请、粘贴或轮换第三方 API Key；平台管理员负责维护供应商凭据、模型路由、能力声明、并发和故障切换。用户在项目或任务中只选择当前开放的模型能力。
1. 普通用户如何选择能力
设置页和生成步骤会显示当前可用的文本、图像、视频和 TTS 能力，以及模型支持的比例、时长、参考图、首尾帧和音频选项。可选项以运行时能力注册表为准，不应根据模型名称或旧截图推断。
选择时关注：
- 是否符合项目的内容模式和生成路线；
- 角色、场景、商品参考图是否被支持；
- 目标比例、时长、分辨率和音频方式；
- 预览质量、队列速度和失败后的可恢复性；
- 账户当前可用额度和项目预算。
首次制作建议用少量镜头验证风格和能力，再扩大范围。生成前出现方案或额度提示时，先确认再启动任务。
2. 能力边界
平台会按具体模型声明以下能力，而不是按供应商整体推断：
- 文本和结构化输出；
- 图像生成、编辑和多参考图；
- 文生视频、图生视频和参考生视频；
- 首帧、尾帧、延展、固定种子和原生音频；
- TTS、音色、语速和输出格式；
- 支持的时长、分辨率、宽高比、并发与任务查询。
视频请求构造和执行期白名单属于对应 backend；注册表中的声明必须与实际执行约束同步。没有登记的能力应明确失败，不会静默替换为用户未选择的模型。
3. 平台管理员配置
管理员在受保护的后台维护：
- 供应商凭据和密钥轮换；
- 模型 ID、调用端点和发现协议；
- 图片、视频、文本和 TTS 能力标记；
- 时长、分辨率、比例、参考图和并发上限；
- 默认模型、故障切换和区域策略；
- 额度映射、调用审计和错误分类。
保存配置后，必须用小任务验证连接、结构化输出、图片、视频创建/查询、TTS 和错误码。连接测试成功不代表真实媒体生成一定可用。
4. 自定义供应商
统一平台不向普通用户开放自定义端点。平台需要接入新的供应商或内部网关时，由管理员完成安全评估、协议适配和能力登记，确认：
- Base URL 是 API 根地址而非控制台地址；
- 模型列表、真实调用和异步查询端点一致；
- 认证、区域、内容政策和数据处理要求已确认；
- 失败、超时、取消和重试不会造成重复扣费；
- 能力标记与 backend 的执行期限制一致。
不要把供应商密钥、内部地址或未脱敏响应写入前端、文档、Issue 或聊天记录。
5. 费用与额度
用户以账户中心的订阅、额度和使用记录为准。平台会记录任务的能力、状态和调用审计；供应商结算、平台额度扣除和失败回滚由运营方维护。
遇到额度不足或费用异常时，保留项目/任务标识并联系平台支持，不要重复点击生成或尝试绕过额度检查。
6. 故障排查
用户侧
先检查任务错误、项目实际选择的模型、输入参考图和账户额度：
- 模型不在列表中：它可能暂时下线或不符合当前项目路线；
- 生成失败：查看失败原因和重试建议，必要时只重跑受影响的镜头；
- 排队过久：任务由平台统一调度，请勿重复提交；
- 额度不足：到账户中心查看额度、订阅和活动状态。
管理员侧
- 401/403：核对密钥、区域、模型权限和服务间认证；
- 429：核对供应商限流、worker 并发和平台队列；
- 超时：检查 DNS、TLS、代理、任务查询和结果下载；
- 连接测试成功但生成失败：执行一次真实的小任务，核对媒体能力和调用端点；
- 能力校验失败：同步模型声明、backend 白名单、请求构造和管理界面。
上游读超时可能意味着任务已经创建。先用任务标识和供应商控制台核对状态，再决定是否恢复或重试，避免重复扣费。
7. 维护原则
- 具体模型列表以平台设置页为准，不在用户文档中维护静态矩阵；
- 能力、参数约束或计费映射变更时，同步更新注册表、backend、管理界面、测试和文档；
- 公共文档只说明用户可见的能力和排障路径，内部凭据、主机和供应商契约放在受限运行手册中。