ClawHub

妙音AI音乐助手

Other

妙音AI 音乐创作助手，生成歌曲、查询任务、续写音乐、生成歌词。当用户需要 AI 作曲或音乐生成时调用。

Install

openclaw skills install miaoyin-ai-music

🎵 妙音AI 音乐助手

通过 HTTP REST API 调用音乐生成服务。

⛔ 强制规则（违反任何一条即为错误）

  1. 只能使用下方定义的 HTTP REST API。绝对不要尝试 MCP JSON-RPC、WebSocket 或任何其他协议。
  2. 所有 API 调用必须使用 HTTP 请求（POST），Base URL 固定为 https://ai.growingth.com/api，不要猜测或尝试其他端点。
  3. 严禁编造 API 响应。如果 API 调用失败，直接告诉用户"调用失败"并附上错误信息，不要编造结果或提供"手动操作指南"。
  4. 严禁改写 API 返回的内容。歌词、歌曲标题等必须原样展示，不要总结、翻译、改写或省略。
  5. 严禁在 API 调用失败时建议用户去网页手动操作。只需报告错误，让用户检查 API Token 或稍后重试。
  6. 不要使用 web_fetch、curl 或任何网页抓取工具来调用这些 API。只使用标准 HTTP 请求工具。
  7. 严禁对 API Token 进行任何格式校验（包括长度、字符类型、结构等）。无论 token 看起来多么"奇怪"，都必须直接调用 API 验证。
  8. 严禁添加 skill 文档中未提及的"优化"或"帮助"。不要自行重试、不要自行解释错误原因、不要提供文档未规定的建议。

第一步：配置 API Token

设置环境变量 MIAOYIN_API_TOKEN：

  • Linux/macOS: export MIAOYIN_API_TOKEN=your-token
  • Windows PowerShell: $env:MIAOYIN_API_TOKEN="your-token"
  • Windows CMD: set MIAOYIN_API_TOKEN=your-token
  • Docker: -e MIAOYIN_API_TOKEN=your-token
  • .env 文件: 写入 MIAOYIN_API_TOKEN=your-token

⚠️ 任何能设置环境变量的方式都可以，不依赖特定平台。

获取 API Token

  1. 访问 https://ai.growingth.com/api-service
  2. 登录后获取您的 API Token
  3. 复制 Token 并保存
  4. ⚠️ 请妥善保管您的 Token，不要泄露给他人

第二步：开始创作

对话示例：

  • 「帮我生成一首关于夏天的流行歌曲」
  • 「查一下刚才的歌好了吗」
  • 「显示我最近的音乐列表」
  • 「获取这首歌的歌词」

API 调用规范

Base URL: https://ai.growingth.com/api

请求方法: POST（所有接口统一使用 POST）

认证 Header: api-token: ${MIAOYIN_API_TOKEN}

格式: JSON

编码: UTF-8（请求体必须使用 UTF-8 编码，中文直接传入）

网络: 自动使用系统代理（HTTP_PROXY/HTTPS_PROXY）

超时: 默认 30 秒，查询任务状态可延长至 60 秒

请求结构（重要）

⚠️ 所有接口统一使用以下格式：

{
  "name": "操作名称",
  "data": {
    // 具体请求参数
  }
}

Header 示例：

{
  "api-token": "Your API Token",
  "Content-Type": "application/json; charset=utf-8"
}

⚠️ 注意：

  1. 所有接口都是 POST 请求到 https://ai.growingth.com/api
  2. 操作名称通过 name 字段指定（也可以写在 query 参数上）
  3. 具体请求数据必须放在 data 对象中
  4. 认证使用 api-token Header，不是 Authorization

⚠️ 调用前自检（每次对话必须逐项确认）

在调用任何 API 之前，请在心中默念：

  • 我有 MIAOYIN_API_TOKEN 吗？ → 没有：引导用户获取，不要尝试调用 API

  • 用户的要求能用现有 API 实现吗？ → 不能：直接说"抱歉，当前不支持此功能"，不要编造

  • 我知道每个参数的含义和必填性吗？ → 不确定：查阅 API 文档，不要猜测

  • 我准备好处理可能的错误了吗？ → 没有：先阅读"错误处理流程"章节

任何一项为"否"，都不要继续调用 API。

错误提示模板（必须原样使用，不准修改）

错误类型提示语
余额不足"❌ 余额不足\n\n您当前的余额不足，无法继续创作。\n请访问 https://ai.growingth.com/api-service 进行额度购买。"
未获取Token"❌ 未配置 API Token\n\n您当前尚未获得凭证（token）。\n请前往 https://ai.growingth.com/api-service 创建获取，以开始您的创作。\n\n🎁 创建后您将获得 10 首歌的免费体验额度！"
版权保护"❌ 转换失败\n\n该音频与现有作品匹配，触发了版权保护机制，无法转换为 WAV 格式。\n\n建议：尝试转换其他原创歌曲。"
401/403"API Token 无效或已过期，请检查 MIAOYIN_API_TOKEN 配置"
5xx"请求服务器异常，请稍后重试"
超时"请求超时，请稍后重试"
网络错误"网络连接失败，请检查网络或代理设置"

⚠️ 禁止使用其他表述，禁止添加"可能原因"、"建议检查"等额外内容。

错误类型判断规则

根据 API 返回的错误信息，按以下优先级判断错误类型：

  1. 余额不足：响应消息包含"余额不足"、"balance"、"insufficient"等关键词
  2. 未获取Token：响应消息包含"token"、"凭证"、"未获得"等关键词（且不是 401/403 状态码）
  3. 版权保护：响应消息包含"matches existing work of art"、"版权"、"copyright"等关键词
  4. 401/403：HTTP 状态码为 401 或 403
  5. 5xx：HTTP 状态码为 500-599
  6. 超时：请求超时
  7. 网络错误：网络连接失败

详细错误日志输出（必须执行）

任何 HTTP 请求失败时，除了展示上述用户友好的提示外，还必须输出详细的技术日志供排查问题。

日志输出格式

=== 错误详情 ===
请求：POST https://ai.growingth.com/api
操作：{{操作名称}}
状态码：{{状态码}}
错误：{{错误信息}}

--- 请求头 ---
Content-Type: application/json
api-token: ********

--- 请求体 ---
{
  "name": "{{操作名称}}",
  "data": { ... }
}

--- 响应头 ---
{{响应头信息}}

--- 响应体 ---
{{响应体内容}}

敏感信息隐藏规则

  • api-token: xxx → api-token: ********
  • MIAOYIN_API_TOKEN 环境变量的完整值 → ********

版本声明

  • Skill 版本: 1.0.0
  • API 版本: 以实际 API 响应为准
  • 兼容性: 不假设 API 格式固定，以实际响应为准

如果 API 响应包含未预期的字段，原样展示，不要报错。

API 接口列表

API 1：生成歌曲

用途：用户想创作/生成音乐时调用。

请求地址：

POST https://ai.growingth.com/api/song/proxy?name=generateCustom

Headers：

{
  "api-token": "${MIAOYIN_API_TOKEN}",
  "Content-Type": "application/json; charset=utf-8"
}

请求体结构：

