비디오 생성 스킬
개요
이 스킬은 구조화된 프롬프트와 Python 스크립트를 사용하여 고품질 비디오를 생성합니다. 워크플로우에는 JSON 형식의 프롬프트 생성과 선택적 참조 이미지를 사용한 비디오 생성 실행이 포함됩니다.
핵심 기능
- AIGC 비디오 생성을 위한 구조화된 JSON 프롬프트 생성
- 비디오 가이드 또는 첫 번째/마지막 프레임으로 참조 이미지 지원
- 자동화된 Python 스크립트 실행을 통한 비디오 생성
워크플로우
1단계: 요구 사항 파악
사용자가 비디오 생성을 요청하면 다음을 식별하세요:
- 주제/내용: 비디오에 포함되어야 할 내용
- 스타일 선호: 아트 스타일, 분위기, 색상 팔레트
- 기술 사양: 종횡비, 구도, 조명
- 참조 이미지: 생성을 안내할 이미지
/mnt/user-data아래 폴더를 확인할 필요는 없습니다.
2단계: 구조화된 프롬프트 생성
/mnt/user-data/workspace/에 {설명적인-이름}.json 패턴으로 구조화된 JSON 파일을 생성합니다.
3단계: 참조 이미지 생성 (이미지 생성 스킬이 사용 가능한 경우 선택 사항)
비디오 생성을 위한 참조 이미지를 생성합니다.
- 이미지가 1개만 제공된 경우 비디오의 가이드 프레임으로 사용합니다.
3단계: 생성 실행
Python 스크립트 호출:
python /mnt/skills/public/video-generation/scripts/generate.py \
--prompt-file /mnt/user-data/workspace/prompt-file.json \
--reference-images /path/to/ref1.jpg \
--output-file /mnt/user-data/outputs/generated-video.mp4 \
--aspect-ratio 16:9
매개변수:
--prompt-file: JSON 프롬프트 파일의 절대 경로 (필수)--reference-images: 참조 이미지의 절대 경로 (선택 사항)--output-file: 출력 비디오 파일의 절대 경로 (필수)--aspect-ratio: 생성된 비디오의 종횡비 (선택 사항, 기본값: 16:9)
[!참고] Python 파일을 읽지 말고, 매개변수와 함께 직접 호출하세요.
비디오 생성 예시
사용자 요청: "'나니아 연대기: 사자, 마녀, 그리고 옷장'의 오프닝 장면을 묘사하는 짧은 비디오 클립을 생성해 주세요."
1단계: '나니아 연대기: 사자, 마녀, 그리고 옷장'의 오프닝 장면을 온라인에서 검색합니다.
2단계: 다음 내용으로 JSON 프롬프트 파일을 생성합니다:
{
"title": "나니아 연대기 - 기차역 작별",
"background": {
"description": "2차 세계대전 대피 장면, 혼잡한 런던 기차역. 증기와 연기가 공기를 가득 채우고, 아이들이 블리츠를 피해 시골로 보내지고 있습니다.",
"era": "1940년대 전시 영국",
"location": "런던 기차역 플랫폼"
},
"characters": ["페벤시 부인", "루시 페벤시"],
"camera": {
"type": "클로즈업 투샷",
"movement": "정적, 미세한 핸드헬드 움직임",
"angle": "프로필 뷰, 친밀한 프레이밍",
"focus": "두 얼굴 모두 초점, 배경은 소프트 보케"
},
"dialogue": [
{
"character": "페벤시 부인",
"text": "날 위해 용감해야 한단다, 자기야. 내가 널 데리러 올게... 약속해."
},
{
"character": "루시 페벤시",
"text": "그럴게요, 어머니. 약속해요."
}
],
"audio": [
{
"type": "기차 기적 소리 (출발 신호)",
"volume": 1
},
{
"type": "현악기가 감정적으로 고조되었다가 사라짐",
"volume": 0.5
},
{
"type": "기차역의 주변 소리",
"volume": 0.5
}
]
}
3단계: 이미지 생성 스킬을 사용하여 참조 이미지를 생성합니다.
이미지 생성 스킬을 로드하고 스킬에 따라 단일 참조 이미지 narnia-farewell-scene-01.jpg를 생성합니다.
4단계: generate.py 스크립트를 사용하여 비디오를 생성합니다.
python /mnt/skills/public/video-generation/scripts/generate.py \
--prompt-file /mnt/user-data/workspace/narnia-farewell-scene.json \
--reference-images /mnt/user-data/outputs/narnia-farewell-scene-01.jpg \
--output-file /mnt/user-data/outputs/narnia-farewell-scene-01.mp4 \
--aspect-ratio 16:9
Python 파일을 읽지 말고, 매개변수와 함께 직접 호출하세요.
출력 처리
생성 후:
- 비디오는 일반적으로
/mnt/user-data/outputs/에 저장됩니다. - 생성된 비디오(먼저)와 해당되는 경우 생성된 이미지를
present_files도구를 사용하여 사용자와 공유합니다. - 생성 결과에 대한 간략한 설명을 제공합니다.
- 조정이 필요한 경우 반복 작업을 제안합니다.
참고 사항
- 사용자 언어와 관계없이 프롬프트는 항상 영어를 사용합니다.
- JSON 형식은 구조화되고 구문 분석 가능한 프롬프트를 보장합니다.
- 참조 이미지는 생성 품질을 크게 향상시킵니다.
- 최적의 결과를 위해 반복적인 개선이 일반적입니다.
제공자 (Gemini / MiniMax)
환경 변수에 의해 자동 선택됨 (CLI 변경 없음):
GEMINI_API_KEY설정 → Gemini Veo (기본값, 변경 없음).MINIMAX_API_KEY만 설정됨 → MiniMax 비디오 (/v1/video_generation, 비동기 3단계 폴링/다운로드).VIDEO_GENERATION_PROVIDER=gemini|minimax로 강제 지정.
MiniMax 재정의: MINIMAX_API_HOST (기본값 https://api.minimaxi.com),
MINIMAX_VIDEO_MODEL (기본값 MiniMax-Hailuo-2.3). 첫 번째 참조 이미지는
MiniMax first_frame_image로 사용됩니다. MiniMax는 --aspect-ratio를 무시합니다 (해상도/지속 시간 사용).