Skip to content
视频抽卡审核与显式采纳

视频抽卡审核与显式采纳

本文属于“当前架构”,描述 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 修正建议不保证一次修复成功,仍需人工预览和重抽确认。