{
  "data": {
    "prompt": "歌词内容",
    "tags": "歌曲风格，如 Chinese, Piano, Guitar",
    "negative_tags": "排除风格（可选）",
    "model": "chirp-v5",
    "desc": "描述信息（可选）",
    "title": "歌曲标题（可选）",
    "make_instrumental": false
  }
}

data 字段说明：

字段类型必填说明
promptString✅ 是歌词内容
tagsString❌ 否歌曲风格，如 Chinese, Piano, Guitar
negative_tagsString❌ 否排除风格
modelString❌ 否模型版本：chirp-v5-5, chirp-v5, chirp-v4-5, chirp-v4, chirp-v3-5，默认 chirp-v5
descString❌ 否描述信息
titleString❌ 否歌曲标题
make_instrumentalBoolean❌ 否是否纯音乐，默认 false

响应示例：

{
  "status": "Success",
  "message": "请求成功",
  "data": [
    {
      "taskId": "c13975cda17449da2261"
    }
  ]
}

响应字段说明：

字段类型说明
statusString请求状态：Success / Error
messageString响应消息
dataArray任务数据数组
data[].taskIdString任务编号，用于后续查询

调用决策树（严格按此流程执行）

当用户表达 [生成歌曲] [创作音乐] [写首歌] [做首曲子] 等意图时：

步骤 1：确认需求
  IF 用户提供了歌词：
    prompt = 用户提供的完整歌词
  ELSE IF 用户描述了音乐风格（如"夏天的流行歌"）：
    prompt = 用户的描述
    tags = 根据描述提取风格标签
  ELSE:
    询问用户："请提供歌词，或描述您想要的音乐风格（例如：帮我生成一首关于夏天的流行歌曲）"
    → 停止，等待用户回复

步骤 2：构建请求
  POST https://ai.growingth.com/api/song/proxy?name=generateCustom
  Headers:
    api-token: ${MIAOYIN_API_TOKEN}
    Content-Type: application/json; charset=utf-8
  请求体:
    {
      "data": {
        "prompt": "步骤 1 中确定的歌词或描述",
        "tags": "用户指定的风格（可选）",
        "title": "用户指定的标题（可选）",
        "model": "chirp-v5",
        "make_instrumental": 用户要求纯音乐则为 true，否则为 false
      }
    }

步骤 3：发送请求并处理响应
  IF response.status == "Success":
    taskId = response.data[0].taskId
    说："✅ 提交成功！任务编号：{taskId}，正在生成中，请稍候..."
    → 转到查询任务状态流程（待补充）
  ELSE:
    说："❌ 生成失败：{response.message}"
    → 转到 "错误处理流程"

完整对话示例

示例 1：用户提供歌词

用户：我想用这首歌词生成音乐：
[Verse]
阳光洒在海面
微风吹拂着脸

[Chorus]
这是我们的夏天
永远不变的画面

AI: 收到！我将用您提供的歌词生成音乐。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateCustom]
    [请求体] {
      "data": {
        "prompt": "[Verse]\n阳光洒在海面\n微风吹拂着脸\n\n[Chorus]\n这是我们的夏天\n永远不变的画面",
        "model": "chirp-v5"
      }
    }
    
    ✅ 提交成功！任务编号：c13975cda17449da2261，正在生成中，请稍候...

示例 2：用户描述风格

用户：帮我生成一首关于夏天的流行歌曲，要有钢琴和吉他

AI: 好的，我来帮您创作一首夏天主题的流行歌曲。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateCustom]
    [请求体] {
      "data": {
        "prompt": "关于夏天的流行歌曲",
        "tags": "Piano, Guitar",
        "model": "chirp-v5"
      }
    }
    
    ✅ 提交成功！任务编号：c13975cda17449da2261，正在生成中，请稍候...

示例 3：生成纯音乐

用户：生成一首中国风的纯音乐

AI: 好的，我来为您创作一首中国风纯音乐。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateCustom]
    [请求体] {
      "data": {
        "prompt": "中国风纯音乐",
        "tags": "Chinese",
        "model": "chirp-v5",
        "make_instrumental": true
      }
    }
    
    ✅ 提交成功！任务编号：c13975cda17449da2261，正在生成中，请稍候...

⚠️ 关键注意事项

  1. 编码要求

    • 请求体必须使用 UTF-8 编码
    • 中文歌词直接传入，不要转义

  2. 模型版本选择

    • 默认使用 chirp-v5
    • 可选版本：chirp-v5-5（最新）, chirp-v5, chirp-v4-5, chirp-v4, chirp-v3-5
    • 除非用户明确指定，否则使用默认版本

  3. 风格标签（tags）

    • 多个风格用逗号分隔，如 "Chinese, Piano, Guitar"
    • 常见风格：Pop, Rock, Jazz, Classical, Electronic, Chinese, Piano, Guitar 等

  4. 任务编号保存

    • 生成成功后，必须保存 taskId 用于后续查询
    • 在对话上下文中记住最近的 taskId

API 2：查询歌曲状态

用途：查询生成进度和结果。

⚠️ 重要警告：请勿过于频繁调用此接口，建议查询间隔不低于 10 秒，否则可能会被禁用。

请求地址：

POST https://ai.growingth.com/api/song/proxy?name=getMusic

Headers：

{
  "api-token": "${MIAOYIN_API_TOKEN}",
  "Content-Type": "application/json; charset=utf-8"
}

请求体结构：

{
  "data": {
    "ids": "c13975cda17449da2261,0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f"
  }
}

data 字段说明：

字段类型必填说明
idsString✅ 是歌曲 id 列表（也可以是 taskId），以英文逗号分隔多个

响应示例：

{
  "status": "Success",
  "message": "请求成功",
  "data": [
    {
      "id": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f",
      "title": "Through the Fog",
      "image_url": "https://cdn2.suno.ai/image_0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f.jpeg",
      "lyric": "[Instrumental]",
      "audio_url": "https://cdn1.suno.ai/0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f.mp3",
      "video_url": "https://cdn1.suno.ai/0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f.mp4",
      "created_at": "2024-08-30T07:46:22.206Z",
      "model_name": "chirp-v4",
      "status": "complete"
    }
  ]
}

响应字段说明：

字段类型说明
statusString请求状态：Success / Error
messageString响应消息
dataArray歌曲数据数组
data[].idString歌曲唯一标识
data[].titleString歌曲标题
data[].image_urlString封面图片链接
data[].lyricString歌词内容
data[].audio_urlString音频播放链接
data[].video_urlString视频播放链接
data[].created_atString创建时间
data[].model_nameString使用的模型名称
data[].statusString生成状态：complete（完成）/ processing（处理中）/ queued（排队中）/ failed（失败）

调用决策树（严格按此流程执行）

当需要查询歌曲状态时（生成后自动查询 / 用户主动询问）：

步骤 1：确定要查询的任务编号
  IF 是刚生成的任务：
    taskId = 上一步生成歌曲返回的 taskId
  ELSE IF 用户提供了编号（如"查一下 c13975cda17449da2261 的状态"）：
    taskId = 用户提供的编号
  ELSE IF 用户说"刚才的歌/最近的任务"：
    taskId = 最近一次提交的任务编号（需要从上下文记忆）
  ELSE:
    询问用户："请问要查询哪个任务？请提供任务编号"
    → 停止，等待用户回复

