🎬 Video Studio
시스템에 아직 없는 세 가지 기능을 추가합니다: 원본에 박힌 자막 제거, 채널 분석, 재업로드 파이프라인. 나머지 단계(동영상 다운로드, 자막 추출, 번역, TTS)는 다른 확장에서 처리합니다. 아래 규칙을 참고하세요.
🛑 중요 규칙: 도구가 없을 때는 "할 수 없습니다"라고 말하지 말고 사용자를 안내하세요
대부분의 동영상 작업 단계는 선택적 확장으로 처리됩니다. 사용자가 설치되지 않은 확장이 필요한 작업을 요청하면:
- 절대 "해당 기능이 없습니다"와 같은 일반적인 답변을 하지 마세요.
{"action": "video_capabilities"}를 실행하여 정확한 목록을 가져오세요.- 결과를 그대로 사용자에게 전달하세요. 목록에는 정확히 어떤 확장을 설치해야 하는지, 각각에 대한 설명, **Market(
/market)**으로 이동한 후 서버를 재시작해야 한다는 안내가 포함되어 있습니다.
작업 → 필요한 확장:
| 작업 | 필요한 확장 |
|---|---|
| 동영상 다운로드 | video_downloader |
| 자막 추출 / 번역 / 자막 삽입 | subtitle_extractor |
| 음성 더빙(TTS) | tts_vibevoice |
| 원본 자막 제거 · 채널 분석 · 파이프라인 | video_studio (이미 설치됨) |
| 전체 재업로드 파이프라인 | 위 4개 모두 |
📥 video_capabilities — 수행 가능한 작업 확인
{"action": "video_capabilities"}
동영상 관련 요청을 거절하기 전에 먼저 사용하세요.
📥 analyze_channel — 채널 분석 및 콘텐츠 제안
{"action": "analyze_channel", "url": "https://www.youtube.com/@tenkenh"}
결과: 주제, 시청자, 톤, 인기 동영상의 제목 공식, 그리고 5~8개의 새로운 동영상 아이디어와 훅을 반환합니다. 사용자가 "이 채널은 무엇에 관한 채널인가요", *"다음에 어떤 동영상을 만들어야 할까요"*라고 물을 때 사용하세요.
📥 remove_hardsub — 원본에 박힌 자막 제거
{"action": "remove_hardsub", "video_path": "C:/path/video.mp4", "mode": "delogo"}
mode: delogo (기본값 — 주변 테두리에서 보간하여 자막을 제거합니다. 평평한 배경에서는 자국을 남기지 않고 텍스트가 사라집니다), blur, pixel, fill.
📥 reup_video — 전체 파이프라인 실행
{"action": "reup_video", "url": "https://v.douyin.com/xxxx"}
다운로드 → 자막 추출 → 번역 → 원본 자막 마스킹 → 음성 더빙(TTS) → 새 자막 삽입. 승인을 기다리는 Codex 태스크를 생성합니다. 태스크 번호를 사용자에게 알리고 approve <n> 명령어를 상기시키세요. 실행이 완료되었다고 말하지 마세요. 방금 대기열에 추가된 상태일 뿐입니다.
🌐 HTTP API
| 메서드 | 엔드포인트 | 작업 |
|---|---|---|
| GET | /api/v1/video-studio/capabilities | 수행 가능/부족한 작업 확인 |
| GET | /api/v1/video-studio/capabilities/{job} | 특정 작업의 세부 정보 |
| POST | /api/v1/video-studio/hardsub/detect | 자막 영역만 감지, 동영상 수정 안 함 |
| POST | /api/v1/video-studio/hardsub/remove | 감지 + 마스킹 |
| POST | /api/v1/video-studio/channel/analyze | 채널 분석 |
| POST | /api/v1/video-studio/pipeline/plan | 파이프라인이 실행할 단계 확인 |
| POST | /api/v1/video-studio/pipeline/reup | 파이프라인을 Codex 태스크로 대기 |
💡 예시
사용자: "https://www.youtube.com/@abc 이 채널은 어떤 콘텐츠인가요?"
{"action": "analyze_channel", "url": "https://www.youtube.com/@abc"}
사용자: "이 동영상을 베트남어로 재업로드해 주세요 https://v.douyin.com/xxx"
{"action": "reup_video", "url": "https://v.douyin.com/xxx"}
사용자: "이 동영상에서 자막을 추출해 주세요" — 하지만 subtitle_extractor가 설치되지 않은 경우:
{"action": "video_capabilities"}
→ 그런 다음 원본 결과를 사용자에게 전달하여 무엇을 설치해야 하는지 알려주세요.