TL;DR

이 레포는 FFmpeg 호환 명령어 인터페이스를 갖춘 Node 기반 CLI로, 동일한 명령을 --local로 로컬 ffmpeg/ffprobe에서 동기 실행하거나 --cloud로 클라우드 AI(화질 개선·ASR·OCR·자막 제거 등)를 비동기 호출할 수 있습니다. 설치는 npx @volcengine/mediakit-cli 또는 Go v1.22로의 소스 빌드를 지원하며, 인증은 단일 API Key로 처리되므로 Agent나 CI 환경에서 무인화 파이프라인 구축이 쉽습니다. 로컬 모드는 API Key 없이 ffmpeg 환경만으로 즉시 사용 가능하고, 클라우드 모드는 과금과 약관이 따르므로 고급 AI 처리가 필요한 경우에 적합합니다.

핵심 포인트

• AI MediaKit CLI는 FFmpeg 호환 커맨드 인터페이스를 제공하는 독립형 CLI 도구로, 동일한 명령을 로컬의 ffmpeg/ffprobe로 실행하거나 --cloud 플래그로 클라우드 AI 능력을 호출할 수 있습니다. 로컬 모드는 ffmpeg 기반으로 동기 처리해 파일을 ~/.mediakit/temp(또는 --output-path)로 저장하고, 클라우드 모드는 비동기 작업으로 task_id를 반환하여 query-task로 결과를 폴링합니다. 이 설계는 기존 FFmpeg 워크플로를 유지하면서 복잡한 AI 처리(화질 향상·ASR·OCR·자막 제거 등)를 클라우드로 전환하는 유연성을 제공합니다.
• 기능 표는 편집(editing 17개), 비디오 AI(14개), 이미지 AI(5개), 오디오 2개 등 명확한 카테고리와 항목 수를 제시하며, 기능은 로컬과 클라우드로 구분되어 구현됩니다. AI 관련 고급 기능은 skills 디렉토리 구조와 Agent Skills(byted-mediakit-*)로 모듈화되어 있어 mediakit-cli <domain> <tool> --schema로 입력/출력 스키마와 모드(Mode/Async)를 조회해 Agent가 동적으로 발견하도록 설계되어 있습니다. 이 구조는 무인화된 파이프라인과 Agent 통합을 용이하게 하며, 동일한 파라미터 집합으로 로컬·클라우드 전환을 가능하게 합니다.
• 설치와 실행 환경은 Node.js >=18 기반의 npm 패키지(@volcengine/mediakit-cli) 또는 Go v1.22 이상 소스 빌드를 모두 지원합니다. 사용자 상호작용 방식으로는 mediakit-cli init(대화형 또는 --yes 비대화형), mediakit-cli doctor로 의존성 및 연결 상태 점검, mediakit-cli shared query-task로 비동기 작업 폴링 같은 명령 체계가 제공되어 자동화와 수동 운영을 모두 수용합니다. 인증은 단일 API Key 방식으로 MEDIAKIT_API_KEY 환경변수나 init 시 credential-store에 저장하는 방식으로 처리되어 Agent나 CI 환경에서 간단히 사용할 수 있습니다.
• 프로젝트는 MIT 라이선스로 배포되지만, 클라우드 기능을 사용하면 별도 서비스 약관과 과금 규정이 적용됩니다(README에 링크된 영상 클라우드 서비스 전용 약관 및 과금 규칙 참조). 클라우드 모드는 탄력적 연산 자원을 활용해 AI 기능을 비동기 처리하므로 처리가 유료이며 출력은 URL로 반환됩니다. 이 점 때문에 온프레미스 ffmpeg만으로 충분한 경우에는 로컬 모드를 사용해 비용을 회피할 수 있고, 고급 AI 처리가 필요할 때만 클라우드를 선택하는 비용 통제가 가능합니다.