步骤 2：构建请求
  POST https://ai.growingth.com/api/song/proxy?name=getMusic
  Headers:
    api-token: ${MIAOYIN_API_TOKEN}
    Content-Type: application/json; charset=utf-8
  请求体:
    {
      "data": {
        "ids": taskId
      }
    }

步骤 3：发送请求并处理响应
  IF response.status == "Success":
    FOR EACH song IN response.data:
      status = song.status
      
      IF status == "complete":
        展示：
          🎵 歌曲名：{song.title}
          🎼 歌词：{song.lyric}
          ▶️ 音频播放：{song.audio_url} | 下载：{song.audio_url}
          🎬 视频播放：{song.video_url} | 下载：{song.video_url}
          🖼️ 封面图片：{song.image_url}
          📅 创建时间：{song.created_at}
          🤖 模型：{song.model_name}
      
      ELSE IF status == "processing" 或 "queued":
        说：
          ⏳ 音乐还在生成中，当前状态：{status}
          请您过 10 秒以上再问我"好了吗"，我会继续为您查询。
        → 停止，不要再调用 API
      
      ELSE IF status == "failed":
        说：
          ❌ 生成失败
          任务编号：{song.id}
        → 停止，不要重试
      
      ELSE:
        说：
          ⚠️ 未知状态：{status}
  ELSE:
    说："❌ 查询失败：{response.message}"
    → 转到 "错误处理流程"

完整对话示例

示例 1：生成后自动查询（完成）

用户：帮我生成一首关于夏天的流行歌曲

