SenseAudio AI Rapper

此技能专用于 SenseAudio 音乐生成任务，聚焦于说唱（rap）、嘻哈（hip-hop）及其他以人声为主的歌曲创作请求。

请先阅读

• references/music.md

仅当您需要精确的接口地址、参数定义、轮询机制或响应结构细节时，才加载该参考文档。

适用场景

当用户希望执行以下操作时，请使用此技能：

• 根据提示词（prompt）生成说唱歌词；
• 将已有歌词转换为包含人声的完整歌曲；
• 控制歌曲风格、标题、人声性别或纯伴奏模式；
• 轮询异步执行的歌词或歌曲生成任务；
• 调试 SenseAudio 音乐生成请求相关的错误。

默认工作流程

1. 确认目标输出类型：

• 仅生成歌词；
• 基于用户提供的歌词生成完整歌曲；
• 或由平台自动生成歌词并合成完整歌曲。

2. 从最小合法请求开始：

• 歌词生成需提供 prompt 和 provider: sensesong；
• 歌曲生成需指定 model: sensesong。

3. 将两条流水线均视为潜在异步流程：

• 若创建接口返回 task_id，则调用对应的 pending 接口进行轮询；
• 必须等待 status == SUCCESS 后再读取有效载荷（payload）数据；
• 如状态为 FAILED，须明确提示，不可默认为空数据。

4. 仅在必要时添加创意控制参数：

• lyrics、title、style、style_weight、negative_tags、vocal_gender、instrumental。

5. 返回可用于生产环境的输出内容：

• 一个最简可用的 curl 示例；
• 一个使用用户指定语言的请求示例；
• 完整的轮询逻辑；
• 对 audio_url、cover_url、lyrics 和 duration 字段的安全响应解析方式。

说唱专项指引

• 针对说唱类请求，提示词应明确说明主题、情绪基调、节奏速度及流派时代特征，例如 trap、boom bap、drill、conscious rap 或 melodic rap。
• 若用户已提供主歌（bars）或副歌（chorus），可跳过歌词生成步骤，直接调用歌曲创建接口，并传入 lyrics 参数。
• 使用 style 实现正向风格引导，使用 negative_tags 排除不期望的元素。
• 仅当用户明确要求，或创意需求中已清晰限定人声性别时，才设置 vocal_gender: "m" 或 "f"。
• 仅在需要纯节拍（beat-only）输出时设置 instrumental: true；其余情况请省略该参数。

实现规范

• API 密钥必须存于环境变量中，严禁硬编码密钥等敏感信息。
• 优先提供可复现的 curl 示例；如有必要，再补充 Python 或 JavaScript 示例。
• 不得自行构造未在文档中声明的请求字段或未公开接口。
• 歌词标签（lyric tags）的使用不得超出文档示例范围；若结构语法有特定要求，应严格参照文档示例格式。
• 若文档示例中歌词采用分号分隔的段落标记（如 [Verse];[Chorus]），除非用户另行提供其他合法歌词格式，否则须保留该格式。

响应解析规范

• 歌词轮询成功响应结构：response.data[0].text（必选），以及可选的 response.data[0].title。
• 歌曲轮询成功响应结构：response.data[0].audio_url、cover_url、duration、id、lyrics、title。
• 所有数组/对象访问均需加保护逻辑，因 response 或 data 在任务完成前可能为空或缺失。

输出检查清单

使用本技能生成回答时，须包含以下五项内容：

1. 所调用的接口地址（endpoint）；
2. 最小合法请求体（request body）；
3. 是否需要轮询（polling）；
4. 调用方最终应读取的关键字段；
5. 结合用户需求提出的、与说唱相关的提示词（prompt）或风格（style）优化建议。