AI 뮤직 비디오 생성기
완전한 뮤직 비디오 제작: AI 음악 + AI 비주얼 + ffmpeg 조립
빠른 시작
"90년대 보이밴드 풍 한국어 노래 만들어줘" → 음악만
"발라드 뮤비 만들어줘" → 음악 + 슬라이드쇼 MV
"EDM 뮤비 풀영상으로" → 음악 + 비디오 클립 MV
"Suno 뮤비로 만들어줘" → Suno 네이티브 뮤직 비디오
워크플로우
1. 가사/분위기에서 장면 계획하기
생성 전에 prompts.json을 만드세요. — 노래 가사, 분위기, 스토리에서 파생된 장면 설명 배열입니다. 3분짜리 노래의 경우 8-12개의 장면이 적당합니다.
[
{"prompt": "Neon-lit city street at night, rain reflections", "type": "image"},
{"prompt": "Camera slowly panning across a rooftop at sunset", "type": "video"},
"A lone figure walking through cherry blossoms"
]
2. 음악 생성하기
bash scripts/suno_music.sh \
--prompt "가사 또는 설명" \
--style "90s boy band pop, korean" \
--title "너만을 원해" \
--model V4_5ALL --custom \
--outdir /tmp/mv_project
옵션:
--model V4_5ALL(기본값),V5,V4_5PLUS,V4_5,V4--instrumental— 보컬 없음--vocal-gender m|f— 보컬 성별 힌트--negative-tags "Heavy Metal, Drums"— 피할 스타일--music-video— Suno 네이티브 뮤직 비디오(MP4) 생성--dry-run— 비용 확인만
페르소나 (일관된 스타일 유지):
--persona-id ID— 기존 페르소나 사용 (같은 보컬/스타일로 여러 곡 생성)--create-persona— 생성된 곡에서 페르소나 생성 →persona.json저장--persona-name "이름"/--persona-desc "설명"/--persona-style "스타일"
자동 기능:
- 🎤 타임스탬프 가사: 비악기 트랙은 자동으로 가사 타임스탬프를 가져와
{outdir}/lyrics.srt에 저장 - 🎬 Suno 네이티브 MV:
--music-video사용 시 Suno가 직접 시각화된 MP4 비디오 생성 - 🎭 페르소나:
--create-persona사용 시 재사용을 위해 음성/스타일 아이덴티티 추출
3. 비주얼 생성 (커스텀 MV 플로우)
bash scripts/gen_visuals.sh \
--mode slideshow \
--prompts-file /tmp/mv_project/prompts.json \
--image-provider seedream \
--outdir /tmp/mv_project
또는 OpenAI 사용 (더 저렴, 더 낮은 해상도):
bash scripts/gen_visuals.sh \
--mode slideshow \
--prompts-file /tmp/mv_project/prompts.json \
--image-provider openai --image-model gpt-image-1-mini --image-quality medium \
--outdir /tmp/mv_project
지출 전에 비용을 확인하려면 먼저 --dry-run을 추가하세요.
4. 조립
bash scripts/assemble_mv.sh \
--audio /tmp/mv_project/track_0_xxx.mp3 \
--outdir /tmp/mv_project \
--output /tmp/mv_project/final_mv.mp4 \
--transition fade
자막 동작:
{outdir}/lyrics.srt를 자동 감지하여 가사를 자동으로 오버레이--subtitle /path/to/custom.srt— 사용자 정의 SRT 파일 사용--no-subtitle— 가사 오버레이 완전 비활성화
모드
| 모드 | 비주얼 | 최적 용도 | 비용 (10개 장면) |
|---|---|---|---|
slideshow | AI 이미지 | 빠르고 저렴함 | ~$0.02 (mini low) / ~$0.09 (mini med) / ~$0.45 (Seedream) |
video | AI 비디오 클립 | 프리미엄 | ~$1.40 (Seedance Lite) / ~$8.00 (Sora 2) |
hybrid | 혼합 | 균형 | ~$0.50-$4.00 |
suno-native | Suno MV | 가장 쉬움 | Suno 크레딧만 |
이미지 비용은 토큰 기반 — 실제 청구 금액은 나열된 예상치보다 낮을 수 있습니다. 정확한 비용은 --dry-run을 사용하세요.
제공자 옵션
이미지: --image-provider seedream (권장), openai, 또는 google-together
이미지 모델 (OpenAI): --image-model gpt-image-1-mini (기본값, 저렴) 또는 gpt-image-1 (프리미엄)
비디오: --video-provider sora (기본값), sora-pro, seedance-lite, seedance-pro, veo-fast, veo-audio
품질: --image-quality low|medium|high
비용 추적
모든 스크립트는 실행 전후에 비용을 출력합니다. 항상 먼저 --dry-run을 사용하세요.
비용 데이터는 {outdir}/cost_estimate.json 및 {outdir}/visuals_meta.json에 저장됩니다.
환경 변수
export SUNO_API_KEY="your-sunoapi-key" # 필수 — sunoapi.org
export OPENAI_API_KEY="your-openai-key" # 필수 — 이미지 + Sora 비디오
export BYTEPLUS_API_KEY="your-byteplus-key" # 선택 사항 — Seedream 4.5 (이미지에 권장)
export TOGETHER_API_KEY="your-together-key" # 선택 사항 — Seedance, Veo, Imagen
export SUNO_CALLBACK_URL="" # 선택 사항 — 아래 콜백 URL 참조
⚠️ 필수 키: 스크립트를 실행하기 전에 SUNO_API_KEY와 OPENAI_API_KEY를 설정해야 합니다.
BYTEPLUS_API_KEY는 Seedream 이미지 제공자에 필요합니다 (console.byteplus.com에 가입, 200개 무료 이미지).
TOGETHER_API_KEY는 Seedance/Veo/Imagen 제공자에만 필요합니다.
콜백 URL
Suno API는 음악 생성 요청에 callBackUrl 필드를 요구합니다.
기본적으로 SUNO_CALLBACK_URL이 설정되지 않은 경우, 스크립트는 https://localhost/noop을
무해한 no-op 엔드포인트(콜백을 효과적으로 비활성화하는 연결 불가능한 localhost URL)로 사용합니다.
사용자 정의하려면: SUNO_CALLBACK_URL을 자신의 엔드포인트로 설정하거나,
제어하는 모든 더미 URL로 설정하세요. 콜백 페이로드에는 작업 메타데이터와
오디오 URL이 포함됩니다. — API 키는 전송되지 않습니다.
비활성화하려면: SUNO_CALLBACK_URL=https://localhost/noop 또는 연결 불가능한 URL로 설정하세요.
폴링을 통해 생성은 계속 작동합니다. 스크립트 기능에 콜백은 필수가 아닙니다.
페르소나 워크플로우 (채널 컨셉 유지)
YouTube 채널처럼 일관된 스타일로 여러 곡을 만들 때:
# 1. 첫 곡 생성 + 페르소나 만들기
bash scripts/suno_music.sh \
--prompt "코드 리뷰하며 듣는 노래" \
--style "indie rock, energetic, coding vibe" \
--title "Pull Request" \
--custom --create-persona \
--persona-name "개발자 노동요 싱어" \
--persona-desc "개발자가 코딩하며 듣기 좋은 에너지 넘치는 보컬. 인디록, 일렉, 팝 장르를 넘나든다." \
--persona-style "indie rock, electronic, developer work music" \
--outdir /tmp/dev-bgm-01
# 2. persona.json에서 personaId 확인
cat /tmp/dev-bgm-01/persona.json
# 3. 같은 페르소나로 다음 곡 생성 — 보컬/스타일 일관성 유지
bash scripts/suno_music.sh \
--prompt "야근하면서 듣는 노래" \
--style "electronic pop, night coding" \
--title "Midnight Deploy" \
--custom --persona-id <PERSONA_ID> \
--outdir /tmp/dev-bgm-02
페르소나는 보컬 특성 + 음악 스타일을 기억해서, 채널 전체의 통일감을 유지해줌.
필수 조건
curl,python3,ffmpeg(조립용)
참고 자료
- SunoAPI 세부 정보:
references/sunoapi.md읽기 - 비주얼 제공자 세부 정보:
references/visual-providers.md읽기