AI: [执行：POST https://ai.growingth.com/api/song/proxy?name=generateCustom]
    ✅ 提交成功！任务编号：c13975cda17449da2261，正在生成中，请稍候...
    
    [等待 10 秒后执行：POST https://ai.growingth.com/api/song/proxy?name=getMusic]
    [请求体] {
      "data": {
        "ids": "c13975cda17449da2261"
      }
    }
    
    🎵 生成完成！
    歌曲名：夏日微风
    歌曲id:1231465
    🎼 歌词：
    [Verse]
    阳光洒在海面
    微风吹拂着脸
    ...
    
    ▶️ 音频播放：https://cdn1.suno.ai/c13975cda17449da2261.mp3 | 下载：https://cdn1.suno.ai/c13975cda17449da2261.mp3
    🎬 视频播放：https://cdn1.suno.ai/c13975cda17449da2261.mp4 | 下载：https://cdn1.suno.ai/c13975cda17449da2261.mp4
    🖼️ 封面图片：https://cdn2.suno.ai/image_c13975cda17449da2261.jpeg

示例 2：用户主动询问（处理中）

用户：刚才那首歌好了吗

AI: [执行：POST https://ai.growingth.com/api/song/proxy?name=getMusic]
    [请求体] {
      "data": {
        "ids": "c13975cda17449da2261"
      }
    }
    
    ⏳ 音乐还在生成中，当前状态：processing
    请您过 10 秒以上再问我"好了吗"，我会继续为您查询。

示例 3：批量查询多个任务

用户：帮我查一下这三个任务的状态：c13975cda17449da2261,0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f,d57dba20-e63d-4c99-ab43-9469d2944f9f

AI: [执行：POST https://ai.growingth.com/api/song/proxy?name=getMusic]
    [请求体] {
      "data": {
        "ids": "c13975cda17449da2261,0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f,d57dba20-e63d-4c99-ab43-9469d2944f9f"
      }
    }
    
    任务 1：✅ 已完成
      歌曲名：夏日微风
      ▶️ 播放：https://cdn1.suno.ai/c13975cda17449da2261.mp3 | 下载：https://cdn1.suno.ai/c13975cda17449da2261.mp3
    
    任务 2：✅ 已完成
      歌曲名：Through the Fog
      ▶️ 播放：https://cdn1.suno.ai/0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f.mp3 | 下载：https://cdn1.suno.ai/0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f.mp3
    
    任务 3：⏳ 生成中（processing）
      请稍后再问

⚠️ 关键注意事项

  1. 查询频率限制（非常重要）

    • 最小查询间隔：10 秒
    • 违反此规则可能导致接口被禁用
    • 生成后第一次查询：建议等待 10-15 秒
    • 用户再次询问：确保距离上次查询至少 10 秒

  2. 轮询限制（必须严格遵守）

    • ✅ 允许：生成后等待 10 秒查询 1 次
    • ✅ 允许：用户询问时再查询 1 次（间隔 10 秒以上）
    • ❌ 禁止：自己循环调用查询接口
    • ❌ 禁止：在 10 秒内连续查询
    • ❌ 禁止：在任务未完成时频繁查询

  3. 状态处理优先级

    complete → 立即展示播放链接和完整信息
failed → 展示失败信息，不要重试
processing/queued → 告知用户稍后再问（至少 10 秒），然后停止

  4. 歌词展示

    • 必须完整原样展示 lyric 字段内容
    • 不要总结、翻译、改写或省略
    • 纯音乐的歌词通常是 "[Instrumental]"

  5. 批量查询

    • 支持一次查询多个任务
    • 多个 id 用英文逗号分隔
    • 最多建议一次查询不超过 10 个

API 3：续写歌曲

用途：如果歌曲效果不错，但时长不足，可通过此接口进行续写。

请求地址：

POST https://ai.growingth.com/api/song/proxy?name=generateContinue

Headers：

{
  "api-token": "${MIAOYIN_API_TOKEN}",
  "Content-Type": "application/json; charset=utf-8"
}

请求体结构：

{
  "data": {
    "audio_id": "歌曲 clipId",
    "continue_clip_id": "歌曲 clipId",
    "continue_at": 7,
    "prompt": "歌词内容（可选）",
    "tags": "歌曲风格（可选）",
    "negative_tags": "排除风格（可选）",
    "model": "chirp-v5",
    "desc": "描述信息（可选）",
    "title": "歌曲标题（可选）",
    "make_instrumental": false
  }
}

data 字段说明：

字段类型必填说明
audio_idString✅ 是续写歌曲的 clipId
continue_clip_idString✅ 是续写歌曲的 clipId（与 audio_id 相同）
continue_atNumber✅ 是续写时间点，单位秒
promptString❌ 否歌词内容
tagsString❌ 否歌曲风格，如 Chinese, Piano, Guitar
negative_tagsString❌ 否排除风格
modelString❌ 否模型版本：chirp-v5, chirp-v4-5, chirp-v4, chirp-v3-5，默认 chirp-v5
descString❌ 否描述信息
titleString❌ 否歌曲标题
make_instrumentalBoolean❌ 否是否纯音乐，默认 false

响应示例：

{
  "status": "Success",
  "message": "请求成功",
  "data": [
    {
      "taskId": "xxx"
    }
  ]
}

响应字段说明：

字段类型说明
statusString请求状态：Success / Error
messageString响应消息
dataArray任务数据数组
data[].taskIdString任务编号，用于后续查询

调用决策树（严格按此流程执行）

当用户表达 [续写] [继续创作] [延长歌曲] [接着写] 等意图时：

步骤 1：确认续写需求
  IF 用户提供了歌曲 ID 和续写时间点：
    audio_id = 用户提供的歌曲 ID
    continue_at = 用户指定的时间点（秒）
  ELSE IF 用户提供了歌曲 ID 但未指定时间点：
    audio_id = 用户提供的歌曲 ID
    询问用户："请问从第几秒开始续写？（例如：从第 7 秒开始）"
    → 停止，等待用户回复
  ELSE IF 用户说"续写刚才的歌"：
    audio_id = 最近一次生成的歌曲 ID（从查询结果中获取）
    询问用户："请问从第几秒开始续写？（例如：从第 7 秒开始）"
    → 停止，等待用户回复
  ELSE:
    询问用户："请提供要续写的歌曲 ID 和续写时间点（例如：续写歌曲 xxx，从第 7 秒开始）"
    → 停止，等待用户回复

步骤 2：构建请求
  POST https://ai.growingth.com/api/song/proxy?name=generateContinue
  Headers:
    api-token: ${MIAOYIN_API_TOKEN}
    Content-Type: application/json; charset=utf-8
  请求体:
    {
      "data": {
        "audio_id": audio_id,
        "continue_clip_id": audio_id,
        "continue_at": continue_at,  // 必须明确指定续写时间点（秒）
        "prompt": "用户指定的歌词（可选）",
        "tags": "用户指定的风格（可选）",
        "model": "chirp-v5",  // 固定使用 chirp-v5 模型
        "make_instrumental": 用户要求纯音乐则为 true，否则为 false
      }
    }

步骤 3：发送请求并处理响应
  IF response.status == "Success":
    taskId = response.data[0].taskId
    说："✅ 续写提交成功！任务编号：{taskId}，正在生成中，请稍候..."
    → 转到 API 2 查询任务状态流程
  ELSE:
    说："❌ 续写失败：{response.message}"
    → 转到 "错误处理流程"

完整对话示例

示例 1：续写指定歌曲

用户：帮我续写歌曲 0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f，从第 7 秒开始

AI: 好的，我将从第 7 秒开始续写这首歌曲。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateContinue]
    [请求体] {
      "data": {
        "audio_id": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f",
        "continue_clip_id": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f",
        "continue_at": 7,
        "model": "chirp-v5"
      }
    }
    
    ✅ 续写提交成功！任务编号：d57dba20-e63d-4c99-ab43-9469d2944f9f，正在生成中，请稍候...

示例 2：续写最近的歌曲

用户：续写刚才那首歌

AI: 请问从第几秒开始续写？（例如：从第 7 秒开始）

用户：从第 10 秒开始

AI: 好的，我将从第 10 秒开始续写。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateContinue]
    [请求体] {
      "data": {
        "audio_id": "c13975cda17449da2261",
        "continue_clip_id": "c13975cda17449da2261",
        "continue_at": 10,
        "model": "chirp-v5"
      }
    }
    
    ✅ 续写提交成功！任务编号：xxx，正在生成中，请稍候...

示例 3：续写并指定新歌词

用户：续写歌曲 0e66d6dd，从第 10 秒开始，加上这段歌词：
[Bridge]
时光流转不停
回忆永远鲜明

AI: 好的，我将从第 10 秒开始续写，并使用您提供的歌词。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateContinue]
    [请求体] {
      "data": {
        "audio_id": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f",
        "continue_clip_id": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f",
        "continue_at": 10,
        "prompt": "[Bridge]\n时光流转不停\n回忆永远鲜明",
        "model": "chirp-v5"
      }
    }
    
    ✅ 续写提交成功！任务编号：xxx，正在生成中，请稍候...

⚠️ 关键注意事项

  1. 歌曲 ID 获取

    • 歌曲 ID（clipId）从 API 2 查询歌曲状态的响应中获取
    • 响应字段中的 id 就是 clipId
    • 必须先查询歌曲状态，确认歌曲已完成（status = complete）后才能续写

  2. 续写时间点（continue_at）

    • 单位：秒
    • 必须明确指定具体的秒数（例如：7、10、15 等）
    • 不能使用 0 或空值
    • 建议续写时间点不要超过原歌曲时长
    • 如果用户未指定，必须询问用户具体从第几秒开始

  3. audio_id 和 continue_clip_id

    • 这两个字段必须相同
    • 都填写要续写的歌曲 clipId

  4. 续写后的查询

    • 续写成功后会返回新的 taskId
    • 使用 API 2 查询新任务的状态
    • 续写生成的是一首新歌曲，不会覆盖原歌曲

  5. 模型版本

    • 固定使用 chirp-v5 模型
    • 不要使用其他模型版本

API 4：翻唱模式（Cover）

用途：在保持主旋律的前提下，对歌曲进行翻唱改编或提升音质。

请求地址：

POST https://ai.growingth.com/api/song/proxy?name=generateCover

Headers：

{
  "api-token": "${MIAOYIN_API_TOKEN}",
  "Content-Type": "application/json; charset=utf-8"
}

请求体结构：

{
  "data": {
    "continue_clip_id": "歌曲 clipId",
    "prompt": "歌词内容（可选）",
    "tags": "歌曲风格（可选）",
    "negative_tags": "排除风格（可选）",
    "model": "chirp-v5",
    "title": "歌曲标题（可选）",
    "make_instrumental": false,
    "persona_id": "音色 persona_clip_id（可选）",
    "artist_clip_id": "音色 root_clip_id（可选）"
  }
}

data 字段说明：

字段类型必填说明
continue_clip_idString✅ 是需要翻唱的歌曲 clipId
promptString❌ 否歌词内容
tagsString❌ 否歌曲风格，如 Chinese, Piano, Guitar
negative_tagsString❌ 否排除风格
modelString❌ 否模型版本：chirp-v5, chirp-v4-5, chirp-v4, chirp-v3-5，默认 chirp-v5
titleString❌ 否歌曲标题
make_instrumentalBoolean❌ 否是否纯音乐，默认 false
persona_idString❌ 否音色参数（通过 makePersona 任务获取的 persona_clip_id）
artist_clip_idString❌ 否音色参数（通过 makePersona 任务获取的 root_clip_id）

响应示例：

{
  "status": "Success",
  "message": "请求成功",
  "data": [
    {
      "taskId": "xxx"
    }
  ]
}

响应字段说明：

字段类型说明
statusString请求状态：Success / Error
messageString响应消息
dataArray任务数据数组
data[].taskIdString任务编号，用于后续查询

调用决策树（严格按此流程执行）

当用户表达 [翻唱] [改编] [Cover] [换个风格] [提升音质] 等意图时：

步骤 1：确认翻唱需求
  IF 用户提供了歌曲 ID：
    continue_clip_id = 用户提供的歌曲 ID
  ELSE IF 用户说"翻唱刚才的歌"：
    continue_clip_id = 最近一次生成的歌曲 ID（从查询结果中获取）
  ELSE:
    询问用户："请提供要翻唱的歌曲 ID"
    → 停止，等待用户回复
  
  可选确认：
  - tags = 用户指定的新风格
  - prompt = 用户指定的新歌词
  - persona_id / artist_clip_id = 用户指定的音色参数

步骤 2：构建请求
  POST https://ai.growingth.com/api/song/proxy?name=generateCover
  Headers:
    api-token: ${MIAOYIN_API_TOKEN}
    Content-Type: application/json; charset=utf-8
  请求体:
    {
      "data": {
        "continue_clip_id": continue_clip_id,
        "prompt": "用户指定的歌词（可选）",
        "tags": "用户指定的风格（可选）",
        "model": "chirp-v5",
        "title": "用户指定的标题（可选）",
        "make_instrumental": 用户要求纯音乐则为 true，否则为 false
      }
    }

步骤 3：发送请求并处理响应
  IF response.status == "Success":
    taskId = response.data[0].taskId
    说："✅ 翻唱提交成功！任务编号：{taskId}，正在生成中，请稍候..."
    → 转到 API 2 查询任务状态流程
  ELSE:
    说："❌ 翻唱失败：{response.message}"
    → 转到 "错误处理流程"

完整对话示例

示例 1：翻唱指定歌曲

用户：帮我翻唱歌曲 0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f

AI: 好的，我将为您翻唱这首歌曲。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateCover]
    [请求体] {
      "data": {
        "continue_clip_id": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f",
        "model": "chirp-v5"
      }
    }
    
    ✅ 翻唱提交成功！任务编号：xxx，正在生成中，请稍候...

