Volcengine Video Understanding

This connects Claude to ByteDance's Volcano Engine video understanding API, specifically their doubao-seed models. It handles video uploads up to 512MB through the Files API, then analyzes content for scenes, actions, emotions, and answers questions about what's happening in the video. The recommended workflow is upload via Files API then analyze via Responses API, with automatic FPS sampling and 7-day file storage. You'll need an ARK_API_KEY to use it. It's seeing solid adoption with nearly 400 installs and has passed security audits across three platforms. Good fit if you're already in the ByteDance ecosystem or need video analysis capabilities beyond what standard vision models offer.

skills.sh installs: 579
GitHub stars: 474
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add freestylefly/canghe-skills --skill volcengine-video-understanding --agent claude-code

Installs into .claude/skills of the current project.

Files

火山视频理解

使用字节跳动火山方舟视频理解 API（doubao-seed-2-0-pro-260215 等模型）对视频进行深度理解和分析。

推荐方式：Files API 上传 + Responses API 分析

支持最大 512MB 视频文件
自动视频预处理（FPS采样）
文件可重复使用（存储7天）

功能

视频上传：通过 Files API 上传本地视频（推荐，最大512MB）
内容理解：分析视频场景、人物、动作、情感
视频问答：基于视频内容回答用户问题
视频描述：自动生成视频描述和摘要

前置要求

需要设置 ARK_API_KEY 环境变量。

配置方式（推荐）

复制配置模板：

cp .canghe-skills/.env.example .canghe-skills/.env

编辑 .canghe-skills/.env 文件，填写你的 API Key：

ARK_API_KEY=your-actual-api-key-here

或使用环境变量

export ARK_API_KEY="your-api-key"

加载优先级

系统环境变量 (process.env)
当前目录 .canghe-skills/.env
用户主目录 ~/.canghe-skills/.env

使用方法

1. 基础视频分析（Files API 方式 - 推荐）

cd ~/.openclaw/workspace/skills/volcengine-video-understanding
python3 scripts/video_understand.py /path/to/video.mp4 "描述这个视频的内容"

2. 视频问答

python3 scripts/video_understand.py /path/to/video.mp4 "视频中出现了哪些人物？"

3. 情感分析

python3 scripts/video_understand.py /path/to/video.mp4 "分析视频中人物的情感变化"

4. 指定模型和帧率

python3 scripts/video_understand.py /path/to/video.mp4 "总结视频要点" \
  --model doubao-seed-2-0-pro-260215 \
  --fps 2

SKILL.md on GitHub

Details

Repository: github.com/freestylefly/canghe-skills
Category: Backend & APIs
First seen: Jun 3, 2026