AI MediaKit CLI

English

面向 Agent 的音视频命令行工具集。用一个统一的命令调用火山引擎的云端 AI 能力、跑本地剪辑——既能让 AI Agent（Claude Code、Trae、Cursor……）自然语言调度，也能你自己在终端直接用。

mediakit-cli 把画质增强、字幕擦除和一整套剪辑能力收进一个工具：重算力 AI 跑云端，轻量剪辑在本地跑——一个 flag 切换，命令写法不变。

✨ 能做什么

5 大领域、40+ 能力 —— 运行 mediakit-cli --help-full 可列全。

领域	能力	运行	状态
🎬 剪辑 (17)	裁剪 · 拼接 · 加水印 · 加字幕 · 调速 · 调音量 · 滤镜 · 翻转 · 淡入淡出 · 混音 · 合成 · 提取音频 · 图片转视频	云端或本地	✅ 已上线
🎚️ 音频 (2)	人声 / 背景音分离 · 音频元信息探测	云端	✅ 已上线
🖼️ 图像 AI (5)	画质增强 · 擦除修复 · 画质评分 · OCR · 背景移除	云端	✅ 已上线
🎥 视频 AI (14)	画质增强（含生成式修复）· 字幕擦除 · ASR 字幕 · OCR · 高光智剪（短剧 / 小游戏）· 剧情线分析 · 场景切分 · 人像 & 绿幕抠图 · 元信息探测	云端	✅ 已上线
🔧 通用 (2)	异步任务查询 · 远程文件拉取	本地 / 云端	✅ 已上线
🚧 即将上线	视频翻译 · 解说生成 · 漫剧转绘	云端	陆续上线

AI 能力跑在云端（弹性算力、异步）；剪辑能力云端或本地皆可（本地跑，同步、零成本）—— 每条命令用 --cloud / --local 选。

🚀 快速开始

npm install -g @volcengine/mediakit-cli
npx skills add volcengine/mediakit-cli -g -y   # 可选 —— 装 Agent Skill（Claude Code / Trae / Cursor …）
export MEDIAKIT_API_KEY=<你的 API Key>         # 在 AI MediaKit 控制台获取

# 云端 AI（异步）：增强到 1080p，再轮询拿结果
mediakit-cli --cloud video enhance-video --video-url <url> --resolution 1080p
mediakit-cli shared query-task --task-id <task_id> --poll-complete

# 本地剪辑（同步、无需 Key）：在本机跑
mediakit-cli --local editing trim-video --video-url ./in.mp4 --start-time 3 --end-time 8

📦 安装

# 一键安装（CLI + AI Agent Skill）
npx @volcengine/mediakit-cli install -y

# 仅装 CLI（推荐，跨平台——自动拉取对应平台 / 架构的构建产物）
npm install -g @volcengine/mediakit-cli

# npx（免安装）
npx @volcengine/mediakit-cli version

# curl（macOS / Linux）
curl -fsSL https://raw.githubusercontent.com/volcengine/mediakit-cli/main/scripts/install.sh | bash

指定版本 / 路径：VERSION=<version> INSTALL_DIR="$HOME/.local/bin" curl -fsSL …/install.sh | bash

验证环境：mediakit-cli doctor（检查云端就绪 + 本地工具依赖 + 安装指引）。

更新

CLI 每天会向 npm registry 检查一次新版本（TTL 24h）。有更新时，stderr 会出现提示，stdout JSON 会带上 _notice.update 字段。

mediakit-cli version --check       # 以 JSON 输出当前版本 vs 最新版本
mediakit-cli update --check        # 只检查，不安装
mediakit-cli update                # 通过 `npm install -g` 安装最新版

如需关闭自动检查，设置 MEDIAKIT_DISABLE_UPDATE_CHECK=1，或在 CI 中运行（CI 环境变量被设置时也会自动抑制）。

🤖 配合 AI Agent 使用

mediakit-cli 自带 AI Agent Skill——教 Agent 怎么调它。于是用户只需说一句*"把这个视频增强到 1080p，再剪出最精彩的 5 秒"*，Agent 就能自动编排命令。

# 一个命令把 Skill 装进本机所有支持的 Agent
npx skills add volcengine/mediakit-cli -g -y

它会自动检测并安装到 10+ 种 runtime——Claude Code、Trae（国内 & 海外）、Cursor、Codex、Gemini CLI、GitHub Copilot、OpenCode、OpenClaw、Antigravity 等。

每个能力还MCP 兼容——mediakit-cli <domain> <tool> --schema 吐出 JSON Schema，直接喂 MCP / Anthropic Tool Use / function calling，无需手写适配器。

🧩 工作原理

两种模式，同一套命令。 --cloud 把重算力 AI 跑在火山引擎云端（弹性算力、异步 task_id）；--local 在本机跑确定性剪辑（同步、零云端成本）。默认 cloud-first，单命令 flag 可覆盖。
命令结构： mediakit-cli [--cloud|--local] <domain> <tool> [flags]——domain 为 editing · audio · image · video · shared。
输出： 云端结果以 URL 返回；本地结果写到 ~/.mediakit/temp（可用 --output-path 或 MEDIAKIT_OUTPUT_PATH 覆盖）。

📖 文档

Volcengine AI MediaKit 产品文档 & 定价：https://www.volcengine.com/docs/6448
完整命令参考 & FAQ：见文档站。
错误码与退出码契约 —— stdout JSON 协议与退出码规则。

🛠 开发

make build          # 本地构建 → .mediakit/build/dev/mediakit-cli
make build-all      # 全平台
make snapshot       # snapshot release

发布走 .goreleaser.yml；npm 分发走 package.json + scripts/install.js；curl 安装走 scripts/install.sh。

本地工具 Admission（FFmpeg 策略）

ffmpeg / ffprobe：必需，5.1.x，LGPL v2.1 或更高，允许商用
可选 FFmpeg 能力：openh264、libmp3lame、libass、libfreetype、libfontconfig、libfribidi、libharfbuzz、zlib、libpng、libjpeg-turbo
边界：仅通过外部进程调用（不把本地工具静态 / 动态链接进 Go 二进制）；FFmpeg 默认保持 LGPL 模式；默认不引入 non-free 组件；不保留本地中间产物（仅保留最终产物 + fetch-file 下载）。

License

本项目基于 MIT 许可证开源。

该软件运行时会调用 MediaKit 的 API，使用这些 API 需要遵守如下协议和隐私政策：

6.4 KiB Raw Blame History Unescape Escape