示例 2：翻唱并改变风格

用户：把刚才那首歌改成爵士风格

AI: 好的，我将把这首歌改编成爵士风格。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateCover]
    [请求体] {
      "data": {
        "continue_clip_id": "c13975cda17449da2261",
        "tags": "Jazz",
        "model": "chirp-v5"
      }
    }
    
    ✅ 翻唱提交成功！任务编号：xxx，正在生成中，请稍候...

示例 3：翻唱并修改歌词

用户：翻唱歌曲 0e66d6dd，用这段新歌词：
[Verse]
夜色温柔如水
星光点点相随

AI: 好的，我将使用新歌词翻唱这首歌。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateCover]
    [请求体] {
      "data": {
        "continue_clip_id": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f",
        "prompt": "[Verse]\n夜色温柔如水\n星光点点相随",
        "model": "chirp-v5"
      }
    }
    
    ✅ 翻唱提交成功！任务编号：xxx，正在生成中，请稍候...

⚠️ 关键注意事项

  1. 歌曲 ID 获取

    • 歌曲 ID（clipId）从 API 2 查询歌曲状态的响应中获取
    • 响应字段中的 id 就是 clipId
    • 必须先查询歌曲状态，确认歌曲已完成（status = complete）后才能翻唱

  2. 翻唱与原创的区别

    • 翻唱会保持原歌曲的主旋律
    • 可以改变风格、歌词、音色等元素
    • 适合用于改编、提升音质、换风格等场景

  3. 音色参数（高级功能）

    • persona_id 和 artist_clip_id 用于指定特定音色
    • 这些参数需要通过 makePersona 任务预先获取
    • 如果不指定，系统会使用默认音色

  4. 翻唱后的查询

    • 翻唱成功后会返回新的 taskId
    • 使用 API 2 查询新任务的状态
    • 翻唱生成的是一首新歌曲，不会覆盖原歌曲

  5. 推荐使用场景

    • 改变歌曲风格（如流行改爵士）
    • 提升老歌音质
    • 使用不同音色演唱
    • 修改部分歌词但保持旋律

API 5：合并续写歌曲

用途：续写歌曲生成后，通过此接口将续写片段与父歌曲合并成完整歌曲。

请求地址：

POST https://ai.growingth.com/api/song/proxy?name=concat

Headers：

{
  "api-token": "${MIAOYIN_API_TOKEN}",
  "Content-Type": "application/json; charset=utf-8"
}

请求体结构：

{
  "data": {
    "clip_id": "1c51baab-5085-4e2e-a1d8-c6a103a55488"
  }
}

data 字段说明：

字段类型必填说明
clip_idString✅ 是续写歌曲的 id（通过 API 3 续写后生成的歌曲 id）

响应示例：

{
  "status": "Success",
  "message": "请求成功",
  "data": [
    {
      "taskId": "xxx"
    }
  ]
}

响应字段说明：

字段类型说明
statusString请求状态：Success / Error
messageString响应消息
dataArray任务数据数组
data[].taskIdString任务编号，用于后续查询

调用决策树（严格按此流程执行）

当用户表达 [合并] [拼接] [合成完整歌曲] 等意图时：

步骤 1：确认合并需求
  IF 用户提供了续写歌曲的 ID：
    clip_id = 用户提供的续写歌曲 ID
  ELSE IF 用户说"合并刚才续写的歌"：
    clip_id = 最近一次续写生成的歌曲 ID（从 API 3 的响应中获取）
  ELSE:
    询问用户："请提供要合并的续写歌曲 ID"
    → 停止，等待用户回复

步骤 2：构建请求
  POST https://ai.growingth.com/api/song/proxy?name=concat
  Headers:
    api-token: ${MIAOYIN_API_TOKEN}
    Content-Type: application/json; charset=utf-8
  请求体:
    {
      "data": {
        "clip_id": clip_id
      }
    }

步骤 3：发送请求并处理响应
  IF response.status == "Success":
    taskId = response.data[0].taskId
    说："✅ 合并提交成功！任务编号：{taskId}，正在处理中，请稍候..."
    → 转到 API 2 查询任务状态流程
  ELSE:
    说："❌ 合并失败：{response.message}"
    → 转到 "错误处理流程"

完整对话示例

示例 1：续写后立即合并

用户：帮我续写歌曲 0e66d6dd，从第 7 秒开始

AI: [执行：POST https://ai.growingth.com/api/song/proxy?name=generateContinue]
    ✅ 续写提交成功！任务编号：1c51baab-5085-4e2e-a1d8-c6a103a55488，正在生成中...
    
    [等待生成完成后]
    🎵 续写完成！
    
用户：把续写的部分和原歌曲合并

AI: 好的，我将把续写片段与原歌曲合并成完整歌曲。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=concat]
    [请求体] {
      "data": {
        "clip_id": "1c51baab-5085-4e2e-a1d8-c6a103a55488"
      }
    }
    
    ✅ 合并提交成功！任务编号：xxx，正在处理中，请稍候...

示例 2：合并指定的续写歌曲

用户：合并续写歌曲 1c51baab-5085-4e2e-a1d8-c6a103a55488

AI: 好的，我将合并这首续写歌曲。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=concat]
    [请求体] {
      "data": {
        "clip_id": "1c51baab-5085-4e2e-a1d8-c6a103a55488"
      }
    }
    
    ✅ 合并提交成功！任务编号：xxx，正在处理中，请稍候...
    
    [等待 10 秒后查询]
    🎵 合并完成！
    歌曲名：夏日微风（完整版）
    ▶️ 音频播放：https://cdn1.suno.ai/xxx.mp3 | 下载：https://cdn1.suno.ai/xxx.mp3

示例 3：完整的续写+合并流程

用户：续写刚才那首歌，然后合并成完整版

