用途:fal-music 用于通过 FAL.ai 生成音乐与音频,适合在用户提出创作、生成音乐、歌曲、音频、旋律、音轨或节拍时调用,支持文本生成音乐。
主要能力:通过单一 API 访问 Stable Audio Open、Stable Audio 2.5 和 Beatoven Maestro。stable-audio 质量良好,最长 47 秒,免费,适合循环、音效和短片段;stable-audio-25 质量优秀,最长 190 秒,约 $0.20/次,适合完整音轨与高质量输出;beatoven 质量最佳,最长 150 秒,费用不定,适合完整歌曲与作曲。
使用方式:需先配置 FAL API 密钥,与 fal-video-skill 共用同一密钥。可运行 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],支持 --model/-m、--duration/-d、--steps/-s、--guidance/-g、--creativity、--negative-prompt/-n、--seed、--output/-o、--timeout/-t 等参数。另有 models 列出模型、config 检查配置。
输出:音频默认保存到 ~/.claude/skills/fal-music-skill/output/,JSON 输出包含 status、model、file、url、duration、prompt 等字段。
提示建议:提示词可包含流派、速度、乐器、情绪,并加入 instrumental 以避免人声。
限制与要求:依赖 requests>=2.28.0;API 密钥以 600 权限存于 config.json,未配置时回退到 fal-video-skill 配置;音频下载到本地,URL 约 24 小时后过期。部分参数仅适用于特定模型,如 --guidance 仅 stable-audio-25,--creativity 与 --negative-prompt 仅 beatoven。