SuperAPI AI 工具集

byted-music-generate

编程与开发

查看项目

更新于 10-15 18:46

技能介绍

用途:该技能通过火山引擎音乐生成 API 创作音乐,支持三种模式:带人声歌曲(song)、纯器乐背景音乐(bgm)和 AI 歌词生成(lyrics)。用户想要生成歌曲、背景音乐、伴奏或歌词时可用。

主要能力:song 模式可用文本提示或歌词生成带人声的歌曲,支持流派、情绪、演唱性别、音色、时长、调性、速度、乐器等参数(部分参数仅 v4.3 支持);bgm 模式通过自然语言描述生成纯音乐,v5.0 模型无需单独指定流派/情绪,可设置时长与歌曲结构段落;lyrics 模式同步返回歌词,可单独使用或作为 song 模式的前置步骤。

使用方式:先判断用户意图并选择模式,然后进入技能目录 cd 到 skills/byted-music-generate,运行 python 脚本。脚本内部轮询 API,歌曲/BGM 通常需 1–5 分钟;若命令被移到后台,需每 10 秒读取终端输出确认是否完成。完成后将 JSON 输出中的 audio_url 或歌词返回用户。示例命令:python scripts/music_generate.py song --prompt "A song about summer at the beach" --genre Pop --gender Female;python scripts/music_generate.py bgm --text "Relaxed coffee shop ambiance music with piano and guitar" --duration 60;python scripts/music_generate.py lyrics --prompt "A song about graduation farewell" --genre Folk --mood "Sentimental/Melancholic/Lonely" --gender Female。超时可手动查询:python scripts/music_generate.py query --task-id "..."。使用前需配置鉴权,二选一:网关方式(ARK_SKILL_API_BASE + ARK_SKILL_API_KEY,优先)或直连 AK/SK(VOLCENGINE_ACCESS_KEY + VOLCENGINE_SECRET_KEY)。

适用场景:为短视频、游戏、播客等制作背景音乐;按主题或歌词定制人声歌曲;先生成歌词再谱曲。

限制:--lyrics 与 --prompt 互斥且歌词优先;lyrics 模式的 --prompt 仅支持中文且不超过 500 字符;song 模式提示词为中文 5–700 字符,时长 30–240 秒,bgm 时长 30–120 秒;脚本以 JSON 返回 status、mode、task_id、audio_url、duration、lyrics、error 等字段;生成任务需轮询,可能在数分钟内完成;出现鉴权错误需先配置环境变量,版权校验失败(code 50000001)可尝试丰富描述或延长时长后重试;audio_url 有效期约 1 年,建议及时保存。