用途:该技能用于调用 Suno AI 的音乐生成 API,在用户需要创作、生成歌曲、音频、旋律、音轨或节拍时生成音乐。
主要能力:支持根据描述生成音乐,也支持将提示词作为自定义歌词;可指定风格与人声标签、歌曲标题;可生成纯器乐;默认每次生成两首变体;可附加输出目录与模型选项。
使用方式:先一次性完成配置,登录 suno.ai,打开浏览器开发者工具(F12)的 Console,运行 document.cookie,找到 __session=eyJ... 形式的 JWT 令牌,并导出为环境变量:export SUNO_COOKIE="__session=eyJ..."。然后运行脚本:python3 ~/.claude/skills/suno-music/generate_music.py "your prompt here" [options]。可用选项包括 --custom(将提示词视为歌词)、--tags(风格或人声标签)、--title(标题)、--instrumental(纯器乐)、--output(输出目录,默认 ./generated_music)、--model(模型键)。查询剩余积分可使用 --credits。输出文件命名格式为 {timestamp}{sanitized_title}{n}.mp3,例如 20260106_morning_light_1.mp3。
适用场景:适合需要快速生成歌曲、歌词配乐或背景器乐的创作场景。
限制:__session 令牌约 1 小时后过期,需定期刷新。免费额度为每日 50 积分,每次生成消耗 10 积分(每首 5 积分乘以 2 个变体),即免费层每日约可生成 5 首。模型 chirp-auk-turbo 为最佳免费默认模型;chirp-crow(v5,测试版)、chirp-bluejay(v4.5+)、chirp-v4 均为 Pro 专用。需 Python 3.x 与 requests 库,并配置 SUNO_COOKIE。常见错误:401 表示令牌过期,需重新获取;402 表示积分不足,需等待每日刷新或升级。其他收费与价格信息暂未提供。