视频抽卡审核与显式采纳
本文属于“当前架构”,描述 P6 / C14 已落地的视频候选审核。
1. 候选与采纳分离
- 每次视频任务生成一个版本/候选;
- 候选完成不会自动替换已采纳视频(P6 新任务
auto_adopt=false); shots.generated_video_file_id仍表示当前采纳视频;- 旧版本文件与任务保留,可随时切回。
2. 候选列表
GET /api/v1/studio/shots/{id}/video-versions 返回每个候选:
- task_id / file_id / file_url
- status / error
- is_current
- model_name
- ratio / seconds / prompt
- reference_count / manifest
- review_status
- issue_tags / note
- created_at
3. 审核
shot_video_reviews:
- task_id 唯一
- shot_id / file_id
- review_status:unrated / satisfied / unsatisfied
- issue_tags JSON
- note
- reviewed_by / reviewed_at
问题标签(P9-C 扩展,仍保存到既有 shot_video_reviews.issue_tags,不新建质量库):
- 角色声音不匹配
- 说话人归属错误
- 对白与口型不同步
- 人脸不一致
- 人物脸部漂移
- 服装不一致
- 道具不一致
- 旁白/描述被朗读
- 场景/背景不连续
- 场景布局错误
- 场景错误
- 动作不准确
- 动作错误
- 镜头切换异常
- 运镜错误
- 画面闪烁
- 肢体异常
- 肢体畸形
- 其他
标签只描述人工观察结果,不自动判定视频合格;审核完成也不会自动采纳视频。
接口:
| 方法 | 路径 | 说明 |
|---|---|---|
POST | /api/v1/studio/shots/{sid}/video-versions/{tid}/review | 保存满意/不满意、标签、备注 |
POST | /api/v1/studio/shots/{sid}/video-versions/{tid}/adopt | 按任务显式采纳 |
POST | /api/v1/studio/shots/{sid}/video-versions/adopt | 兼容旧 file_id 采纳 |
GET | /api/v1/studio/projects/{pid}/video-reviews | 项目级审核台:跨剧集/镜头聚合视频版本 |
POST | /api/v1/studio/shots/{sid}/video-versions/{tid}/prompt-suggestion | 按问题标签生成提示词修正建议(只读) |
4. 历史保护
- 新候选完成不会覆盖当前采纳;
- 任务完成顺序不同也不会改变用户采纳决定;
- 采纳只移动
shots.generated_video_file_id,不删除旧文件; - 可重新采纳旧版本;
- 审核标签与备注不修改视频文件。
5. 前端
ShotPanel 内嵌 VideoReviewPanel:
- 播放候选;
- 并排卡片对比;
- 问题标签与备注;
- 满意/不满意;
- 显式采纳;
- 当前采纳标识;
- 参考图快照摘要。
6. 项目级审核台
项目级审核台聚合项目下所有视频版本,避免用户逐镜头翻找:
- 卡片展示剧集/镜头序号、镜头标题、版本状态、模型、时长、画幅、参考图数量;
- 支持按剧集、满意/不满意、问题标签筛选;
- 审核结果仍写回
shot_video_reviews,不新建第二套审核表; - 采纳只移动
shots.generated_video_file_id,历史版本保留。
接口:GET /api/v1/studio/projects/{pid}/video-reviews。
7. AI 提示词修正建议
审核台可选择问题标签和备注,调用:
POST /api/v1/studio/shots/{sid}/video-versions/{tid}/prompt-suggestion
约束:
- 输入为当前视频版本的实际提示词、镜头信息、问题标签和备注;
- 输出
suggested_prompt、explanation、changes; - 只生成建议,不写库、不自动应用、不自动重抽、不扣费;
- 用户确认后写入镜头的
advanced_video_prompt,再由用户手动预览/生成。
shot_details.advanced_video_prompt 是持久化的最终 H3 提示词;非空时优先于自动渲染。
审核台应用建议时只更新该字段,不覆盖用户已保存的自然语言提示词。
8. 道具一致性提示
生成准备度会检查:
- 镜头道具是否选择了资产版本;
- 同一道具在项目内其他镜头是否使用了不同版本;
- 道具参考图版本是否与
ShotAssetVersion(prop)一致; - 道具已选版本但没有道具参考图。
这些检查只返回 warning,不自动改写镜头或参考图。
9. 当前边界
- 不做自动质量评分;
- 不在 P6 自动删除不满意候选;
- 修改提示词重抽仍通过上方 P6 生成入口;原样重跑使用当前 manifest/prompt 重新创建任务;
- 固定音色样本与预览 hash 校验属于 P6 正式生成路径,旧任务继续兼容;
- 项目级审核台只展示已有视频,不创建任务;
- AI 修正建议不保证一次修复成功,仍需人工预览和重抽确认。