Qwen 视频分析 LITE

Qwen 视频智能分析基础版,基于 Qwen 3.5 Plus 多模态模型对本地视频文件进行内容分析。仅支持本地文件输入与默认分析参数。

范围外(本技能不做): 远程 URL 在线分析、自定义抽帧频率(FPS)、自定义分析提示词、高精度动作识别、内容审核(需升级付费版)。

依赖说明

运行环境

• Agent 平台: 支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
• 操作系统: Windows / macOS / Linux
• Python: 3.8 及以上版本
• 网络: 需可访问阿里云 DashScope API 服务端点

依赖项

可用性分类

• 分类: MD+EXEC(Markdown 指令驱动,需 exec 执行 Python 脚本)
• 说明: 基于自然语言指令驱动 Agent 调用 Qwen 多模态 API,完成基础视频分析

核心能力

指令解析与执行

解析用户指令,执行Qwen视频分析LITE的核心操作。Qwen多模态模型视频分析基础版,支持本地视频文件场景描述与内容理解 Qwen 视频智能分析基础客户端(免费版)。基于 Qwen 3.5 Plus 多模态模型对本地视频文件进行内容分析, 支持场景描述与基础内容理解。使用默认抽帧频率与默认提示词,适合快速概览视频内容。 API Key 从 ~/.sk

输入: 用户提供指令解析与执行所需的参数和指令。 输出: 返回指令解析与执行的执行结果,包含操作状态和输出数据。

• 执行指令解析与执行操作，处理输入数据并返回结果
• 验证执行结果，确认输出符合预期格式
• 参考指令解析与执行相关配置参数进行设置

数据处理与转换

处理输入数据,执行Qwen视频分析LITE的转换操作并输出结果。

• 执行数据处理与转换操作，处理输入数据并返回结果
• 验证执行结果，确认输出符合预期格式
• 参考数据处理与转换相关配置参数进行设置

结果验证与输出

验证处理结果的正确性,格式化输出并返回给用户。

输入: 用户提供结果验证与输出所需的参数和指令。

技术细节

能力覆盖范围

本skill还覆盖以下能力场景: skill、platform、json、skills、dashscope、apiKey、字段读取、适用于个人创作者、快速理解视频内容、学习试用多模态分、析能力。这些能力在上述核心功能中均有对应处理逻辑。

认证

API Key 从 ~/.skill-platform/skill-platform.json 的 skills.dashscope.apiKey 字段读取。

cat ~/.skill-platform/skill-platform.json | grep apiKey

若 Key 缺失,引导用户:

1. 登录阿里云 DashScope 控制台
2. 开通 Qwen 多模态模型服务并创建 API Key
3. 在 ~/.skill-platform/skill-platform.json 中添加配置:

{
  "skills": {
    "dashscope": {
      "apiKey": "your-dashscope-api-key"
    }
  }
}

4. 配置完成后重新发起分析请求

安全红线: 永不接受/回显/存储来自聊天输入的 API Key;Key 仅从配置文件读取。

基础用法

使用默认参数分析本地视频文件(FPS=2,默认提示词"这段视频描绘的是什么景象?"):

python scripts/analyze.py /path/to/video.mp4

脚本将分析结果输出到 stdout,Agent 应将结果整理后返回给用户。

升级提示: 自定义提示词、自定义抽帧频率(FPS)、远程 URL 在线分析等高级能力仅在 analyze-video-by-qwen 付费版中提供。

适用场景

不适用于: 远程 URL 分析、高精度动作识别、内容审核、自定义提示词分析(需升级付费版)

使用流程

Step 1: 校验 API Key 配置

cat ~/.skill-platform/skill-platform.json | grep apiKey

若返回为空或文件不存在,按照认证章节引导用户配置。

Step 2: 确认视频文件

确认本地视频文件路径存在且为支持的视频格式(mp4/avi/mov/mkv/webm 等)。

Step 3: 执行分析

python scripts/analyze.py /path/to/video.mp4

使用默认 FPS=2 和默认提示词进行分析,结果输出到 stdout。

命令参数说明

• -demo: 命令参数,用于指定操作选项
• -dashscope-api-key: 命令参数,用于指定操作选项

案例展示

案例一： 本地视频内容概览

场景: 用户需要快速了解一段本地视频的内容

python scripts/analyze.py /path/to/video.mp4

输出: 模型返回视频场景描述,概括视频主要内容

说明: 使用默认参数(FPS=2,默认提示词),适合快速概览短视频内容。FPS=2 在每秒抽取 2 帧,平衡分析速度与内容覆盖度。

案例二： 产品演示视频理解

场景: 创作者需要理解一段产品演示视频的内容概要

python scripts/analyze.py /path/to/product-demo.mp4

输出: 模型返回视频内容描述,涵盖产品展示场景与主要功能

说明: 默认提示词"这段视频描绘的是什么景象?"适合通用场景理解。如需聚焦产品特点的定制化分析,需升级付费版使用自定义提示词功能。

错误处理

常见问题

Q1: 如何配置 DashScope API Key?

A: 在 ~/.skill-platform/skill-platform.json 文件中添加 skills.dashscope.apiKey 字段。首先登录阿里云 DashScope 控制台开通 Qwen 多模态模型服务并创建 API Key,然后将 Key 写入配置文件。

Q2: 支持哪些视频格式?

A: 支持 mp4、avi、mov、mkv、webm 等常见视频格式。本地文件路径可以是绝对路径或相对路径。免费版仅支持本地文件,不支持远程 URL(需升级付费版)。

Q3: 免费版和付费版有什么区别?

A: 免费版(LITE)支持本地视频文件的默认参数分析(FPS=2,默认提示词)。付费版(analyze-video-by-qwen)额外提供:

• 远程 URL 在线视频分析
• 自定义抽帧频率(--fps 参数,1-5 可调)
• 自定义分析提示词(--prompt 参数)
• 高精度动作识别与内容审核
• 3 个完整案例(vs 免费版 2 个基础案例)
• 8 种错误处理(vs 免费版 5 种)

Q4: 分析结果不够详细怎么办?

A: 免费版使用默认提示词"这段视频描绘的是什么景象?",提供通用场景描述。如需针对特定维度(产品特点、动作细节、违规内容等)的定制化分析,需升级付费版使用自定义提示词功能。

已知限制

1. 仅支持本地文件: 不支持远程 URL 在线分析(需升级付费版)
2. 固定 FPS=2: 不支持自定义抽帧频率(需升级付费版)
3. 固定默认提示词: 不支持自定义分析提示词(需升级付费版)
4. 需 DashScope API Key: 必须配置阿里云 DashScope API Key
5. 分析质量取决于模型能力: 复杂场景识别准确度受限于 Qwen 3.5 Plus 模型能力

想要远程 URL 分析、自定义提示词与抽帧频率? 升级到 analyze-video-by-qwen 付费版 解锁全部高级能力。