用途:通过 Mureka API(https://api.mureka.ai)生成专业品质音乐,覆盖歌词写作到歌曲/器乐生成的完整流程。
主要能力:支持歌曲(含人声与歌词)、纯器乐、歌词生成或续写,以及上传参考音频、人声样本和旋律。可将任意语言的自然语言描述转换为结构化 Mureka 提示词,提取流派、情绪、乐器、节奏、人声、调性、BPM 等参数。
使用方式:需先设置 MUREKA_API_KEY 环境变量(在 https://platform.mureka.ai/ 注册并生成密钥),未配置前不应调用 API。所有操作通过 scripts/mureka.py 执行,子命令包括 song、instrumental、lyrics、upload。默认生成带歌词歌曲,仅在明确要求器乐/BGM/无人声时使用 instrumental;默认输出 mp3,--output 指定目录。生成前应先校验提示词质量并请用户确认。
限制:melody_id 必须单独使用,不能与其他控制项组合;prompt 与 reference_id 互斥,器乐中 prompt 与 instrumental_id 互斥。参考音频须为 30 秒 mp3/m4a,人声样本 15-30 秒,旋律 5-60 秒。建议使用 mureka-8 模型。常见错误包括 401 密钥无效、429 限流、402 余额不足、任务失败或超时等。依赖 Python 3 与 requests 库。