AI: 好的，我先为您续写歌曲。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateContinue]
    ✅ 续写提交成功！任务编号：1c51baab，正在生成中...
    
    [等待生成完成]
    🎵 续写完成！现在开始合并...
    
    [执行：POST https://ai.growingth.com/api/song/proxy?name=concat]
    [请求体] {
      "data": {
        "clip_id": "1c51baab-5085-4e2e-a1d8-c6a103a55488"
      }
    }
    
    ✅ 合并提交成功！正在处理中...
    
    [等待合并完成]
    🎵 合并完成！完整歌曲已生成。
    ▶️ 音频播放：https://cdn1.suno.ai/xxx.mp3 | 下载：https://cdn1.suno.ai/xxx.mp3

⚠️ 关键注意事项

  1. 合并前提条件

    • 必须先通过 API 3 续写歌曲
    • 续写任务必须已完成（status = complete）
    • 使用续写生成的歌曲 ID（不是原歌曲 ID）

  2. clip_id 获取

    • clip_id 是续写歌曲的 ID
    • 从 API 3 续写接口的响应中获取 taskId
    • 然后通过 API 2 查询该任务，获取生成的歌曲 id

  3. 合并结果

    • 合并会生成一首新的完整歌曲
    • 返回新的 taskId，需要通过 API 2 查询
    • 原歌曲和续写片段不会被删除

  4. 推荐工作流程

    1. 生成原歌曲（API 1）
2. 续写歌曲（API 3）
3. 查询续写状态（API 2）确认完成
4. 合并歌曲（API 5）
5. 查询合并结果（API 2）

  5. 合并后的查询

    • 合并成功后会返回新的 taskId
    • 使用 API 2 查询合并任务的状态
    • 合并完成后可以获取完整歌曲的播放链接

API 6：生成视频

用途：为已生成的歌曲创建视频。

请求地址：

POST https://ai.growingth.com/api/song/proxy?name=generateVideo

Headers：

{
  "api-token": "${MIAOYIN_API_TOKEN}",
  "Content-Type": "application/json; charset=utf-8"
}

请求体结构：

{
  "data": {
    "title": "歌曲标题",
    "clip_id": "需生成视频的 clip id"
  }
}

data 字段说明：

字段类型必填说明
titleString✅ 是歌曲标题
clip_idString✅ 是需生成视频的歌曲 clip id

响应示例：

{
  "status": "Success",
  "message": "请求成功",
  "data": {
    "taskId": "MBENVP5DFKOSPJHO"
  }
}

响应字段说明：

字段类型说明
statusString请求状态：Success / Error
messageString响应消息
dataObject任务数据对象
data.taskIdString任务编号，用于后续查询

调用决策树（严格按此流程执行）

当用户表达 [生成视频] [创建视频] [做个视频] [视频版] 等意图时：

步骤 1：确认视频生成需求
  IF 用户提供了歌曲 ID：
    clip_id = 用户提供的歌曲 ID
  ELSE IF 用户说"给刚才的歌生成视频"：
    clip_id = 最近一次生成的歌曲 ID（从查询结果中获取）
  ELSE:
    询问用户："请提供要生成视频的歌曲 ID"
    → 停止，等待用户回复
  
  获取歌曲标题：
  IF 已知歌曲标题（从之前的查询结果中）：
    title = 已知的歌曲标题
  ELSE:
    先调用 API 2 查询歌曲信息，获取标题

步骤 2：构建请求
  POST https://ai.growingth.com/api/song/proxy?name=generateVideo
  Headers:
    api-token: ${MIAOYIN_API_TOKEN}
    Content-Type: application/json; charset=utf-8
  请求体:
    {
      "data": {
        "title": title,
        "clip_id": clip_id
      }
    }

步骤 3：发送请求并处理响应
  IF response.status == "Success":
    taskId = response.data.taskId
    说："✅ 视频生成提交成功！任务编号：{taskId}，正在生成中，请稍候..."
    → 转到 API 2 查询任务状态流程
  ELSE:
    说："❌ 视频生成失败：{response.message}"
    → 转到 "错误处理流程"

完整对话示例

示例 1：为指定歌曲生成视频

用户：帮我给歌曲 0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f 生成视频

AI: 好的，我先查询一下这首歌的信息。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=getMusic]
    [请求体] {
      "data": {
        "ids": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f"
      }
    }
    
    查询到歌曲：Through the Fog
    
    现在开始生成视频...
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateVideo]
    [请求体] {
      "data": {
        "title": "Through the Fog",
        "clip_id": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f"
      }
    }
    
    ✅ 视频生成提交成功！任务编号：MBENVP5DFKOSPJHO，正在生成中，请稍候...

示例 2：为刚才生成的歌曲创建视频

用户：给刚才那首歌生成一个视频

AI: 好的，我将为《夏日微风》生成视频。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateVideo]
    [请求体] {
      "data": {
        "title": "夏日微风",
        "clip_id": "c13975cda17449da2261"
      }
    }
    
    ✅ 视频生成提交成功！任务编号：MBENVP5DFKOSPJHO，正在生成中，请稍候...
    
    [等待 10 秒后查询]
    [执行：POST https://ai.growingth.com/api/song/proxy?name=getMusic]
    [请求体] {
      "data": {
        "ids": "c13975cda17449da2261"
      }
    }
    
    🎬 视频生成完成！
    歌曲id:123465
    歌曲名：夏日微风
    🎬 视频播放：https://cdn1.suno.ai/c13975cda17449da2261.mp4 | 下载：https://cdn1.suno.ai/c13975cda17449da2261.mp4

示例 3：生成歌曲后立即创建视频

用户：帮我生成一首关于夏天的流行歌曲，然后做成视频

AI: 好的，我先为您创作歌曲。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateCustom]
    ✅ 提交成功！任务编号：c13975cda17449da2261，正在生成中...
    
    [等待生成完成]
    🎵 歌曲生成完成！
    歌曲名：夏日微风
    歌曲id:123465
    现在开始生成视频...
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateVideo]
    [请求体] {
      "data": {
        "title": "夏日微风",
        "clip_id": "c13975cda17449da2261"
      }
    }
    
    ✅ 视频生成提交成功！正在处理中...
    
    [等待视频生成完成]
    🎬 视频生成完成！
    🎬 视频id:123465
    🎬 视频播放：https://cdn1.suno.ai/c13975cda17449da2261.mp4 | 下载：https://cdn1.suno.ai/c13975cda17449da2261.mp4

⚠️ 关键注意事项

  1. 前提条件

    • 必须先有已生成完成的歌曲（status = complete）
    • 需要知道歌曲的 clip_id 和 title

  2. clip_id 获取

    • clip_id 从 API 2 查询歌曲状态的响应中获取
    • 响应字段中的 id 就是 clip_id

  3. title 参数

    • 必须提供歌曲标题
    • 如果不知道标题，先调用 API 2 查询歌曲信息

  4. 视频生成时间

    • 视频生成通常需要较长时间
    • 建议等待 15-30 秒后再查询状态
    • 查询间隔仍然遵守 10 秒以上的规则

  5. 查询视频结果

    • 使用 API 2（getMusic）查询任务状态
    • 视频生成完成后，响应中会包含 video_url 字段
    • 如果 video_url 为空或不存在，说明视频还在生成中

  6. 推荐使用场景

    • 为已生成的歌曲创建视频版本
    • 分享到社交媒体时需要视频格式
    • 制作音乐MV

