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. 02选择三种 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 生成音乐——通过单个 API 访问 Stable Audio Open、Stable Audio 2.5 和 Beatoven Maestro。

设置

使用与 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 - 音乐描述（例如：“dark synthwave with driving bass and arpeggiated synths”）
  • --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良好47 秒免费循环音频、SFX、短片段
stable-audio-25卓越190 秒约 $0.20/次生成完整曲目、高质量音频
beatoven最佳150 秒不固定完整歌曲、乐曲创作

输出

音频文件默认保存到 ~/.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": "..."
}

提示词建议

适用于音乐生成的优质提示词：

  • 包含流派：“synthwave”“ambient”“techno”“orchestral”
  • 指定节奏：“120 BPM”“slow tempo”“driving rhythm”
  • 提及乐器：“analog synths”“electric guitar”“piano”
  • 描述情绪：“dark”“uplifting”“melancholic”“energetic”
  • 添加“instrumental”以避免人声

要求

requests>=2.28.0

安全说明

  • API 密钥存储在 config.json 中，权限为 600
  • 如果未设置自身配置，则回退使用 fal-video-skill 的配置
  • 音频文件会下载到本地，URL 约 24 小时后过期

#music #ai #fal #audio #generation

评论

支持 Markdown