mediakit-cli
Mediakit 官方 CLI —— 兼容 FFmpeg 的命令面,同一条命令既能在本地跑 FFmpeg 完成裁剪 / 拼接 / 加字幕 / 混音 / 提取音频等剪辑操作,也能一键切到云端调用画质增强、字幕擦除、ASR、OCR、剧情线分析等 FFmpeg 做不到的 AI 能力。目前已覆盖视频、图像、音频等多模态原子能力和 5 个 AI Agent Skills,未来预计提供 100+…
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/volcengine-mediakit-cli)HTML
<a href="/listings/volcengine-mediakit-cli"><img src="/api/listings/volcengine-mediakit-cli/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
以下两种方式**任选其一**:
**方式一 — 一键安装:**
npx @volcengine/mediakit-cli install -y
**方式二 — 从源码构建:**
需要 Go `v1.22`+。
git clone https://github.com/volcengine/mediakit-cli.git cd mediakit-cli make build # 产物:.mediakit/build/dev/mediakit-cli # 从本地 skills 目录安装 AI Agent Skills(必需) npx -y skills add ./skills -g -y
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 189 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # AI MediaKit CLI
- [](https://opensource.org/licenses/MIT)
- [](https://go.dev/)
- [](https://www.npmjs.com/package/@volcengine/mediakit-cli)
- [中文版](./README.md) | [English](./README.en.md)
- Mediakit 官方 CLI —— 兼容 FFmpeg 的命令面,同一条命令既能在本地跑 FFmpeg 完成裁剪 / 拼接 / 加字幕 / 混音 / 提取音频等剪辑操作,也能一键切到云端调用画质增强、字幕擦除、ASR、OCR、剧情线分析等 FFmpeg 做不到的 AI 能力。目前已覆盖视频、图像、音频等多模态原子能力和 5 个 AI Agent [Skills](./skills/),未来预计提供 100+ 音视频原子能力。
- [安装](#安装与快速开始) · [AI Agent Skills](#agent-skills) · [鉴权](#鉴权) · [命令结构](#命令结构) · [进阶用法](#进阶用法) · [许可证](#许可证)
- ## 为什么选 mediakit-cli?
- - **完备的能力矩阵**:横跨视频、图像、音频三大模态,从裁剪 / 拼接 / 加字幕等底层处理,到画质增强、字幕擦除、ASR、OCR、剧情线分析等上层理解,一条命令覆盖预处理到成片输出的全链路。
- - **兼容 FFmpeg,无缝迁移**:本地模式基于 `ffmpeg` / `ffprobe`,覆盖裁剪、拼接、加图片、加字幕、调速、调音量、翻转、淡入淡出、混音、音视频合成、提取音频、绿幕抠图、元信息探测等常用能力,与 FFmpeg 命令直觉对齐;滤镜、图片转视频、拼接转场等复杂 / AI 能力交由云端处理。
- - **云端更快更强**:同一条命令加 `--cloud` 就能升维到 FFmpeg 做不到的能力 —— 画质增强 / 生成式画质修复、字幕擦除(标准版 / 精细化)、ASR、视频 OCR、高光智剪(短剧 / 小游戏)、剧情故事线分析、场景切分、绿幕 / 人像抠图等 AI 原子能力,云端弹性算力提供秒级并发。
- - **一命令双模态**:`--local` / `--cloud` 可逐命令切换,本地零成本 + 云端弹性算力互补;共用同一份参数与 `--schema`,Agent / 脚本零改造切换。
- - **高性价比处理**:依托云端弹性资源调度与闲时批量处理策略,为大批量媒体任务提供极具竞争力的价格,显著降低 AI 应用的整体 Token 消耗与运行成本。
- ## 功能
- | 领域 | 能力 | 运行 |
- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
- | 🎬 **剪辑** (23) | 视频加图片 · 视频加字幕 · 音频调速 · 视频调速 · 调整视频音量 · 视频添加运镜 · 视频添加滤镜 · 音频拼接 · 视频拼接 · 视频画面裁剪 · 视频截取动图 · 提取音频 · 音频声音淡入淡出 · 视频声音淡入淡出 · 视频画面翻转 · 图片转视频 · 音频混合 · 视频加音频 · 视频画面旋转 · 视频画面拼接 · 文字生成滚屏视频 · 音频裁剪 · 视频裁剪 | 云端 **或** 本地 |
- | 🎚️ **音频** (4) | 语音端点识别 · 音频元信息获取 · 人声背景音分离 · 音频转码 | 云端 |
- | 🖼️ **图像 AI** (21) | 添加图文水印 · 图像调整 · 图像压缩 · 图像裁剪 · 图像画质增强 · 图像擦除修复 · 图像画质评估 · 图像人脸打码 · 图像翻转 · 图像高斯模糊 · 图像文字识别OCR · 图像负片 · 图像打码 · 图像元信息获取 · 图像背景移除 · 图像缩放 · 图像旋转 · 圆角矩形 · 图像锐化 · 集智瘦身 · 图像智能裁剪 | 云端 |
- | 🎥 **智能视频** (30) | 添加视频暗水印 · 高光片段提取 · 剧情故事线分析 · 语音转字幕(ASR) · 视频画质检测(VQScore) · 解说视频生成 · 解说视频生成(短剧行业模型) · 剧本还原 · 画质增强 · 视频画质增强极速版 · 生成式画质增强 · 字幕擦除(标准版) · 精细化字幕擦除 · 视频抽帧 · 提取视频暗水印 · 视频人脸打码 · 视频人脸融合 · 高光智剪-短剧 · 高光智剪-小游戏 · 高光智剪-影视拆条 · 极智超清 · 视频绿幕抠图 · 视频人像抠图 · 视频元信息获取 · 视频转封装 · 场景切分 · 智能语义切片 · 视频转码 · 视频识别字幕(OCR) · 视频理解智能策略 | 云端 |
- | 🔧 **通用** (2) | 异步任务查询 · 远程文件拉取 | 本地 / 云端 |
- | 🚧 **即将上线** | 视频翻译 · 解说生成 · 漫剧转绘(陆续上线) | 云端 |
- ## 安装与快速开始
- ### 环境要求
- 开始之前,请确保具备以下条件:
- - Node.js `>=18`(`npm` / `npx`)
- - 本地模式:`ffmpeg` `5.1.x` 与 `ffprobe`
- ### 快速开始(人类用户)
- #### 安装
- 以下两种方式**任选其一**:
- **方式一 — 一键安装:**
- ```bash
- npx @volcengine/mediakit-cli install -y
- ```
- **方式二 — 从源码构建:**
- 需要 Go `v1.22`+。
- ```bash
- git clone https://github.com/volcengine/mediakit-cli.git
- cd mediakit-cli
- make build # 产物:.mediakit/build/dev/mediakit-cli
- # 从本地 skills 目录安装 AI Agent Skills(必需)
- npx -y skills add ./skills -g -y
- ```
- #### 配置与使用
- ```bash
- # 1. 初始化配置(交互式引导)
- mediakit-cli init
- # 2. 环境自检(检查云端连通性、本地依赖、安装建议)
- mediakit-cli doctor
- # 3. 本地剪辑(同步、无需 API Key):本机运行 FFmpeg 完成裁剪
- mediakit-cli --local editing trim-video --video-url ./in.mp4 --start-time 3 --end-time 8
- # 4. 云端 AI(异步):将视频画质增强至 1080p,然后轮询获取最终结果
- mediakit-cli --cloud video enhance-video --video-url <url> --resolution 1080p
- mediakit-cli shared query-task --task-id <task_id> --poll-complete
- ```
- ### 快速开始(AI Agent)
- > 以下步骤面向 AI Agent,全流程支持无人值守。
- **第 1 步 — 安装**
- ```bash
- npx @volcengine/mediakit-cli install -y
- ```
- **第 2 步 — 非交互式初始化(`--yes` 模式)**
- ```bash
- # API Key 获取地址:https://console.volcengine.com/imp/ai-mediakit/settings
- MEDIAKIT_API_KEY=<your-api-key> \
- mediakit-cli init \
- --mode cloud-first \
- --yes
- ```
- **第 3 步 — 验证**
- ```bash
- mediakit-cli doctor
- mediakit-cli version
- ```
- ## Agent Skills
- | Skill | 说明 |
- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | `byted-mediakit-shared` | 通用能力:查询任务 |
- | `byted-mediakit-editing` | 剪辑:视频加图片、视频加字幕、音频调速、视频调速、调整视频音量、视频添加运镜、视频添加滤镜、音频拼接、视频拼接、视频画面裁剪、视频截取动图、提取音频、音频声音淡入淡出、视频声音淡入淡出、视频画面翻转、图片转视频、音频混合、视频加音频、视频画面旋转、视频画面拼接、文字生成滚屏视频、音频裁剪、视频裁剪 |
- | `byted-mediakit-audio` | 音频:语音端点识别、音频元信息获取、人声背景音分离、音频转码 |
- | `byted-mediakit-image` | 图像 AI:添加图文水印、图像调整、图像压缩、图像裁剪、图像画质增强、图像擦除修复、图像画质评估、图像人脸打码、图像翻转、图像高斯模糊、图像文字识别 OCR、图像负片、图像打码、图像元信息获取、图像背景移除、图像缩放、图像旋转、圆角矩形、图像锐化、集智瘦身、图像智能裁剪 |
- | `byted-mediakit-video` | 智能视频:添加视频暗水印、高光片段提取、剧情故事线分析、语音转字幕(ASR)、视频画质检测(VQScore)、解说视频生成、解说视频生成(短剧行业模型)、剧本还原、画质增强、视频画质增强极速版、生成式画质增强、字幕擦除(标准版)、精细化字幕擦除、视频抽帧、提取视频暗水印、视频人脸打码、视频人脸融合、高光智剪-短剧、高光智剪-小游戏、高光智剪-影视拆条、极智超清、视频绿幕抠图、视频人像抠图、视频元信息获取、视频转封装、场景切分、智能语义切片、视频转码、视频识别字幕(OCR)、视频理解智能策略 |
- ## 鉴权
- `mediakit-cli` 采用极简鉴权:只需一个 API Key,无需 OAuth / STS / IAM 角色配置。
- ```bash
- # 方式 A:init 时选择存储方式(config / shell / export)
- mediakit-cli init --api-key <your-api-key> --credential-store config --yes
- # 方式 B:临时通过环境变量注入
- export MEDIAKIT_API_KEY=<your-api-key>
- export MEDIAKIT_OUTPUT_PATH=<optional-custom-endpoint>
- ```
- | 环境变量 | 说明 |
- | ---------------------- | ------------------------------------------------------------------------------------- |
- | `MEDIAKIT_API_KEY` | 云端 API Key([控制台获取](https://console.volcengine.com/imp/ai-mediakit/settings)) |
- | `MEDIAKIT_OUTPUT_PATH` | 本地模式输出目录,默认 `~/.mediakit/temp` |
- ## 命令结构
- ```
- mediakit-cli [--cloud|--local] <domain> <tool> [flags]
- ```
- - **两种模式,同一命令面**:`--cloud` 走云端弹性算力(异步返回 `task_id`);`--local` 走本地 FFmpeg(同步、零成本)。默认为 `cloud-first`,可用 `--cloud` / `--local` 逐命令覆盖。
- - **输出**:云端结果以 URL 返回;本地结果落到 `~/.mediakit/temp`(可用 `--output-path` 或 `MEDIAKIT_OUTPUT_PATH` 覆盖)。
- 系统命令:
- | 命令 | 说明 |
- | -------------------------------------------- | ----------------------------------------------------------- |
- | `mediakit-cli init [--yes]` | 初始化配置,支持交互式或非交互式(Agent 友好) |
- | `mediakit-cli doctor` | 检查云端连通性、本地依赖与安装建议 |
- | `mediakit-cli config` | 查看 / 修改配置项 |
- | `mediakit-cli version [--check]` | 显示版本;`--check` 对比 npm 最新版 |
- | `mediakit-cli update [--check]` | 通过 `npm install -g` 更新 CLI 和 Skills;`--check` 只检查不安装 |
- | `mediakit-cli --domains` | 列出所有域 |
- | `mediakit-cli --help-full` | 列出全部能力索引 |
- | `mediakit-cli <domain> <tool> --schema` | 输出该能力的 JSON Schema(Mode / Async / 轮询命令等元信息) |
- | `mediakit-cli shared query-task --task-id X` | 查询异步任务;加 `--poll-complete` 轮询至终态 |
- ## 进阶用法
- ### Schema 自省
- 每个能力命令都支持 `--schema`,输出输入 / 输出 schema、Mode 与 Async 信息,供 Agent 动态发现工具能力:
- ```bash
- mediakit-cli video enhance-video --schema
- mediakit-cli --local editing trim-video --schema
- ```
- ### 本地模式输出命名
- 本地模式输出文件按以下优先级命名:
- 1. 显式 `--output-path` 指定完整文件路径(含扩展名)→ 直接使用
- 2. 有输入文件名 → `{原文件名}_{工具名}.{ext}`;同名文件已存在时追加 6 位随机数字
- 3. 无输入文件名 → `{工具名}-{时间戳}.{ext}`
- ## 许可证
- 本项目基于 **MIT 许可证** 开源。
- 该软件运行时会调用 MediaKit 云端 API,使用这些 API 需要遵守如下协议:
- - [视频云服务专有条款](https://www.volcengine.com/docs/6448/79646?lang=zh)
- - [智能处理服务计费规则](https://www.volcengine.com/docs/6448/104992?lang=zh)
- - [智能处理服务 SLA](https://www.volcengine.com/docs/6448/79648?lang=zh)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.