使用 `/v1/song/lyrics/create`、`/v1/song/lyrics/pending/:task_id` 等接口,创建和调试 SenseAudio 说唱、嘻哈或人声歌曲生成工作流。

安装

概览

Rapper 是一个专为 SenseAudio 平台设计的 AI 技能工具,专注于说唱、嘻哈及人声歌曲的创作与生成。它通过调用 `/v1/song/lyrics/create` 和 `/v1/song/lyrics/pending/:task_id` 等接口,支持从文本提示自动生成歌词,或将已有歌词扩展为完整的带人声歌曲。该工具适用于希望快速实现音乐创意的开发者或内容创作者,尤其适合需要自动化生成说唱作品、调试音乐生成流程或对异步任务进行轮询监控的场景。其设计强调灵活性与可控性,允许用户精细调节风格、标题、演唱者性别、伴奏模式等参数,同时确保输出格式规范且易于集成。无论是从零开始创作一首 trap 风格的 rap,还是将一段已有的 verse 转化为完整歌曲,Rapper 都能提供结构清晰、可复用的 API 调用方案。

核心功能特点

  1. 支持基于自然语言提示自动生成说唱或嘻哈歌词
  2. 可将用户提供的歌词或系统生成的歌词转换为完整带人声歌曲
  3. 提供风格控制(style)、负面标签过滤(negative_tags)、演唱者性别设置(vocal_gender)等精细化创作选项
  4. 采用异步任务机制,需通过 polling 接口轮询生成状态直至完成
  5. 返回结构化结果,包含音频链接、封面图、歌词文本、时长等关键元数据
  6. 内置 curl 示例与响应解析规则,便于开发者快速集成与错误排查

适用场景

Rapper 特别适合那些希望在短时间内产出高质量说唱内容的创作者和开发者。例如,一位独立音乐人可能希望根据‘城市夜晚的孤独感’这一主题自动生成一段 boom bap 风格的 rap 歌词,并进一步将其制作成带有男声演唱的完整歌曲;此时,他可以通过 Rapper 工具先调用 lyrics create 接口生成歌词,再使用 song create 接口结合 lyrics 字段完成歌曲合成。另一个典型场景是内容平台运营团队批量生成不同风格的说唱短视频配乐——他们可以利用 Rapper 的 style 和 vocal_gender 参数快速切换输出风格,并通过 polling 机制自动获取音频文件链接用于后续剪辑。此外,在开发音乐类应用时,若需接入 SenseAudio 的 AI 作曲能力,Rapper 提供的标准化请求模板和响应解析逻辑能显著降低对接复杂度。对于已有部分歌词但缺乏旋律的用户而言,直接传入 lyrics 字段跳过生成环节、专注歌曲合成也是一种高效路径。总之,只要涉及说唱、嘻哈或人声歌曲的智能生成与调试,Rapper 都是一个高度适配且功能完备的工具选择。