API 使用指南

{
  "audio_url": "https://example.com/my-song.mp3"  // 音频文件的公开 URL
}

提交后拿到 task_id → 轮询查询 → 完成后从 result.custom_id 拿到音乐 ID，就可以用在延长/翻唱模式里了。

生成音乐 + 轮询查结果（JavaScript）

// 第一步：提交生成任务
const res = await fetch('/api/v1/music/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer 你的access_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    gpt_description_prompt: '一首轻快的夏日流行曲',
    make_instrumental: false,
    mv: 'chirp-v4',
    title: '夏日微风'
  })
})
const { data } = await res.json()
const taskIds = data.task_ids  // [204, 205] 两首歌

// 第二步：轮询查结果（以第一首为例）
for (let i = 0; i < 60; i++) {
  await new Promise(r => setTimeout(r, 5000))  // 等 5 秒
  const query = await fetch(
    `/api/v1/music/task?id=${taskIds[0]}`,
    { headers: { 'Authorization': 'Bearer 你的access_key' } }
  )
  const { data: task } = await query.json()

  if (task.status === 'completed') {
    console.log('音频地址:', task.result.fileInfo.mp3Url)
    console.log('音乐ID:', task.result.custom_id)  // 后续操作用这个
    break
  }
  if (task.status === 'failed') {
    console.error('生成失败:', task.result?.errormsg)
    break
  }
}