视频渠道配置与监控
本页面向管理员。客户调用方式见 视频生成接口。MuskAI 在网关内转换供应商接口与参数，让客户使用统一 JSON 视频接口，并在兼容账号间进行负载分配。
录入供应商
- 在账号管理新增或编辑 OpenAI / API Key 账号，填写供应商 Base URL 与 API Key。
- 将渠道用途设为“视频专用”，选择对应媒体上游协议。
- 配置账号支持的模型与模型映射，并绑定允许客户调用的分组。客户模型名映射到供应商真实模型名；只修改 Base URL 和模型名不能解决协议差异。
- 填写视频能力限制，逐模型手动测试后保存配置。
视频专用账号不参与文本或图片选号，图片专用账号不参与文本或视频选号；通用账号保持原有规则。
| 协议选项 | 适用渠道 |
|---|---|
| OpenAI Videos JSON | 上游使用 /v1/videos 创建的 JSON 接口。 |
| OpenAI Video Generations | 上游使用 /v1/video/generations 创建。 |
| 沧元算力 | 使用沧元的字段转换与任务查询协议。 |
| 加速 API（通用） | 加速 API 通用视频创建与 /v1/videos/tasks/{id} 查询。 |
| 加速 API（MiniMax H3） | 对应 H3 协议和默认规格；请核对供应商当前模型要求。 |
| CompShare MiniMax H3 | /minimax/v2/video_generation 创建及配套查询。 |
| Catcode | /v1/videos/generations 创建及配套查询、下载。 |
| OpenAI 透传（旧渠道） | 保留旧上游格式与缓存绑定；新渠道建议选择显式协议。 |
协议选择决定网关的路径与字段转换，不保证供应商开放所有模型和功能。后续供应商需增加服务端协议适配及契约验证，不能通过任意填写协议名称直接接入。
能力限制与选号
| 配置 | 含义 |
|---|---|
| 支持的分辨率 | 填写可用档位，如 480p, 720p, 1080p；留空不限制。 |
| 最短 / 最长时长 | 秒数范围，包含边界；必须是正整数，最短不能大于最长。 |
| 是否支持真人 | 支持、不支持或不限制。客户端通过 contains_real_person: true 声明真人请求。 |
| 参考图上限 | 普通参考图、首帧、尾帧的合计数量。 |
| 参考视频 / 音频上限 | 各类参考素材的最大数量。 |
素材数量留空表示不限制，0 表示不支持该类素材。能力配置是账号级限制，不取代模型本身的功能要求。真人不通过提示词或图片自动识别；未标记的请求按普通请求处理。
常规选号、粘性会话、降级候选与失败切换都会过滤不兼容账号。已有任务的查询与下载固定原账号和协议，不因编辑能力或协议而重新选择供应商。不要把多供应商负载理解为对未知受理结果重复创建：超时或异常提交可能已被受理，需使用原幂等键核对。
手动测试模型
在账号新增或编辑表单的“模型可用性测试”输入多个模型，逗号或换行分隔。测试按模型串行执行，单个失败后继续其余模型。
- 保存前使用当前 Base URL / API Key，填写供应商真实模型名；已保存账号测试应用已保存的模型映射。
- 测试使用当前表单协议与能力限制。视频自动选择模型与账号共同支持的较低规格，可显式覆盖时长、分辨率、比例；图片默认 1 张低质量。
- 测试会产生上游生成费用。最低规格依赖模型目录和协议信息，不保证未知模型的最低价格。
- 视频排队时继续轮询已有任务，不重复创建；提交结果未知时保留状态并核对，不能换键不断测试。
图片 / 视频渠道监控
在渠道监控中按模型选择文本、图片或视频探测，填写该监控的上游地址、密钥及媒体协议。媒体默认每小时重新生成一次，可设置 300–86400 秒；监控检查周期和媒体重新生成间隔是两项设置，较频繁检查会复用已有结果或继续轮询。
图片检查可解码的图片头和尺寸，视频下载前 64 KiB 并检查 MP4 / WebM 容器签名。成功说明接口返回了可识别媒体，不等同于完整视频播放或内容质量验证。媒体延迟包含生成与排队时间，应据此配置降级阈值。
共享 PostgreSQL 锁防止多节点同时触发同一媒体检测；间隔内缓存不重新生成，排队或受理结果未知的任务不会盲目重建。
成功率口径
管理列表、用户卡片和逐模型详情展示最近 6 次及滚动 24 小时成功率，并显示“成功数 / 检查数”。
operational和degraded算成功，failed和error算失败。- 最近 6 次不足 6 条时使用实际样本数；无样本显示“—”。24 小时是滚动时间窗口。
- 尚未完成的媒体任务和间隔内重复返回的缓存结果不新增样本。
- 统计以监控历史为准，包含管理员补录或修订，不是所有客户请求的成功率。
- 这两项指标使用实际统计，不套用“展示保障值”。
显式协议任务与幂等记录当前保存 7 天，成品文件保留时间由供应商决定。多节点必须共享数据库及一致的任务加密配置；能力、探测和适配功能上线需发布包含这些功能的服务版本，编辑文档不会自动部署主系统。