volcengine-video-understanding

name	volcengine-video-understanding
description	火山引擎视频理解技能，使用 doubao-seed-2.0-code 模型分析视频内容，评估情感表达、画面质量、叙事效果等。
metadata	{"openclaw":{"emoji":"👁️","os":["darwin","linux","windows"],"primaryEnv":"ARK_API_KEY","requires":{"env":["ARK_API_KEY"],"bins":["python3"]},"install":[{"id":"pip-volcengine","kind":"command","command":"pip install 'volcengine-python-sdk[ark]'","label":"安装火山引擎 Python SDK"}]}}

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。