批量生成分镜视频 WebSocket 接口文档

概述

通过 WebSocket 批量生成章节下所有未生成过视频的分镜视频。

生成方式统一为单帧（genWay=0）

提示词使用分镜的 videoPrompt（视频提示词）

参考图使用分镜选中的图片素材（ischecked=1），无选中时取最新一张；无图片素材时不传参考图，仅文生视频

多线程并发生成，最大并发数服务端配置 video.batch.max-concurrent（默认 3）

实时推送整体进度，全部完成后推送汇总结果

1. 消息定义

后端类

com.star.b2v.api.message.BatchGenerateVideoMessage（b2v-api 模块，自动注册路由）

请求字段

字段	类型	必填	说明
episodeId	Integer	是	章节ID
duration	Integer	否	视频时长（秒）
resolution	String	是	分辨率，如 `720p`、`1080p`
aspectRatio	String	是	画面比例，如 `16:9`、`9:16`
hasAudio	Byte	是	是否含音频：0-否，1-是
videoModelId	Byte	否	视频模型ID

可选参数不传时使用服务端默认值（720p / 9:16 / doubao-seedance-2-0-260128）。

发送示例

{
  "messageType": "BatchGenerateVideoMessage",
  "taskId": "1001_clientA",
  "episodeId": 12,
  "duration": 5,
  "resolution": "720p",
  "aspectRatio": "9:16"
}

2. 处理逻辑

校验 episodeId，查询该章节下全部分镜（按 sequence 排序）

查询 aisp_generate_video 中已存在**成功记录（status=2）**的分镜，过滤出未生成过视频的分镜

查询待生成分镜的图片素材（image 类型），优先取 ischecked=1，否则取最新一张

固定线程池并发提交生视频任务（video.batch.max-concurrent），每个任务到达终态后释放并发槽位

单个分镜生成：

genWay=0（单帧），参考图 = 选中图片的 COS 签名 URL（无图片素材时仅用提示词生成）

提示词 = 分镜 videoPrompt

无视频提示词的分镜计为失败并跳过

全部结束后发布任务成功事件并推送汇总

3. 服务端推送消息

3.1 批量整体进度（msgType: `BatchGenerateVideoMessage`）

每有一个分镜到达终态（成功/失败/跳过）时推送：

{
  "msgType": "BatchGenerateVideoMessage",
  "taskId": "1001_clientA",
  "data": {
    "total": 10,
    "success": 3,
    "failed": 1,
    "processing": 6,
    "progress": 40,
    "storyboardId": 5,
    "message": "视频生成失败"
  }
}

字段	说明
total	本次待生成分镜总数
success	已成功数
failed	已失败数（含无提示词跳过）
processing	进行中数量
progress	整体进度百分比（(success+failed)/total*100）
storyboardId	刚到达终态的分镜ID
message	失败原因（仅失败时返回）

3.2 单视频生成进度（msgType: `CreateReferenceVideoMessage`）

子任务内部轮询仍会推送单条视频的排队/生成进度（progress 10/50/100），前端如不需要可按 msgType 忽略：

{
  "msgType": "CreateReferenceVideoMessage",
  "taskId": "1001_clientA",
  "data": {
    "status": "running",
    "taskId": "cgt-2026xxxx",
    "progress": 50,
    "attempt": 3,
    "message": "视频生成中，已尝试 3 次，状态: running"
  }
}

注意：data.taskId 为 Seedance 任务ID，用于区分不同分镜的子任务。

3.3 全部完成（任务成功事件）

{
  "msgType": "BatchGenerateVideoMessage",
  "taskId": "1001_clientA",
  "data": {
    "total": 10,
    "success": 8,
    "failed": 2
  }
}

3.4 特殊情况

场景	返回
章节下没有分镜	成功，data 为提示文案
所有分镜均已生成过视频	成功，data 为提示文案
episodeId 为空 / 系统异常	任务失败事件 + 错误消息

4. 配置项

application-aq.yml：

5. 前端对接建议

发送消息后监听两类 msgType：BatchGenerateVideoMessage（整体进度/汇总）和 CreateReferenceVideoMessage（单视频进度，可选展示）

用 progress 字段渲染进度条，storyboardId 定位对应分镜卡片的状态

收到汇总（total/success/failed）后刷新分镜列表接口 GET /storyboard/list?episodeId=xx&ischecked=1 获取最新视频 URL

6. 相关代码

文件	说明
`b2v-api/.../message/BatchGenerateVideoMessage.java`	消息定义
`b2v-web/.../socket/handler/BatchGenerateVideoHandler.java`	批量生成处理器（并发控制、进度推送）
`b2v-core/.../video/SeedanceMultipleImg2VideoImpl.java`	单视频任务提交与轮询
`b2v-web/.../resources/application-aq.yml`	并发数配置

批量生成章节分镜视频

批量生成分镜视频 WebSocket 接口文档

概述

1. 消息定义

后端类

请求字段

发送示例

2. 处理逻辑

3. 服务端推送消息

3.1 批量整体进度（msgType: `BatchGenerateVideoMessage`）

3.2 单视频生成进度（msgType: `CreateReferenceVideoMessage`）

3.3 全部完成（任务成功事件）

3.4 特殊情况

4. 配置项

5. 前端对接建议

6. 相关代码

Request

批量生成章节分镜视频

批量生成分镜视频 WebSocket 接口文档#

概述#

1. 消息定义#

后端类#

请求字段#

发送示例#

2. 处理逻辑#

3. 服务端推送消息#

3.1 批量整体进度（msgType: BatchGenerateVideoMessage）#

3.2 单视频生成进度（msgType: CreateReferenceVideoMessage）#

3.3 全部完成（任务成功事件）#

3.4 特殊情况#

4. 配置项#

5. 前端对接建议#

6. 相关代码#

Request

批量生成分镜视频 WebSocket 接口文档

概述

1. 消息定义

后端类

请求字段

发送示例

2. 处理逻辑

3. 服务端推送消息

3.1 批量整体进度（msgType: `BatchGenerateVideoMessage`）

3.2 单视频生成进度（msgType: `CreateReferenceVideoMessage`）

3.3 全部完成（任务成功事件）

3.4 特殊情况

4. 配置项

5. 前端对接建议

6. 相关代码