AI MediaKit CLI
Команда в стиле FFmpeg, которая режет видео локально и отправляет тяжелые задачи в облако Volcengine: улучшение, ASR, OCR
- 223 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Облачные операции загружают ваши видео и изображения в Volcengine, а ключ API лежит в конфигурации на диске или в переменной окружения
- В облаке доступна подмена лиц в видео: использовать ее без согласия людей в кадре нельзя, это вред третьим лицам и нарушение закона
- Локальные команды запускают FFmpeg на файлах, которые передал агент
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ai-mediakit-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Облачные операции загружают ваши видео и изображения в Volcengine, а ключ API лежит в конфигурации на диске или в переменной окружения
- В облаке доступна подмена лиц в видео: использовать ее без согласия людей в кадре нельзя, это вред третьим лицам и нарушение закона
- Локальные команды запускают FFmpeg на файлах, которые передал агент
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AI MediaKit CLI — официальная командная строка Volcengine для обработки видео, звука и изображений. Одна и та же команда либо запускает FFmpeg на вашей машине (`--local`: обрезка, склейка, субтитры, смешивание звука, извлечение дорожки, метаданные), либо отправляет работу в облако (`--cloud`): улучшение качества, стирание вшитых субтитров, распознавание речи, OCR видео, анализ сюжетной линии, нарезка сцен, хромакей и вырезание людей. Облачные операции асинхронные: `mediakit-cli --cloud video enhance-video --video-url <url> --resolution 1080p` возвращает задачу, а `mediakit-cli shared query-task --task-id <id> --poll-complete` дожидается результата. В комплекте пять скиллов для агента: `byted-mediakit-editing`, `byted-mediakit-audio`, `byted-mediakit-image`, `byted-mediakit-video` и `byted-mediakit-shared`. Все ставятся одной командой `npx @volcengine/mediakit-cli install -y`, а `mediakit-cli init --mode cloud-first --api-key <ключ> --yes` настраивает облачный ключ без вопросов.
Для кого. Разработчикам и командам контента, которые строят с агентом конвейеры обработки видео и готовы использовать облако Volcengine для операций с ИИ.
Подходит, если
- Ролик надо обрезать, склеить, наложить субтитры или смешать звук локально, не вспоминая флаги FFmpeg
- Видео в низком разрешении нужно улучшить до 1080p, а своего железа под это нет
- Речь в ролике надо превратить в субтитры или прочитать текст из кадров (ASR и OCR)
- С видео надо стереть вшитые субтитры перед повторной озвучкой
- Часть шагов конвейера идет локально, часть в облаке, и скрипты не хочется переписывать при переключении `--local` и `--cloud`
Не подходит, если
- Нет аккаунта Volcengine: облачные операции требуют ключ API, а без него работает только локальная обработка
- Нет FFmpeg 5.1.x с `ffprobe`: локальный режим опирается на них
- Файлы нельзя загружать во внешнее облако: облачные операции отправляют видео и изображения в Volcengine
Пример запроса к агенту
Обрежь in.mp4 с 3-й по 8-ю секунду локально, затем улучши результат до 1080p в облаке и дождись готовностиОграничения
Основной README написан по-китайски, английская версия лежит в `README.en.md`. Для установки нужен Node.js 18 или новее, для локального режима FFmpeg 5.1.x вместе с `ffprobe`. Облачные операции асинхронные и расходуют ресурсы вашего аккаунта Volcengine, ключ берется в консоли сервиса. Перевод видео, генерация закадрового текста и перерисовка в мангу в README помечены как скоро появятся. Доступность консоли Volcengine из России не подтверждена.
Как отключить. Удалите скиллы `byted-mediakit-*` из каталога скиллов агента, выполните `npm uninstall -g @volcengine/mediakit-cli` и сотрите сохраненный ключ из конфигурации `mediakit-cli`. Переменную `MEDIAKIT_API_KEY` уберите из окружения.
Частые вопросы
Чем `--local` отличается от `--cloud`?
С `--local` команда работает на вашей машине через FFmpeg, синхронно и без ключа. С `--cloud` она идет в облако Volcengine асинхронно, использует ключ API и дает ИИ-операции вроде улучшения качества и распознавания речи.
Как узнать результат облачной задачи?
Облачная команда возвращает идентификатор задачи. Передайте его в `mediakit-cli shared query-task --task-id <id> --poll-complete`, и CLI будет опрашивать задачу до готовности.
Как настроить CLI без интерактивных вопросов?
Выполните `mediakit-cli init --mode cloud-first --api-key <ключ> --yes`. Другой вариант: передать ключ через `MEDIAKIT_API_KEY`. Каталог для локальных результатов по умолчанию `~/.mediakit/temp`, его меняет `MEDIAKIT_OUTPUT_PATH`.
Что проверяет `mediakit-cli doctor`?
Связь с облаком, наличие локальных зависимостей (`ffmpeg`, `ffprobe`) и дает рекомендации по установке. Это первая команда после установки.
Как собрать CLI из исходников?
Нужен Go 1.22 или новее: `git clone https://github.com/volcengine/mediakit-cli.git`, затем `make build`. Скиллы из каталога `skills` ставятся отдельно командой `npx -y skills add ./skills -g -y`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI для fal.ai: агент ищет, запускает и скачивает результаты 1200 с лишним моделей картинок, видео и звука командами оболочки.
Локальный видеомонтаж для агентов: типизированные инструменты поверх FFmpeg, проверка качества и чек перед публикацией
ffmpeg-skill — скилл и MCP-сервер: агент режет и склеивает видео, правит звук, делает субтитры и экспорт под TikTok, Reels и YouTube через локальный FFmpeg
Видеомонтаж для агентов: openreelio-cli с JSON-выводом и MCP-сервером режет, подписывает, рендерит и проверяет ролик
CLI и скиллы для кодового агента собирают черновой монтаж из ваших видео и сохраняют проект для дальнейшей правки
Clipmivo Video
clipmivo-video
Скилл для ClipmivoAI: агент оценивает видеозадачу в кредитах, запускает генерацию, следит за ней и скачивает результат.
Коротко о README
README перечисляет достоинства, таблицу возможностей по областям (монтаж, звук, ИИ для изображений и видео), установку для людей и для агента, пять скиллов, схему авторизации через единственный ключ API и структуру команд. Отдельно описаны режимы `--local` и `--cloud` и продвинутое использование.