视频批量生成与并发协调
本文属于“当前架构”,描述 P6 / C13 已落地的批量视频任务。
1. 数据模型
video_generation_batches:
- 项目/剧集/场次
- 状态 queued/running/succeeded/failed/cancelled/partial_success
- 每镜候选数、并发数
- 总/排队/运行/成功/失败/取消计数
- 分镜覆盖快照
- coordinator task id
video_generation_batch_items:
- batch、shot、candidate_index
- child
GenerationTask - 子状态、enqueue/completed 时间、错误
迁移:045-add-video-batches.sql。
2. 创建
- 校验镜头全部属于当前剧集/场次;
- 读取 P5 分镜覆盖率;低于 60% 默认拒绝,可显式
allow_low_coverage=true; - 并发取项目
video_concurrency,并夹在 1–8;实际执行受dyeingtime-celery-video --concurrency=4限制; - HTTP 请求只创建 batch 骨架与 queued items,立即返回;不在请求内生成提示词或 staging 子任务;
- 预览/提示词/子任务由
video_batchcoordinator 在后台逐镜准备; - 准备前若镜头没有启用中的参考绑定,后端会自动推荐一次项目素材,不依赖用户先点开镜头参考面板;
- 单个镜头准备失败只把该 item 标记 failed,不影响同批其它镜头;错误显示在批次行内;
- 创建
video_batchcoordinator 任务并立即入队。
3. 并发协调
run_video_batch_task:
- 读取 batch,标记 running;
- 对没有 task_id 的 queued items 逐镜构建 generation preview/snapshot 并 staging 子任务;
- 单镜准备失败标记 failed,继续准备其它镜头;
- 只启动 queued 子任务,直到 running 数达到并发;
- 已 enqueue 的子任务不重复 enqueue;
- 周期刷新子任务 GenerationTask 状态;
- 全部终态后汇总:
- 全成功 → succeeded;
- 部分成功 → partial_success;
- 全失败 → failed;
- 取消 → cancelled。
- 子任务结果不写回
shot.status;视频候选由 C14 审核采纳。
4. 取消与重试
- 取消 batch:queued 子任务直接 cancelled;running 子任务请求取消,但不宣称供应商远端已停止计费;
- 失败重试:准备阶段失败(无 task_id)的 item 回到 queued,由 coordinator 重新准备;已有失败子任务的 item 创建新的
GenerationTask,复用原任务输入;不重复使用已失败 task; - resume:重新唤起已存在的 coordinator task,适用于 API/Worker 重启后的恢复;
- 子任务 task id 持久化,页面刷新可恢复进度。
5. 覆盖与保护
- 批次显示 P5 覆盖率、阻塞/警告;
- 低覆盖不等于全部镜头不能生成,但必须显式确认;
- 批量结果默认不自动采纳(C11
auto_adopt=false); - 不删除已有视频与历史任务。
- 前端批量面板提供「全选 / 全选 ready / 全不选」;首次进入默认选中 ready, 用户手动改过选择后,轮询刷新不会重置选择;提交前会提示未 ready 镜头。
6. API
| 方法 | 路径 | 说明 |
|---|---|---|
POST | /api/v1/studio/chapters/{id}/video-batches | 创建批次 |
GET | /api/v1/studio/chapters/{id}/video-batches | 批次列表 |
GET | /api/v1/studio/video-batches/{id} | 批次详情 |
POST | .../video-batches/{id}/cancel | 取消 |
POST | .../video-batches/{id}/retry | 重试失败 |
POST | .../video-batches/{id}/resume | 恢复协调器 |
7. 当前边界
- 真实供应商并发能力未做在线探测,当前只使用项目配置与 1–8 安全上限;
- 取消请求不保证供应商停止计费;
- 不做原型级视频队列;沿用现有 Celery/GenerationTask 底层。