音楽カンテン動画(ビートシンクミックス)
librosaで音楽のビートを検出し、映像をビートポイントでハードカット。ビートに合わせたエフェクトを加え、盛り上がる「カンテン」系ショート動画を作成します。 すべてskills/shared/scripts/beatsync.pyを使用します。ビートを手動で数えたり、フィルターを手動で組み合わせる必要はありません。 スクリプトがビート検出、区間分割、素材のループ、音画同期を自動で実行します。
各画像を固定長で表示し、ソフトなトランジションを使った動画は slideshow-video を参照してください。テーマからAIが画像・音声を生成して動画を作成する場合は auto-short-video を参照してください。
入力
| フィールド | 必須 | 説明 |
|---|---|---|
| 背景音楽 | はい | カンテンの基準となる音楽ファイル(リズムが強いほど効果的。指定がない場合は質問する) |
| 素材 | はい | 画像やショートクリップのリスト(順に使用、ループあり)、またはディレクトリ |
| 画面サイズ | はい | ユーザーまたは上位タスクが横長・縦長(または具体的な解像度)を明確にしていない場合、作成前に必ず確認を取ってから進める。プラットフォームやプロファイル、デフォルト値で黙って推測しない。既に明確になっている場合は再度尋ねない |
| 切り替え頻度 | いいえ | 何ビートごとに切り替えるか(デフォルトは2ビートごと) |
| エフェクト | いいえ | zoom ズーム(デフォルト) / flash ホワイトフラッシュ / none なし |
出力(outputs/テーマ名/)
- カンテン完成動画(
*.mp4) - レポート:カンテンセグメント数、総再生時間、検出されたBPM、エフェクト
実行手順
スクリプトのパス(プロジェクトルートからの相対パス):skills/shared/scripts/beatsync.py(build -h / beats -h)。
1.(オプション)まずビートを確認する
python skills/shared/scripts/beatsync.py beats --music <音楽>
# テンポ(BPM)とビートのタイムポイントを表示。--every に設定する値の判断に使用する
2. カンテン動画を生成する
python skills/shared/scripts/beatsync.py build \
-i 1.jpg 2.jpg 3.jpg 4.jpg --music <音楽> \
-o outputs/テーマ名/show.mp4 \
--size 1080x1920 --every 2 --effect zoom
- 素材 = 画像またはショートクリップ。カンテンセグメント数より少なくてもよい(自動ループで再利用)。
--every 1はすべてのビートで切り替え(動きが速く、多くの素材が必要)。--every 4は小節ごとに切り替え(落ち着いた印象)。--effect flashはセグメント先頭にホワイトフラッシュを加え、より「燃える」印象に。--effect noneはシンプルなハードカット。--max-duration 15で動画の長さを制限(例:15秒のTikTok用)。- 代わりに
--images-dir <ディレクトリ>で素材を一括指定することも可能(ファイル名でソート)。
プロファイル認識
- プロファイルあり:
platforms.mdは画面サイズの提案にのみ使用し、必ずユーザーの確認を取ること。カンテンのスタイル(高速/落ち着き)とエフェクトはアカウントの雰囲気に合わせる (トレンド/スポーツ系アカウントは高速でflash、ライフスタイル/癒し系アカウントはzoomで落ち着き)。 - プロファイルなし:まず横長/縦長を確認。デフォルトは2ビートごと、zoomエフェクト。
ルール
- 音楽のリズムがはっきりしているほどカンテンが正確になる。明確なビートがない場合、スクリプトは自動的に等間隔切り替えにフォールバックし、レポートでその旨を説明する。
- カンテンはハードカット(トランジションなし)を使用。そうしないとビート感がぼやける——これは意図的な設計。
- 素材が足りない場合は自動ループ。素材が十分にある場合は、
--every 1~2を推奨し、各セグメントで新しい映像を表示する。 - 完成動画はデフォルトで音楽と同じ長さ。
--max-durationでプラットフォームの制限に合わせる。 - 成果物はすべて
outputs/テーマ名/に格納する。
参考ソース
ビート検出には librosa の beat_track(オンセット強度+動的計画法でビートを求める)を使用。映像をビートポイントでハードカットするのは、カンテンミックスの標準的な手法。ビート→区間→セグメント単位のレンダリング→音画同期を、確定的なスクリプトにカプセル化することで、手動でのビート数えやずれを防ぐ。