비디오 생성 스킬
AI(Google Veo 3.1, OpenAI Sora)를 사용하여 동영상을 생성합니다.
기능:
- 🎬 텍스트를 동영상으로: 텍스트 설명으로 동영상 생성
- 🖼️ 이미지를 동영상으로: 이미지를 첫 번째 프레임으로 애니메이션화
- 🔊 오디오 생성: 대화, 음향 효과, 주변 음향 (Veo 3+)
- 🎭 참조 이미지: 최대 3개의 참조 이미지로 동영상 콘텐츠 가이드 (Veo 3.1)
전제 조건
기본값: Vertex AI (분당 10회 요청) ⭐
Vertex AI는 1400배 더 높은 속도 제한을 제공하는 기본 백엔드입니다:
# 1. 프로젝트 설정
export GOOGLE_CLOUD_PROJECT=your-project-id
# 2. 인증 (브라우저 열림)
gcloud auth application-default login
# 3. API 활성화 (일회성)
gcloud services enable aiplatform.googleapis.com
.env 파일에 추가:
GOOGLE_CLOUD_PROJECT=your-project-id
GOOGLE_CLOUD_LOCATION=us-central1
대체: AI Studio (일일 10회 요청)
GCP 프로젝트가 없는 경우에만 사용하세요:
GOOGLE_API_KEY- https://aistudio.google.com/apikey 에서 획득
Sora (OpenAI)용
OPENAI_API_KEY- OpenAI Sora용
사용 가능한 모델
Google Veo 모델
| 모델 | 설명 | 최적 사용 |
|---|---|---|
veo-3.1 | 최고 품질 (기본값) | 전문 동영상, 대화, 참조 이미지 |
veo-3.1-fast | 더 빠른 처리 | 빠른 반복, 일괄 생성 |
두 모델 모두 포함:
- 720p/1080p 해상도
- 4, 6, 또는 8초 길이
- 네이티브 오디오 (대화, SFX, 주변음)
- 이미지-투-비디오 (이미지 애니메이션)
- 참조 이미지 (최대 3개)
- 동영상 확장
- 배치/병렬 생성
OpenAI Sora
- 최적 사용: 창의적인 동영상, 영화 같은 품질, 복잡한 움직임
- 해상도: 480p, 720p, 1080p
- 길이: 5초, 10초, 15초, 20초
- 기능: 텍스트-투-비디오, 이미지-투-비디오
워크플로우
1단계: 요구사항 수집 (필수)
⚠️ 인터랙티브 질문 사용 — 한 번에 하나의 질문만 하세요.
질문 흐름
⚠️ 아래 각 질문에 AskUserQuestion 도구를 사용하세요. 응답에 질문을 그냥 출력하지 말고, 표시된 옵션과 함께 인터랙티브 프롬프트를 생성하는 도구를 사용하세요.
Q1: 이미지
"해당 동영상을 생성해 드리겠습니다! 먼저 — 애니메이션으로 만들 이미지가 있나요?
- 예 (경로 제공 — 첫 번째 프레임으로 사용)
- 아니요, 새로 생성"
응답 대기.
Q2: 오디오
"어떤 오디오 설정을 원하시나요?
- 오디오 포함 (기본값) — Veo 3.1이 대화, SFX, 주변음 생성
- 무음 동영상 — 오디오 없음"
응답 대기.
Q3: 모델
"어떤 모델을 사용하시겠습니까?
veo-3.1— 최신, 최고 품질 및 오디오 (기본값)veo-3.1-fast— 오디오 지원 빠른 처리veo-3/veo-3-fast— 오디오 지원 이전 세대sora— OpenAI, 최대 20초, 오디오 없음"
응답 대기.
Q4: 길이
"길이는 어떻게 할까요?
- 4초
- 6초
- 8초 (기본값)"
응답 대기.
Q5: 형식
"화면비와 해상도는 어떻게 할까요?
- 16:9 가로, 720p
- 16:9 가로, 1080p
- 9:16 세로, 720p
- 9:16 세로, 1080p
- 또는 직접 지정"
응답 대기.
빠른 참조
| 질문 | 결정 |
|---|---|
| 이미지 | 이미지-투-비디오 vs 텍스트-투-비디오 |
| 오디오 | 오디오 생성 포함/제외 |
| 모델 | 품질과 속도 간 트레이드오프 |
| 길이 | 클립 길이 |
| 형식 | 화면비 및 해상도 |
2단계: 프롬프트 작성
사용자 요청을 효과적인 동영상 프롬프트로 변환:
- 장면 설명: 시각적 맥락 설정
- 동작 지정: 무엇이 움직이고, 변화하고, 발생하는지
- 카메라 워크 포함: "슬로우 팬", "트래킹 샷", "돌리 샷"
- 오디오 단서 추가 (Veo 3+): 대화에는 따옴표 사용, 소리 설명
- 분위기 설정: 조명, 분위기, 시간대
대화 예시 (Veo 3.1):
- 사용자: "보물을 발견하는 사람"
- 향상됨: "횃불 불빛이 깜빡이는 가운데 보물 사냥꾼의 얼굴 클로즈업. 그는 고대 상자에서 먼지를 털어내며 '여기 있을 거야...'라고 중얼거립니다. 삐걱거리는 경첩 소리와 함께 상자를 열자, 경외감에 찬 얼굴에 황금빛이 비칩니다. 영화적이고, 극적인 그림자."
대화 없는 예시:
- 사용자: "해변에서 달리는 개"
- 향상됨: "노을이 지는 해변을 따라 기쁘게 달리는 골든 리트리버의 영화적 슬로우 모션 샷, 잔잔한 파도, 따뜻한 황금 시간 조명, 얕은 심도"
3단계: 모델 선택
기본값: veo-3.1 (최고 품질, 오디오 포함)
| 사용 사례 | 권장 모델 | 이유 |
|---|---|---|
| 최고 품질 | veo-3.1 (기본값) | 최고 품질, 오디오 |
| 빠른 반복 | veo-3.1-fast | 더 빠른 처리 |
| 배치 생성 | veo-3.1-fast | 여러 클립에 속도 중요 |
| 긴 동영상(>8초) | sora | 최대 20초 지원 |
4단계: 동영상 생성
${CLAUDE_PLUGIN_ROOT}/skills/video-generation/scripts/ 에서 적절한 스크립트 실행:
Google Veo 3.1 (기본값, 오디오 포함):
python3 ${CLAUDE_PLUGIN_ROOT}/skills/video-generation/scripts/veo.py \
--prompt "따옴표 안에 '대화'가 포함된 향상된 프롬프트" \
--model "veo-3.1" \
--duration 8 \
--aspect-ratio "16:9" \
--resolution "720p"
이미지 입력이 포함된 Google Veo 3.1:
python3 ${CLAUDE_PLUGIN_ROOT}/skills/video-generation/scripts/veo.py \
--prompt "고양이가 천천히 눈을 뜨고 하품을 한다" \
--image "/path/to/cat.jpg" \
--model "veo-3.1" \
--duration 8
더 빠른 생성:
python3 ${CLAUDE_PLUGIN_ROOT}/skills/video-generation/scripts/veo.py \
--prompt "your prompt" \
--model "veo-3.1-fast"
OpenAI Sora (더 긴 동영상):
python3 ${CLAUDE_PLUGIN_ROOT}/skills/video-generation/scripts/sora.py \
--prompt "향상된 프롬프트" \
--duration 20 \
--resolution "1080p"
사용 가능한 모델 목록:
python3 ${CLAUDE_PLUGIN_ROOT}/skills/video-generation/scripts/veo.py --list-models
동영상 확장 (긴 형식 연속성)
--extend 플래그는 진정한 시각적 연속성을 생성하여 이전 Veo 동영상이 끝난 지점부터 계속됩니다. 긴 형식의 동영상에 가장 적합한 방법입니다.
기본 확장:
# 먼저 초기 클립 생성
python3 ${CLAUDE_PLUGIN_ROOT}/skills/video-generation/scripts/veo.py \
--prompt "일출에 숲속을 걷는 사람" \
--duration 8
# 새 콘텐츠로 확장 (약 7초 추가)
python3 ${CLAUDE_PLUGIN_ROOT}/skills/video-generation/scripts/veo.py \
--extend veo_veo-3.1_20260104_120000.mp4 \
--prompt "계속 걸으며 숨겨진 개울을 발견한다"
여러 번 확장 (더 긴 동영상):
# 5회 확장 (약 35초 연속 추가)
python3 ${CLAUDE_PLUGIN_ROOT}/skills/video-generation/scripts/veo.py \
--extend initial_clip.mp4 \
--prompt "계속 숲을 탐험하며 야생 동물과 마주친다" \
--extend-times 5
확장 vs 이어붙이기:
| 방식 | 결과 | 사용 사례 |
|---|---|---|
| 확장 | 진정한 연속성, 동일 캐릭터/장면 | 긴 연속 샷 |
| 이어붙이기 | 전환이 있는 별도 클립 | 장면 변경, 몽타주 |
확장 제한:
- 입력 동영상은 Veo로 생성되어야 함 (최대 141초)
- 각 확장은 약 7초 추가
- 최대 20회 확장 가능 (약 2.5분)
- 출력 해상도는 720p
배치 생성 (병렬)
여러 동영상을 동시에 생성하여 다중 장면 워크플로우를 더 빠르게 처리합니다. 5개의 순차 동영상 생성에 15분 이상 기다리는 대신 모두 병렬로 생성할 수 있습니다 (총 약 3분).
scenes.json 파일 생성:
[
{"prompt": "장면 1: 어두운 표면의 무선 이어버드 영화적 히어로 샷", "duration": 6, "output": "scene1_hero.mp4"},
{"prompt": "장면 2: 음파 시각화, 음악을 즐기는 사람", "duration": 8, "output": "scene2_sound.mp4"},
{"prompt": "장면 3: 귀에 꽂힌 이어버드 클로즈업, 운동하는 사람", "duration": 8, "output": "scene3_comfort.mp4"},
{"prompt": "장면 4: 라이프스타일 몽타주, 다양한 설정", "duration": 8, "output": "scene4_lifestyle.mp4"},
{"prompt": "장면 5: 깨끗한 배경에 로고가 있는 제품", "duration": 4, "output": "scene5_cta.mp4"}
]
모든 장면을 병렬로 생성:
python3 ${CLAUDE_PLUGIN_ROOT}/skills/video-generation/scripts/veo.py \
--batch scenes.json
사용자 정의 작업자 수 사용:
python3 ${CLAUDE_PLUGIN_ROOT}/skills/video-generation/scripts/veo.py \
--batch scenes.json \
--max-workers 3
동영상별 배치 구성 옵션:
| 옵션 | 설명 | 기본값 |
|---|---|---|
prompt | 동영상 설명 (필수) | - |
model | veo-3.1, veo-3.1-fast 등 | veo-3.1 |
duration | 4, 6 또는 8초 | 8 |
aspect_ratio | "16:9" 또는 "9:16" | "16:9" |
resolution | "720p" 또는 "1080p" | "720p" |
image | 이미지-투-비디오용 이미지 경로 | - |
negative_prompt | 피해야 할 사항 | - |
output | 사용자 정의 출력 파일 이름 | 자동 생성 |
속도 비교:
| 장면 수 | 순차 | 병렬 (5개 작업자) | 속도 향상 |
|---|---|---|---|
| 3 | ~9분 | ~3분 | 3배 |
| 5 | ~15분 | ~3분 | 5배 |
| 10 | ~30분 | ~6분 | 5배 |
5단계: 결과 전달
- 생성된 동영상 파일/URL 제공
- 사용된 향상된 프롬프트 공유
- 생성 설정(길이, 해상도) 언급
- 다음 제안:
- 변형 생성
- 다른 스타일/길이 시도
- 다른 API 사용
- 동영상 확장
오류 처리
API 키 누락: 필요한 키가 무엇인지 사용자에게 알림:
콘텐츠 정책 위반: 프롬프트를 적절히 수정.
생성 실패: 단순화된 프롬프트나 다른 API로 재시도.
할당량 초과: 기다리거나 다른 공급자를 시도할 것을 제안.
프롬프트 엔지니어링 팁
오디오 (Veo 3.1)용
- 대화: 말할 때 따옴표 사용:
"안녕!" 그녀가 신나서 말했다 - 음향 효과: 명시적으로 설명:
타이어 끽끽 소리, 엔진 굉음 - 주변음: 사운드스케이프 설명:
새 지저귐, 먼 교통 소음 - 예시:
어두운 복도에서 발자국 소리가 울려 퍼지는 가운데 한 남자가 "방금 그 소리 들었어?"라고 속삭인다
영화적 품질을 위해
- 카메라 방향 포함: "슬로우 돌리", "트래킹 샷", "크레인 샷"
- 조명 지정: "골든 아워", "극적인 그림자", "부드러운 확산광"
- 영화 참조 추가: "블레이드 러너 스타일", "웨스 앤더슨 미학"
사실적인 움직임을 위해
- 물리 법칙 설명: "자연스러운 움직임", "사실적인 물리"
- 환경적 세부 사항 포함: "머리카락에 바람", "바스락거리는 나뭇잎"
- 속도 지정: "슬로우 모션", "실시간", "타임랩스"
이미지-투-비디오용
- 시작 이미지에서 무엇이 변경/이동해야 하는지 설명
- 동작 구체적으로 지정: "고양이가 천천히 눈을 뜬다"
- 환경적 움직임 포함: "나뭇잎이 스쳐 지나간다"
부정적 프롬프트
- 포함하지 말아야 할 것을 설명:
--negative-prompt "cartoon, low quality, blurry" - "no"나 "don't"를 사용하지 말고 원치 않는 요소만 설명
API 비교
| 기능 | Veo 3.1 (기본값) | Veo 3.1 Fast | Sora |
|---|---|---|---|
| 공급자 | OpenAI | ||
| API 키 | GOOGLE_API_KEY | GOOGLE_API_KEY | OPENAI_API_KEY |
| 최대 길이 | 8초 | 8초 | 20초 |
| 해상도 | 720p, 1080p | 720p, 1080p | 최대 1080p |
| 화면비 | 16:9, 9:16 | 16:9, 9:16 | 16:9, 9:16, 1:1 |
| 오디오 (대화, SFX) | ✅ 예 | ✅ 예 | ❌ 아니요 |
| 이미지-투-비디오 | ✅ 예 | ✅ 예 | ✅ 예 |
| 참조 이미지 | ✅ 최대 3개 | ✅ 최대 3개 | ❌ 아니요 |
| 동영상 확장 | ✅ 예 | ✅ 예 | ❌ 아니요 |
| 배치 생성 | ✅ 예 | ✅ 예 | ❌ 아니요 |
| 속도 | 최고 품질 | ~2배 빠름 | 느림 |
| 최적 사용 | 전문가용 | 배치 작업 | 긴 동영상 |