跳转到主要内容

​
接口

POST /api/v1/music/add-instrumental
异步接口。 返回 task_id，通过 获取任务 轮询结果。 将人声音频片段（通过 音频上传 上传）与 AI 生成的器乐伴奏合成为完整歌曲。

​
请求参数

字段类型是否必填说明
clip_idstring必填人声音频的 Clip ID（来自 音频上传）
start_sfloat否使用片段的起始时间（秒）。默认 0。
end_sfloat否使用片段的结束时间（秒）。默认 0（使用完整片段）。
mvstring否模型版本（如 "chirp-v3-5"）。省略则使用默认版本。
callback_urlstring否任务完成时的 Webhook 回调 URL。参见 Webhook 回调。
retention_daysinteger否音频文件保存天数。默认 7。

​
响应

{
  "code": 0,
  "message": "ok",
  "request_id": "req-1710000000000",
  "data": {
    "task_id": "64f3a1b2c8d9e0f1a2b3c4d5",
    "status": "queuing"
  }
}

​
使用流程

  1. 通过 音频上传 上传人声音频 → 获取 clipId
  2. 调用本接口，传入 clipId → 获取 task_id
  3. 轮询 获取任务 直到 status = "completed"
  4. 通过 results[].audio_url 获取生成的歌曲

​
示例

# 1. 上传人声音频
CLIP_ID=$(curl -s -X POST https://api.example.com/api/v1/music/upload \
  -H "Authorization: Bearer sk-mm-your-key" \
  -H "Content-Type: application/json" \
  -d '{"audio_url":"https://example.com/my-vocals.mp3"}' \
  | jq -r '.data.clipId')

# 2. 添加伴奏
curl -X POST https://api.example.com/api/v1/music/add-instrumental \
  -H "Authorization: Bearer sk-mm-your-key" \
  -H "Content-Type: application/json" \
  -d "{
    \"clip_id\": \"$CLIP_ID\",
    \"start_s\": 0,
    \"end_s\": 30
  }"