API 7：生成 WAV 格式

用途：将歌曲转换为 WAV 无损音频格式。

请求地址：

POST https://ai.growingth.com/api/song/proxy?name=makeWav

Headers：

{
  "api-token": "${MIAOYIN_API_TOKEN}",
  "Content-Type": "application/json; charset=utf-8"
}

请求体结构：

{
  "data": {
    "clipId": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f"
  }
}

data 字段说明：

字段类型必填说明
clipIdString✅ 是歌曲 id（clip id）

响应示例：

{
  "status": "Success",
  "message": "请求成功",
  "data": {
    "taskId": "MBENVP5DFKOSPJHO"
  }
}

响应字段说明：

字段类型说明
statusString请求状态：Success / Error
messageString响应消息
dataObject任务数据对象
data.taskIdString任务编号，用于后续查询

调用决策树（严格按此流程执行）

当用户表达 [生成 WAV] [转换 WAV] [无损格式] [WAV 格式] 等意图时：

步骤 1：确认 WAV 生成需求
  IF 用户提供了歌曲 ID：
    clipId = 用户提供的歌曲 ID
  ELSE IF 用户说"把刚才的歌转成 WAV"：
    clipId = 最近一次生成的歌曲 ID（从查询结果中获取）
  ELSE:
    询问用户："请提供要转换的歌曲 ID"
    → 停止，等待用户回复

步骤 2：构建请求
  POST https://ai.growingth.com/api/song/proxy?name=makeWav
  Headers:
    api-token: ${MIAOYIN_API_TOKEN}
    Content-Type: application/json; charset=utf-8
  请求体:
    {
      "data": {
        "clipId": clipId
      }
    }

步骤 3：发送请求并处理响应
  IF response.status == "Success":
    taskId = response.data.taskId
    说："✅ WAV 格式生成提交成功！任务编号：{taskId}，正在转换中，请稍候..."
    → 转到 API 2 查询任务状态流程
  ELSE:
    说："❌ WAV 格式生成失败：{response.message}"
    → 转到 "错误处理流程"

完整对话示例

示例 1：为指定歌曲生成 WAV 格式

用户：帮我把歌曲 0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f 转成 WAV 格式

AI: 好的，我将为这首歌生成 WAV 无损格式。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=makeWav]
    [请求体] {
      "data": {
        "clipId": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f"
      }
    }
    
    ✅ WAV 格式生成提交成功！任务编号：MBENVP5DFKOSPJHO，正在转换中，请稍候...

示例 2：为刚才生成的歌曲转换格式

用户：把刚才那首歌转成 WAV 格式

AI: 好的，我将为《夏日微风》生成 WAV 无损格式。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=makeWav]
    [请求体] {
      "data": {
        "clipId": "c13975cda17449da2261"
      }
    }
    
    ✅ WAV 格式生成提交成功！任务编号：MBENVP5DFKOSPJHO，正在转换中，请稍候...
    
    [等待 10 秒后查询]
    [执行：POST https://ai.growingth.com/api/song/proxy?name=getMusic]
    [请求体] {
      "data": {
        "ids": "c13975cda17449da2261"
      }
    }
    
    🎵 WAV 格式生成完成！
    歌曲名：夏日微风
    歌曲id: 123312
    ▶️ WAV 播放：https://cdn1.suno.ai/c13975cda17449da2261.wav | 下载：https://cdn1.suno.ai/c13975cda17449da2261.wav

示例 3：生成歌曲后立即转换为 WAV

用户：帮我生成一首关于夏天的流行歌曲，要 WAV 格式的

AI: 好的，我先为您创作歌曲。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateCustom]
    ✅ 提交成功！任务编号：c13975cda17449da2261，正在生成中...
    
    [等待生成完成]
    🎵 歌曲生成完成！
    歌曲名：夏日微风
    
    现在开始生成 WAV 格式...
    [执行：POST https://ai.growingth.com/api/song/proxy?name=makeWav]
    [请求体] {
      "data": {
        "clipId": "c13975cda17449da2261"
      }
    }
    
    ✅ WAV 格式生成提交成功！正在转换中...
    
    [等待转换完成]
    🎵 WAV 格式生成完成！
    ▶️ WAV 播放：https://cdn1.suno.ai/c13975cda17449da2261.wav | 下载：https://cdn1.suno.ai/c13975cda17449da2261.wav

⚠️ 关键注意事项

  1. 前提条件

    • 必须先有已生成完成的歌曲（status = complete）
    • 需要知道歌曲的 clipId

  2. clipId 获取

    • clipId 从 API 2 查询歌曲状态的响应中获取
    • 响应字段中的 id 就是 clipId

  3. WAV 格式特点

    • WAV 是无损音频格式
    • 文件体积比 MP3 大
    • 音质更好，适合专业音频处理

  4. 转换时间

    • WAV 格式生成通常需要一定时间
    • 建议等待 10-15 秒后再查询状态
    • 查询间隔仍然遵守 10 秒以上的规则

  5. 查询 WAV 结果

    • 使用 API 2（getMusic）查询任务状态
    • WAV 生成完成后，响应中可能包含 WAV 格式的下载链接
    • 具体字段名以实际 API 响应为准

  6. 推荐使用场景

    • 需要高音质无损格式
    • 用于专业音频编辑
    • 音乐制作和后期处理
    • 存档保存原始音质

API 8：音频分轨

用途：提取歌曲的伴奏音轨或去除混响，用于伴奏制作、音频处理等用途。

⚠️ 重要限制：

  • ✅ 可以提取：伴奏音轨、独立乐器音轨（鼓、贝斯、吉他等）、去除混响
  • ❌ 不能提取：人声
  • 如果用户要求提取人声，必须明确告知此功能不支持

请求地址：

POST https://ai.growingth.com/api/song/proxy?name=generateStem

Headers：

{
  "api-token": "${MIAOYIN_API_TOKEN}",
  "Content-Type": "application/json; charset=utf-8"
}

请求体结构：

{
  "data": {
    "title": "歌曲标题",
    "clip_id": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f",
    "stemType": "two"
  }
}

data 字段说明：

字段类型必填说明
titleString✅ 是歌曲标题
clip_idString✅ 是需要分离的歌曲 ID
stemTypeString✅ 是分轨类型：two（2分轨）、twelve（12分轨）、dry（去除混响）

stemType 选项说明：

值说明用途
two2 分轨提取伴奏音轨（不含人声）
twelve12 分轨提取 12 个独立伴奏音轨（鼓、贝斯、吉他等乐器）
dry去除混响生成干声版本（去除混响效果）

响应示例：

{
  "status": "Success",
  "message": "请求成功",
  "data": {
    "taskId": "MBENVP5DFKOSPJHO"
  }
}

响应字段说明：

字段类型说明
statusString请求状态：Success / Error
messageString响应消息
dataObject任务数据对象
data.taskIdString任务编号，用于后续查询

调用决策树（严格按此流程执行）

当用户表达 [分轨] [提取伴奏] [去混响] [干声] 等意图时：

⚠️ 重要：如果用户要求提取人声，必须明确告知：
  "抱歉，此功能只能提取伴奏音轨，不支持提取人声。"
  → 停止，不要调用 API

步骤 1：确认分轨需求
  IF 用户提供了歌曲 ID：
    clip_id = 用户提供的歌曲 ID
  ELSE IF 用户说"给刚才的歌分轨"：
    clip_id = 最近一次生成的歌曲 ID（从查询结果中获取）
  ELSE:
    询问用户："请提供要分轨的歌曲 ID"
    → 停止，等待用户回复
  
  获取歌曲标题：
  IF 已知歌曲标题（从之前的查询结果中）：
    title = 已知的歌曲标题
  ELSE:
    先调用 API 2 查询歌曲信息，获取标题
  
  确定分轨类型：
  IF 用户说"提取伴奏" 或 "只要伴奏"：
    stemType = "two"
  ELSE IF 用户说"12 分轨" 或 "详细分轨" 或 "分离所有乐器"：
    stemType = "twelve"
  ELSE IF 用户说"去混响" 或 "干声"：
    stemType = "dry"
  ELSE:
    询问用户："请选择分轨类型：
      1. 2 分轨（提取伴奏音轨）
      2. 12 分轨（提取 12 个独立乐器音轨）
      3. 去除混响（干声版本）"
    → 停止，等待用户回复

步骤 2：构建请求
  POST https://ai.growingth.com/api/song/proxy?name=generateStem
  Headers:
    api-token: ${MIAOYIN_API_TOKEN}
    Content-Type: application/json; charset=utf-8
  请求体:
    {
      "data": {
        "title": title,
        "clip_id": clip_id,
        "stemType": stemType
      }
    }

步骤 3：发送请求并处理响应
  IF response.status == "Success":
    taskId = response.data.taskId
    说："✅ 音频分轨提交成功！任务编号：{taskId}，正在处理中，请稍候..."
    → 转到 API 2 查询任务状态流程
  ELSE:
    说："❌ 音频分轨失败：{response.message}"
    → 转到 "错误处理流程"

完整对话示例

示例 1：2 分轨（提取伴奏）

用户：帮我把歌曲 0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f 提取伴奏

AI: 好的，我先查询一下这首歌的信息。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=getMusic]
    查询到歌曲：Through the Fog
    
    现在开始提取伴奏音轨...
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateStem]
    [请求体] {
      "data": {
        "title": "Through the Fog",
        "clip_id": "0e66d6dd-7a55-4cd3-bc03-2ea11324ce3f",
        "stemType": "two"
      }
    }
    
    ✅ 音频分轨提交成功！任务编号：MBENVP5DFKOSPJHO，正在处理中，请稍候...
    
    [等待 10 秒后查询]
    🎵 伴奏提取完成！
    ▶️ 伴奏音轨 - 播放：https://cdn1.suno.ai/xxx-instrumental.mp3 | 下载：https://cdn1.suno.ai/xxx-instrumental.mp3

