/video — 로컬 AI 영상 클립
도구: content-studio MCP → generate_video, generate_image, mux_audio,
free_memory, job_status.
1. 질문 — 옵션이 있는 한 번의 호출
AskUserQuestion(Claude Code) / question(OpenCode) 사용; 그 외에는 번호 목록을 사용합니다.
이미 사용자가 말한 내용은 건너뜁니다.
| 질문 | 옵션 |
|---|---|
| 모델 | 빠름 — MiniMax-H3 4비트 (41 GB, quality:"fast") · 최고 — MiniMax-H3 8비트 (70 GB, quality:"quality") |
| 화면 비율 | 세로 릴 512×896 · 가로 896×512 · 정사각형 640×640 |
| 길이 | ~2 초 (49 프레임) · ~4 초 (97 프레임) · ~8 초 (193 프레임) |
| 시작점 | 텍스트만 · 정지 이미지를 먼저 생성한 후 애니메이션화 · 내 이미지 (경로를 물어봄) |
클립에는 자체 생성된 사운드트랙이 포함됩니다. 모델은 프레임 수를 올림 처리합니다 (49 → 56 프레임 ≈ 24fps에서 약 2.3 초). 작은 512×896 클립은 빠른 모델에서 약 2분이 소요됩니다.
세로 프레임은 사람과 거리 장면에 적합하지만, 넓은 수평 장면(바다, 풍경)은 512×896에서 가끔 옆으로 나올 수 있습니다. 이런 경우 가로를 사용하거나 클립을 사용하기 전에 프레임을 확인하세요.
2. 준비
- "정지 이미지 먼저 생성":
generate_image실행 (품질 사전 설정, 동일한 화면 비율) 후 그 경로를first_frame_image로 전달합니다. - 8비트 모델 전에
free_memory()를 호출하세요 — 약 70 GB가 필요합니다. - 샷 스타일 프롬프트를 작성하세요: 피사체 + 동작, 카메라 움직임 (돌리, 궤도, 핸드헬드, 슬로우 푸시인), 조명, 분위기. 클립당 하나의 샷.
3. 생성
generate_video(prompt, quality, width, height, num_frames, first_frame_image) →
job_status(job_id, wait_seconds=40)가 완료될 때까지 폴링합니다.
여러 샷으로 구성된 작품의 경우 각 샷을 자체 클립으로 생성한 후 /reel(HyperFrames 편집)로 넘겨 음악과 자막과 함께 잘라서 연결합니다.
4. 전달
MP4 경로 (~/ai/content-studio/outputs/video/ 아래), 지속 시간 및 크기를 제공합니다.
제안: 다른 테이크(새 시드), 음악 추가 (/song 후 mux_audio), 또는 릴 제작.
긴 작업
도구 호출은 약 45초 내에 반환됩니다 (MCP 클라이언트는 60초에서 타임아웃). 결과에 status: "running"이 표시되면 job_status(job_id)를 계속 호출하세요 — 각 호출은 최대 40초 동안 대기합니다 — 그리고 호출 사이에 사용자에게 진행 라인을 알려주세요. 채팅이나 MCP 서버가 다시 시작되어도 작업은 계속 실행됩니다. list_jobs()로 다시 찾을 수 있습니다.