用途:借助 VSS Pipeline Manager 启动并跟踪视频摘要流水线,产出视频的最终摘要与分块字幕。
前置条件:后端需健康且启用 summary 能力,可先探测 health 与 app/features(必要时用 vss-doctor / vss-up 处理),并准备一个 videoId,可用 POST /manager/videos 上传视频(multipart,字段 video),响应为对象 { "videos": [...] },文件名为生成的哈希,真实文件名在 url / dataStore.fileName。
主要能力与用法:基础地址设为 HOST=http://${HOST_IP:-localhost}:${APP_HOST_PORT:-12345},接口走 nginx 的 /manager 前缀。启动摘要:POST /manager/summary,缺少 title、sampling.* 或 evam.evamPipeline 会返回 400;采样的约束是 multiFrame == frameOverlap + samplingFrame,不匹配返回 400 "Multi frame mismatch";evamPipeline 取值为 object_detection 或 video_ingestion。响应返回 summaryPipelineId,即 stateId。
轮询与完成判断:GET /manager/summary/{stateId} 无顶层 status/progress,进度分布在 chunkingStatus、frameSummaryStatus、videoSummaryStatus、audioTranscriptSummaryStatus 等分阶段字段。完成信号是 videoSummaryStatus == "complete",不能只看 summary 非空(摘要边生成边流出,会截断);produceFinalSummary 为 false 时改为等待 frameSummaryStatus.inProgress == 0。摘要较慢,通常需数分钟。
结果读取:最终摘要取自 .summary;分块字幕在 .frameSummaries[],不在 .chunks[](后者仅有 chunkId、duration、audioTranscripts)。可用 /raw 获取全部字段。管理上可列出全部摘要与删除单个摘要。无语音的音频会得到相应说明,属正常而非错误。
限制:资料未提供鉴权、模型、性能上限与收费信息;使用前需确认后端已启用 summary 能力。