비디오 제작 매트릭스 (v3 — 기능 기반)은(는) 무엇을 하나요?
이 매트릭스는 에이전트가 필요에 따라 구성할 수 있는 기능들을 설명합니다 — 고정된 파이프라인이 아닙니다. "비디오 제작" 워크플로우는 필요로 하는 기능들로 구성된 레시피를 선택하고, 각 기능에 대해 태스크 요구사항과 아래 사전 비행 정보를 바탕으로 제공자를 선택합니다.
스키마: docs/cli-matrix/matrix_registry.schema.md.
설치 (설치 가능한 부분)
cli-hub matrix install video-creation # 등록된 매트릭스 CLI만 설치
cli-hub matrix info video-creation # 제공자 및 레시피 확인
cli-hub matrix preflight video-creation # 현재 환경에서 사용 가능한 제공자 확인
이 매트릭스의 모든 항목이 cli-hub matrix install로 설치되는 것은 아닙니다. 클라우드 API, 파이썬 패키지, 네이티브 바이너리, 타사 공개 CLI, 외부 스킬도 일급 제공자이지만, 태스크에서 실제로 해당 제공자가 필요할 때만 설치하십시오.
CLI-Anything 매트릭스 멤버에 대해 pip install ...#subdirectory=...를 직접 작성하지 마십시오. 지원되는 하니스는 cli-hub matrix install video-creation을 통해 설치한 후, 사전 비행을 통해 이미 사용 가능한 다른 도구들을 확인하십시오.
제공자 선택 제약 조건 (에이전트: 기능별 평가)
- 사전 비행을 가용성 보고서로 사용하되, 제공자 선택기로 사용하지 마십시오.
- 사용자의 목표, 품질 기준, 예산, 오프라인 필요 여부, 자격 증명 상태, 설치 비용, 요청된 워크플로우를 기준으로 제공자를 선택하십시오.
- 레지스트리/제공자 순서는 문서 순서일 뿐이며, 첫 번째 제공자가 올바른 제공자라고 가정하지 마십시오.
- 파이썬 라이브러리, 네이티브 바이너리, 하니스 CLI, 공개 CLI, 에이전트 스킬은 태스크 제약 조건에 적합할 때만 설치하십시오.
- 유료 또는 사용량 기반 API는 사용자가 자격 증명을 제공했거나 명시적으로 동의한 경우에만 사용하십시오. 유료 API를 무단으로 호출하지 마십시오.
- 태스크가 특정 장르에 속하고 필수 제공자 규칙이 있는 경우, 해당 제공자는 선택 사항이 아닙니다. 로컬에서 편리하다는 이유만으로 더 저렴하거나 쉬운 대체재를 사용하지 마십시오.
오프라인 컨텍스트? offline: true 제공자로만 필터링하십시오.
사전 비행 (세션당 한 번 실행, 결과 캐시)
먼저 내장 매트릭스 사전 비행을 실행하십시오:
cli-hub matrix preflight video-creation --json
cli-hub matrix preflight video-creation --capability composite.assemble
cli-hub matrix preflight video-creation --offline
최신 cli-hub 없이 원시 검사가 필요하거나 실행해야 하는 경우, 수동 블록을 사용하십시오:
cli-hub list --json
python - <<'PY'
import importlib.util
for m in ("moviepy","whisper","pydub","PIL","edge_tts","pysrt","pysubs2","yt_dlp","spotdl","scenedetect","paddleocr","twelvelabs"):
print(m, importlib.util.find_spec(m) is not None)
PY
for b in ffmpeg ffprobe sox convert magick screencapture yt-dlp spotdl scdl bandcamp-dl you-get lux BBDown scenedetect mediainfo ffmpeg-quality-metrics paddleocr hyperframes; do command -v "$b" >/dev/null && echo "$b: yes" || echo "$b: no"; done
for e in RUNWAY_API_KEY KLING_API_KEY PIKA_API_KEY SEEDANCE_API_KEY \
ELEVENLABS_API_KEY MINIMAX_API_KEY OPENAI_API_KEY GOOGLE_CLOUD_PROJECT \
ASSEMBLYAI_API_KEY DEEPGRAM_API_KEY \
SUNO_API_KEY UDIO_API_KEY IDEOGRAM_API_KEY STABILITY_API_KEY \
TWELVELABS_API_KEY GOOGLE_APPLICATION_CREDENTIALS; do
[ -n "${!e}" ] && echo "$e: set" || echo "$e: unset"
done
사용자 제안 템플릿 (에이전트가 에스컬레이션 시 그대로 사용)
<기능>을(를) <제공자>를 통해 활성화하려면 <ENV_VAR>을(를) 설정해 주세요.
비용: <비용 정보>
품질: <품질 등급>
'skip'으로 응답하면 <다음 제공자>로 대체됩니다.
예시:
- Runway Gen-4를 통해 시네마틱 AI 비디오를 활성화하려면
RUNWAY_API_KEY를 설정해 주세요. 비용: 2026-04 기준 약 $0.05/초. 품질: 최고 수준. 'skip'으로 응답하면 구성된 경우generate-veo-video또는jimeng로 대체됩니다. - ByteDance Seedance 비디오 생성을 활성화하려면
SEEDANCE_API_KEY를 설정해 주세요. 비용: 클립당 사용량 기준. 품질: 사실적인 움직임에 최고 수준. 'skip'으로 응답하면 ByteDance 모델 제품군을 공유하는jimeng(Dreamina)로 대체됩니다.
기능
script.storyboard — 브리프에서 크리에이티브 방향, 스크립트, 샷 리스트, 타이밍, 자산 계획까지
사용자가 모호한 개념을 제시하거나 완전한 비디오를 요청할 때 생성, 검색, 캡처 또는 조립 전에 이 기능을 사용하십시오. 기본적으로 계획을 에이전트 작업으로 직접 수행하십시오: 구조화된 브리프, 전체 크리에이티브 방향, 내러티브/감정적 호, 오디오 호, 스크립트/나레이션, 샷 리스트, 타이밍 맵, 자산 요구사항, 검토 가능한 스토리보드를 다운로드나 생성에 시간을 소비하기 전에 생성하십시오.
중요하지 않은 비디오의 경우 references/story-structure-audio.md를 읽고 최종 조립 전에 creative_direction.md를 저장하십시오. 이는 트레일러, 스포츠/뮤직 몽타주, 영화 해설, 파운드 푸티지 편집, 제품 출시 비디오 및 평범한 무작위 클립이나 지루한 음악이 브리프를 충족시키지 못할 모든 출력물에 필수입니다.
하드 게이트: 중요하지 않은 비디오의 최종 조립을 creative_direction.md가 존재할 때까지 시작하지 마십시오. plan.md는 대체재가 아닙니다. 파일에는 대상 길이 또는 요청된 길이 범위, 출력 언어, 시간, 비트, 소스/샷 역할, 오디오 이벤트, 캡션/타이틀 역할, 실패 위험이 포함된 샷 역할 테이블이 포함되어야 합니다. 장르에 적합한 페이오프, 클라이맥스, 공개, 유용한 요약 또는 의도적인 미해결 훅이 없는 엔딩/최종 막이 있는 계획은 거부하십시오. 언어 규칙: 사용자가 출력 언어를 지정한 경우, 에이전트가 작성하는 모든 시청자 대상 콘텐츠에 해당 언어를 사용하십시오. 그렇지 않으면 사용자가 대화에서 사용하는 언어를 사용하십시오.
| 제공자 | 종류 | 요구사항 | 비용 | 품질 | 오프라인 |
|---|---|---|---|---|---|
| 에이전트 네이티브 기획 | agent-native | 없음 | 무료 | 높음 | 예 |
storyboard-creation 스킬 | agent-skill | 설치된 스킬 | 무료 | 높음 | 예 |
remotion-best-practices 스킬 | agent-skill | 설치된 스킬 | 무료 | 코드 기반 모션 비디오에 높음 | 예 |
선택:
- 일반 스크립트, 샷 리스트, 타이밍 맵, 자산 계획에는 에이전트 네이티브 기획으로 시작하십시오.
creative_direction.md에 한 문장 약속, 스토리 호, 감정 곡선, 오디오 호, 컷 밀도 곡선, 시각적 모티프, 소스 역할, 평탄함 방지 가드레일을 포함하십시오.- 명시적인 스토리보드 패널 규칙, 카메라 각도 문법, 연속성 검사 또는 애니매틱 기획이 필요할 때만
storyboard-creation을 사용하십시오. - 스토리보드가 Remotion/React 모션 비디오 코드로 구현될 때만
remotion-best-practices를 사용하십시오.
video.search — 인터넷 후보 영상 발굴
사용자가 파운드 푸티지, B-roll, 퍼블릭 도메인 클립, 스톡 영상, YouTube/Bilibili 자료 또는 특정 영화/TV/게임/애니메이션 장면을 요청할 때 video.download 전에 이 기능을 사용하십시오. 먼저 무료/오픈 소스를 선호하고 편집 전에 소스 URL, 라이선스, 제작자, 저작자 표시 요구사항을 기록하십시오.
파운드 푸티지 결과물 또는 플랫폼 출처 주장의 경우 references/source-triage.md를 읽고 각 후보를 직접 플랫폼 소스, 확인된 플랫폼 출처 전송, 또는 약한 미러로 분류하십시오.
| 제공자 | 종류 | 요구사항 | 비용 | 품질 | 오프라인 |
|---|---|---|---|---|---|
| 웹 검색 + 소스 필터 | web-search | 온라인 검색 액세스 | 무료 | 좋음 | 아니요 |
검색 규율:
- 재사용 가능/상업적으로 안전한 B-roll의 경우 Wikimedia Commons, YouTube Creative Commons 또는 기타 브라우저 검색 가능한 스톡/퍼블릭 도메인 페이지에서 시작하고 다운로드된 모든 파일 옆에 저작자 표시 메타데이터를 보관하십시오.
- Bilibili/YouTube 참조 또는 팬 편집 워크플로우의 경우 일반 용어 대신 특정 장면 이름을 검색하십시오.
1080p,4K,HD,BD,蓝光또는高清과 같은 품질 수정자를 추가하십시오. - Bilibili의 경우
site:bilibili.com "Game of Thrones" S3E09 BV와 같은 타겟 웹 검색을 사용하십시오. 독립형/video/BV...업로드는 일반적으로 지리적으로 제한된 bangumi URL보다 처리하기 쉽습니다. - 다운로드 가능성을 허가로 간주하지 마십시오. 라이선스나 사용자 승인이 불분명한 경우 결과물에 영상을 사용하기 전에 문의하십시오.
video.download — 웹 비디오를 작업 공간에 다운로드/가져오기
video.search가 후보 URL을 식별한 후 또는 사용자가 직접 URL을 제공할 때 이 기능을 사용하십시오. 모든 원시 다운로드는 하나의 sources/ 디렉토리에 보관하고, URL/라이선스/제작자/출처가 포함된 sources.json을 저장한 후, 다운스트림 편집을 위해 파일 이름을 정규화하십시오.
인터넷 영상의 경우 sources.json에는 플랫폼 URL, 전송 URL(다른 경우), 명령어, 사용된 쿠키 파일 경로, 로컬 파일, 프로브 요약, 선택된 범위, 소스 역할, 라이선스/권리 메모, 품질 주의사항이 기록되어야 합니다.
| 제공자 | 종류 | 요구사항 | 비용 | 품질 | 오프라인 |
|---|---|---|---|---|---|
yt-dlp | public-cli | yt-dlp + ffmpeg | 무료 | 높음 | 아니요 |
you-get | public-cli | you-get 바이너리 | 무료 | 좋음 | 아니요 |
lux | public-cli | lux + ffmpeg | 무료 | 좋음 | 아니요 |
BBDown | public-cli | BBDown + ffmpeg | 무료 | Bilibili에 높음 | 아니요 |
운영 참고 사항:
- 품질이 중요한 YouTube/Bilibili URL의 경우
yt-dlp -f "bestvideo[height>=1080]+bestaudio/best" --merge-output-format mp4를 선호하십시오. 사용자가 콘텐츠에 대한 액세스를 승인한 경우에만 쿠키를 사용하십시오. - Bilibili 오디오 전용 추출의 경우
yt-dlp -x --audio-format mp3를 피하십시오. 원시 m4a를 다운로드하고ffmpeg로 변환한 후 사용하기 전에 볼륨을 확인하십시오. - Bilibili 특정 메타데이터, 자막, 단마쿠, 재생 목록 또는 고품질 멤버 스트림이 태스크의 핵심인 경우
BBDown을 사용하십시오.
music.search — 기존 노래, BGM 또는 원본 오디오 소스 발굴
사용자가 기존 노래, 사운드트랙 큐, 로열티 프리 트랙, 플랫폼 오디오 또는 특정 커버/버전을 원할 때 music.download 전에 이 기능을 사용하십시오. 검색은 사용 가능한 모든 오디오가 아닌 요청된 음악에 초점을 맞추십시오. 제목, 아티스트, 플랫폼 URL, 업로더, 소스 유형, 버전 정보, 권리/라이선스, 저작자 표시를 music_sources.json에 기록하십시오.
| 제공자 | 종류 | 요구사항 | 비용 | 품질 | 오프라인 |
|---|---|---|---|---|---|
| 웹 검색 + 소스 필터 | web-search | 온라인 검색 액세스 | 무료 | 좋음 | 아니요 |
yt-dlp 검색 추출기 | public-cli | yt-dlp | 무료 | 좋음 | 아니요 |
spotdl 메타데이터/검색 | public-cli | spotdl | 무료 | Spotify 연결 노래에 좋음 | 아니요 |
검색 규율:
- 원본 오디오의 경우 아티스트의 공식 업로드, 레이블 업로드, 공식 오디오/MV, 확인된 리릭 비디오 또는 추가 설명자가 없는 독립형 오디오 업로드를 찾으십시오.
- 사용자가
女生版, 듀엣, 피아노, 어쿠스틱, 라이브, DJ, 노래방 또는 악기 연주와 같은 특정 버전을 요청하는 경우, 커밋하기 전에 제목/업로더/메타데이터가 해당 정확한 버전을 가리키는지 확인하십시오. - 잘못된 소스를 암시하는 후보 제목은 거부하십시오:
remix,cover,fan edit,AMV,MAD,mashup, 컴필레이션, 트레일러 믹스 또는 관련 없는 사운드트랙/OST(사용자가 명시적으로 해당 변형을 요청하지 않은 경우). - 타이인 곡 및 프로모 트랙의 경우 대화/보이스오버/SFX 혼입 가능성을 가정하십시오. 사용자에게 위험한 소스를 수락하도록 요청하기 전에
{artist} {song} 纯音乐,{song} 无对白,{song} 歌词版,official audio또는lyric video로 대안을 검색하십시오. - 다운로드 가능성을 허가로 간주하지 마십시오. 권리, 라이선스 또는 사용자 승인이 불분명한 경우 결과물에 음악을 사용하기 전에 문의하십시오.
music.download — 기존 음악을 작업 공간에 다운로드/가져오기
music.search가 후보를 식별한 후 또는 사용자가 음악 URL/로컬 파일을 직접 제공할 때 이 기능을 사용하십시오. 원시 다운로드는 sources/music/에 보관하고, music_sources.json을 저장한 후, 편집을 위해 정규화된 작업 파일을 만드십시오.
| 제공자 | 종류 | 요구사항 | 비용 | 품질 | 오프라인 |
|---|---|---|---|---|---|
yt-dlp 오디오 다운로드 | public-cli | yt-dlp + ffmpeg | 무료 | 높음 | 아니요 |
spotdl | public-cli | spotdl + ffmpeg | 무료 | Spotify 연결 메타데이터에 좋음 | 아니요 |
scdl | public-cli | scdl | 무료 | SoundCloud에 좋음 | 아니요 |
bandcamp-dl | public-cli | bandcamp-dl | 무료 | Bandcamp에 좋음 | 아니요 |
로컬 파일 가져오기 + ffmpeg | native | ffmpeg | 무료 | 높음 | 예 |
운영 참고 사항:
- 사용자가 사용할 권한이 있거나 결과물에 명확히 라이선스된 음악만 사용하십시오. DRM, 페이월 또는 액세스 제어를 우회하지 마십시오.
- 일반 오디오 URL의 경우 먼저 소스 오디오를 다운로드한 다음 명시적으로 변환하십시오:
yt-dlp -f "bestaudio[ext=m4a]/bestaudio" -o "sources/music/audio_raw.%(ext)s" "URL"
ffmpeg -i sources/music/audio_raw.m4a -vn -c:a libmp3lame -q:a 0 sources/music/audio.mp3
- Bilibili 오디오 전용 다운로드의 경우
yt-dlp -x --audio-format mp3를 사용하지 마십시오. 유효해 보이지만 거의 무음인 MP3를 생성할 수 있습니다. 원시 m4a를 다운로드하고ffmpeg로 변환한 후 볼륨을 확인하십시오:
yt-dlp -f 30280 -o "sources/music/audio_raw.%(ext)s" "BILIBILI_URL"
ffmpeg -i sources/music/audio_raw.m4a -c:a libmp3lame -q:a 0 sources/music/audio.mp3
ffmpeg -i sources/music/audio.mp3 -af volumedetect -f null - 2>&1 | grep mean_volume
평균 볼륨이 대략 -40dB 미만인 파일은 무음이 예상되지 않는 한 거부하십시오.
- 프로모/OST/타이인 곡의 경우 편집 전에 최소 세 지점에서 샘플 청취하십시오:
ffplay -ss 30 -t 5 -autoexit sources/music/audio.mp3
ffplay -ss 90 -t 5 -autoexit sources/music/audio.mp3
ffplay -ss 150 -t 5 -autoexit sources/music/audio.mp3
- 소스가 올바른 노래/버전이고 대화/SFX 혼입이 없는지 확인한 후에만 정규화 또는 라우드니스 매칭을 수행하십시오.
visual.capture — 화면 / 웹캠 / 창 녹화
| 제공자 | 종류 | 요구사항 | 비용 | 품질 | 오프라인 |
|---|---|---|---|---|---|
cli-anything-openscreen | harness-cli | 하니스 설치됨 | 무료 | 높음 | 예 |
cli-anything-obs-studio | harness-cli | OBS 설치됨 | 무료 | 높음 | 예 |
ffmpeg -f x11grab / avfoundation | native | ffmpeg | 무료 | 높음 | 예 |
screencapture | native | macOS | 무료 | 높음 | 예 |
mss / pyautogui + cv2 | python | 패키지 | 무료 | 좋음 | 예 |
visual.generate — 프롬프트/참조에서 비디오 클립 생성
| 제공자 | 종류 | 요구사항 | 비용 | 품질 | 오프라인 |
|---|
…
[번역을 위해 잘림]