Volcengine Video Understanding - 视频理解分析

使用火山引擎 doubao-seed-2.0-code 模型对视频进行深度理解和分析。

前置条件

1. 需要火山引擎 API Key，设置环境变量

   ARK_API_KEY

2. 安装 SDK：

   pip install 'volcengine-python-sdk[ark]'

功能

1. 内容描述：详细描述视频画面内容
2. 情感分析：分析视频传达的情感氛围
3. 质量评估：评估画面质量、运镜技巧
4. 叙事分析：分析视频的叙事结构和节奏
5. 改进建议：提供优化建议

使用方法

分析单个视频

python3 {baseDir}/scripts/analyze_video.py \
  --video "/path/to/video.mp4" \
  --aspect "emotional" \
  --output "{workDir}/analysis_report.md"

参数说明：

• --video

  ：视频文件路径（必填）

• --aspect

  ：分析维度，可选：

  • content

    ：内容描述（默认）

  • emotional

    ：情感分析

  • quality

    ：质量评估

  • narrative

    ：叙事分析

  • comprehensive

    ：综合分析

• --output

  ：分析报告输出路径（可选，默认输出到控制台）

批量分析漫剧

分析 manga-drama 生成的所有场景视频：

python3 {baseDir}/scripts/analyze_drama.py \
  --drama-dir "/path/to/drama_output" \
  --output "{workDir}/drama_analysis.md"

分析维度说明

内容描述 (content)

• 画面主体识别
• 场景环境描述
• 动作行为分析
• 视觉元素提取

情感分析 (emotional)

• 整体情感氛围
• 情绪变化曲线
• 观众情感共鸣点
• 情感传达效果

质量评估 (quality)

• 画面清晰度
• 色彩表现
• 运镜流畅度
• 构图技巧
• 光影效果

叙事分析 (narrative)

• 故事结构
• 节奏把控
• 转场效果
• 信息传达效率

综合分析 (comprehensive)

包含以上所有维度的完整分析

输出格式

分析报告为 Markdown 格式，包含：

# 视频分析报告

## 基本信息
- 视频文件: xxx.mp4
- 时长: X秒
- 分辨率: 1920x1080

## 内容描述
...

## 情感分析
...

## 质量评估
...

## 改进建议
...

使用场景

1. 漫剧验收：分析 manga-drama 生成的视频效果
2. 质量把控：评估视频是否达到预期效果
3. 优化指导：获取具体的改进建议
4. 内容审核：检查视频内容是否符合要求

进阶资料

当需要系统解读评分、决定返工优先级或归纳常见问题时，读取

references/evaluation-matrix.md

。