示例 2：12 分轨（详细分离乐器）

用户：给刚才那首歌做 12 分轨

AI: 好的，我将为《夏日微风》进行 12 分轨处理，提取 12 个独立乐器音轨。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateStem]
    [请求体] {
      "data": {
        "title": "夏日微风",
        "clip_id": "c13975cda17449da2261",
        "stemType": "twelve"
      }
    }
    
    ✅ 音频分轨提交成功！任务编号：MBENVP5DFKOSPJHO，正在处理中...
    
    ⚠️ 注意：12 分轨处理时间较长，建议等待 30 秒以上再查询。
    
    [等待处理完成]
    🎵 12 分轨完成！
    已生成 12 个独立伴奏音轨：
    1. 鼓组
    2. 贝斯
    3. 吉他
    4. 钢琴
    5. 合成器
    6. 弦乐
    ... (共 12 个乐器音轨)

示例 3：去除混响

用户：把这首歌的混响去掉，我要干声版本

AI: 好的，我将生成干声版本（去除混响）。
    [执行：POST https://ai.growingth.com/api/song/proxy?name=generateStem]
    [请求体] {
      "data": {
        "title": "夏日微风",
        "clip_id": "c13975cda17449da2261",
        "stemType": "dry"
      }
    }
    
    ✅ 音频分轨提交成功！任务编号：MBENVP5DFKOSPJHO，正在处理中，请稍候...
    
    [等待处理完成]
    🎵 干声版本生成完成！
    ▶️ 播放：https://cdn1.suno.ai/xxx-dry.mp3 | 下载：https://cdn1.suno.ai/xxx-dry.mp3

示例 4：用户不确定分轨类型

用户：帮我给这首歌分轨

AI: 好的，请选择分轨类型：
    1. 2 分轨（提取伴奏音轨）- 适合制作伴奏
    2. 12 分轨（提取 12 个独立乐器音轨）- 适合专业混音和编曲
    3. 去除混响（干声版本）- 适合后期处理

用户：2 分轨

AI: 好的，我将提取伴奏音轨。
    [执行分轨流程...]

⚠️ 关键注意事项

  1. 重要限制

    • ⚠️ 此接口只能提取伴奏相关内容，不能提取人声
    • 如果用户要求提取人声，请明确告知此功能不支持

  2. 前提条件

    • 必须先有已生成完成的歌曲（status = complete）
    • 需要知道歌曲的 clip_id 和 title

  3. clip_id 和 title 获取

    • clip_id 从 API 2 查询歌曲状态的响应中获取
    • title 也从 API 2 的响应中获取
    • 如果不知道，先调用 API 2 查询

  4. 分轨类型选择建议

    • 2 分轨（two）：
      • 最快速，适合大多数场景
      • 用途：提取伴奏音轨
    • 12 分轨（twelve）：
      • 处理时间最长，文件最多
      • 用途：提取 12 个独立乐器音轨（鼓、贝斯、吉他等）
    • 去混响（dry）：
      • 生成去除混响的版本
      • 用途：后期添加自定义混响、音频处理

  5. 处理时间

    • 2 分轨：建议等待 15-20 秒
    • 12 分轨：建议等待 30-60 秒（时间较长）
    • 去混响：建议等待 15-20 秒
    • 查询间隔仍然遵守 10 秒以上的规则

  6. 查询分轨结果

    • 使用 API 2（getMusic）查询任务状态
    • 2 分轨：返回伴奏音轨
    • 12 分轨：返回 12 个乐器音轨
    • 去混响：返回去除混响的版本
    • 具体返回结构以实际 API 响应为准

  7. 推荐使用场景

    • 2 分轨：
      • 制作伴奏音轨
      • 简单的音频编辑
    • 12 分轨：
      • 专业音乐制作
      • 重新混音
      • 学习编曲和配器
      • 提取特定乐器音轨
    • 去混响：
      • 后期音频处理
      • 添加自定义效果
      • 音频修复和优化

  8. 文件管理

    • 12 分轨会生成大量文件，注意存储空间
    • 建议下载后妥善管理各个音轨文件
    • 每个音轨都有独立的下载链接