P7 真实供应商验证计划(待批准)
状态:计划,未执行。本文件不代表真实视频已经生成或质量已经通过。
1. 供应商与模型
| 项 | 当前值 |
|---|---|
| 供应商 | 优云智算 compshare_model_api |
| 视频模型 | MiniMax-H3 |
| 提交协议 | POST /minimax/v2/video_generation(现有适配器) |
| 业务时长 | 项目内部 4–15 秒;优云智算 H3 API 4–30 秒 |
| 图片参考 | 最多 9 张 |
| 音频参考 | 最多 3 个,不能单独使用 |
| 提示词 | 最多 7000 字符 |
模型 ID 大小写必须保持 MiniMax-H3;不要与 PIX 的 minimax-h3 混淆。
2. 前置条件
- 在验收环境显式启用
generation_test_quota_enabled=true,scope=v2-acceptance - 确认真实持久化额度记录仍为 image 20 / video 4 / audio 500
- 准备真实可读取的角色/场景参考图,不使用占位文件
- 若开启音频参考,为每个说话人上传固定音色样本
- 通过 P6 参考编号与 provider body 合约测试
- 用户批准本计划及预计最大成本
- 真实调用前确认 API Key 不进入任务 payload、日志或前端
3. 计划镜头
| # | 用途 | 镜头特征 | 参考图 | 音频 | 次数 |
|---|---|---|---|---|---|
| 1 | 单人角色 | 单人近景,锁定身份 | 2–3 | 关闭 | 1 |
| 2 | 双人互动 | 两名角色 + 场景 | 4–5 | 关闭 | 1 |
| 3 | 场景/道具 | 无对白或少量对白 | 2–4 | 关闭 | 1 |
| 4 | 修改提示词重抽 | 复用镜头 1 或 2,验证 prompt 变化 | 同前 | 关闭 | 1 |
累计真实视频调用最多 4 次;不自动生成图片或音频。失败/超时按保守规则计入额度,不盲目重试。
4. 失败处理
- 提交超时:先查询供应商任务,不重复提交。
- 适配器参数不符:停止真实调用,记录差异并修复合约测试。
- 任务失败:保留额度记录;是否重试需重新批准。
- 返回成功:只代表 L3 API 成功,仍需 L4 人工质量验收。
5. 验收分层
- L1:单元/服务测试(已通过)
- L2:P1–P7 Mock 全链路(已通过)
- L3:真实供应商 API(未执行)
- L4:人工视频质量(未执行)
6. P9-A 复核状态(2026-10-23)
| 项 | 状态 | 依据 |
|---|---|---|
模型 ID MiniMax-H3 | 仓库配置已核对 | docs/供应商配置.md、项目模型记录 |
提交路径 /minimax/v2/video_generation | 适配器代码已核对 | backend/app/core/integrations/compshare/video.py |
| 参考图 ≤9 | 官方 docs + 适配器声明已核对 | MiniMax API Docs / video_capabilities.py |
| 参考音频 ≤3、不能单独使用 | 官方 docs + 适配器声明已核对 | MiniMax API Docs / video_capabilities.py |
| 提示词 ≤7000 字符 | 适配器能力声明/测试已核对 | video_capabilities.py、合约测试 |
| 4–30 秒供应商能力 | 优云智算 API 文档已核对;适配器已对齐 | compshare API Docs |
| 项目业务 4–15 秒 | 项目常量已核对 | shot_video_readiness / 项目配置 |
| 异步提交/轮询/下载实际行为 | 官方协议已核对;compshare 实际网关未验证 | MiniMax API Docs;未发真实请求 |
| 供应商当前定价 | 未核实 | 未查询账户/官方最新价 |
| 参考音频实际格式接受度 | 未验证 | 未发真实请求 |
拟执行镜头
| # | 镜头 | 参考图 | 音频 | 次数 |
|---|---|---|---|---|
| 1 | 林晚单人近景 | 2–3 | 关闭 | 1 |
| 2 | 林晚 + 周沉双人 | 4–5 | 关闭 | 1 |
| 3 | 值班室/钥匙道具 | 2–4 | 关闭 | 1 |
| 4 | 修改 prompt 后重抽 | 同 #1/#2 | 关闭 | 1 |
- 累计真实视频调用上限:4
- 当前额度:video 4 / image 20 / audio 500(未消耗)
- 预计费用:未核实;执行前需按供应商当前价目重新估算并由用户批准
- 失败/超时:先查询供应商任务,不盲目重试;保守计入额度