| name | volcengine-video-understanding |
| description | 火山引擎视频理解技能，使用 doubao-seed-2.0-code 模型分析视频内容，评估情感表达、画面质量、叙事效果等。 |
| metadata | {"openclaw":{"emoji":"👁️","os":["darwin","linux","windows"],"primaryEnv":"ARK_API_KEY","requires":{"env":"[Truncated]","bins":"[Truncated]"},"install":["[Truncated]"]}} |
Volcengine Video Understanding - 视频理解分析
使用火山引擎 doubao-seed-2.0-code 模型对视频进行深度理解和分析。
前置条件
- 需要火山引擎 API Key，设置环境变量
ARK_API_KEY
- 安装 SDK：
pip install 'volcengine-python-sdk[ark]'
功能
- 内容描述：详细描述视频画面内容
- 情感分析：分析视频传达的情感氛围
- 质量评估：评估画面质量、运镜技巧
- 叙事分析：分析视频的叙事结构和节奏
- 改进建议：提供优化建议
使用方法
分析单个视频
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
## 内容描述
...
## 情感分析
...
## 质量评估
...
## 改进建议
...
使用场景
- 漫剧验收：分析 manga-drama 生成的视频效果
- 质量把控：评估视频是否达到预期效果
- 优化指导：获取具体的改进建议
- 内容审核：检查视频内容是否符合要求
进阶资料
当需要系统解读评分、决定返工优先级或归纳常见问题时，读取 references/evaluation-matrix.md。
