AI音楽ビデオジェネレーター
完全な音楽ビデオを作成:AI音楽 + AIビジュアル + ffmpegアセンブリ。
クイックスタート
"90年代ボーイズバンド風の韓国語の曲を作って" → 音楽のみ
"バラードのMVを作って" → 音楽 + スライドショーMV
"EDMのMVをフル映像で" → 音楽 + ビデオクリップMV
"SunoのMVで作って" → Sunoネイティブ音楽ビデオ
ワークフロー
1. 歌詞/ムードからシーンを計画
生成前に、prompts.jsonを作成します。これは、曲の歌詞、ムード、ナラティブから導き出されたシーン説明の配列です。3分の曲で8〜12シーン。
[
{"prompt": "ネオンに照らされた夜の都市の街並み、雨の反射", "type": "image"},
{"prompt": "夕日の中、屋上をゆっくりとパンするカメラ", "type": "video"},
"桜の中を歩く一人の人影"
]
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を使用すると、再利用のためのボイス/スタイルIDを抽出
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 を
無害なノーオペレーションエンドポイントとして使用します(到達不能な 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 "開発者作業用BGMシンガー" \
--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を参照