mcpField
F
fal-music

fal-music

github.com/idanbeckクリエイティブ・メディア1442 回インストール2 日前に更新
リポジトリ

fal-music について

fal-musicは、FAL.aiのモデルで音楽を生成するコマンドラインスキルです。Stable Audio Open、Stable Audio 2.5、Beatoven Maestroを選べ、生成した音声をローカルに保存できます。

主な機能

  1. 01プロンプトから音楽を生成
  2. 023種類のFAL.aiモデルを選択
  3. 03長さ、ガイダンス、創造性を設定
  4. 04ネガティブプロンプトとシードを指定
  5. 05生成した音声をローカルに保存

活用シーン

  1. 01短い音楽ループや効果音の作成
  2. 02ジャンルとムードを指定した楽曲生成
  3. 03長さを指定したアンビエントや電子音楽の制作

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/idanbeck/claude-skills --skill fal-music

インストール後、Claude Code で/fal-musicを入力して読み込まれたか確認します。

同梱ファイルfal_music_skill.py

詳細

FAL Music - AI 音楽生成

FAL.ai を使用して音楽を生成します。Stable Audio Open、Stable Audio 2.5、Beatoven Maestro に単一の API でアクセスできます。

セットアップ

fal-video-skill と同じ FAL API キーを使用します。まだ設定していない場合：

python3 ~/.claude/skills/fal-music-skill/fal_music_skill.py config YOUR_API_KEY

または、環境変数を設定します：

export FAL_KEY="your_api_key"

コマンド

音楽を生成
python3 ~/.claude/skills/fal-music-skill/fal_music_skill.py generate "your prompt" [OPTIONS]

引数：

  • PROMPT - 音楽の説明（例：「躍動感のあるベースとアルペジオのシンセを使ったダークなシンセウェーブ」）
  • --model, -m - 使用するモデル（デフォルト：stable-audio-25）
  • --duration, -d - 長さ（秒）（デフォルト：60）
  • --steps, -s - 推論／リファインメントのステップ数
  • --guidance, -g - ガイダンススケール（stable-audio-25 のみ）
  • --creativity - 創造性のレベル 1～20（beatoven のみ）
  • --negative-prompt, -n - 避ける内容（beatoven のみ）
  • --seed - 再現性のための乱数シード
  • --output, -o - 出力ファイルのパス
  • --timeout, -t - タイムアウト時間（秒）（デフォルト：300）

例：

# Synthwave track
python3 fal_music_skill.py generate "dark synthwave instrumental, driving bassline, analog arpeggios, 120 BPM" -d 90

# Ambient music with Beatoven
python3 fal_music_skill.py generate "ambient electronic, atmospheric pads, gentle evolving textures" -m beatoven -d 120

# Short loop with Stable Audio Open
python3 fal_music_skill.py generate "128 BPM techno drum loop with acid bass" -m stable-audio -d 30

# Custom output path
python3 fal_music_skill.py generate "epic orchestral trailer music" -o ~/music/trailer.wav
モデル一覧
python3 ~/.claude/skills/fal-music-skill/fal_music_skill.py models
設定を確認
python3 ~/.claude/skills/fal-music-skill/fal_music_skill.py config

利用可能なモデル

モデル品質最大長さ費用最適な用途
stable-audio良好47s無料ループ、効果音、短いクリップ
stable-audio-25最高190s約$0.20/生成フルトラック、高品質
beatoven最高150s変動フル楽曲、作曲

出力

音声ファイルはデフォルトで ~/.claude/skills/fal-music-skill/output/ に保存されます。

JSON 出力には以下が含まれます：

{
  "status": "success",
  "model": "stable-audio-25",
  "file": "/path/to/audio.wav",
  "url": "https://fal.media/...",
  "duration": 60,
  "prompt": "..."
}

プロンプトのヒント

音楽生成に適したプロンプト：

  • ジャンルを含めます：「シンセウェーブ」、「アンビエント」、「テクノ」、「オーケストラ」
  • テンポを指定します：「120 BPM」、「スローテンポ」、「躍動感のあるリズム」
  • 楽器に言及します：「アナログシンセ」、「エレキギター」、「ピアノ」
  • ムードを説明します：「ダーク」、「高揚感のある」、「メランコリック」、「エネルギッシュ」
  • ボーカルを避けるには「インストゥルメンタル」を追加します

必要条件

requests>=2.28.0

セキュリティに関する注意

  • API キーは権限 600 で config.json に保存されます
  • 独自の設定がない場合は、fal-video-skill の設定にフォールバックします
  • 音声ファイルはローカルにダウンロードされ、URL は約24時間後に期限切れになります

#music #ai #fal #audio #generation

コメント

Markdown 対応