跳转到主要内容
GET
查询音乐生成详情

使用指南

  • 音乐系列中的所有 POST 提交请求都可以通过此接口查询结果。不同模型返回的响应字段不同。

参数详情

  • task_id(必填):音乐生成提交接口返回的唯一任务标识

使用说明

  • 轮询此接口以检查任务完成状态
  • 任务状态变为 finished 之前,files 数组为空
  • 任务失败时,查看 error_message 字段获取详情
  • 单个任务生成多个变体时,可能返回多个音频文件

files 数据响应字段

files 数组的内容取决于创建任务的模型。

JSON 字段详情

separate-vocals

separate_vocals 字段:
  • vocal_url - 提取出的人声音轨 URL
  • instrumental_url - 伴奏音轨 URL

upload-and-separate-vocals

vocal_removal 字段:
  • bass - 贝斯音轨 URL
  • drums - 鼓音轨 URL
  • piano - 钢琴音轨 URL
  • guitar - 吉他音轨 URL
  • vocals - 人声音轨 URL
  • other - 其他音频元素 URL

stem-split

stem_split 字段:
  • backing_vocals_url - 和声 URL
  • bass_url - 贝斯音轨 URL
  • brass_url - 铜管乐器 URL
  • drums_url - 鼓音轨 URL
  • fx_url - 音效 URL
  • guitar_url - 吉他音轨 URL
  • keyboard_url - 键盘音轨 URL
  • percussion_url - 打击乐音轨 URL
  • strings_url - 弦乐音轨 URL
  • synth_url - 合成器音轨 URL
  • vocal_url - 主唱人声 URL
  • woodwinds_url - 木管乐器音轨 URL

generate-music-cover

generate_cover 是包含封面图对象的 JSON 数组:
  • file_url - 生成的封面图 URL
  • file_type - 文件类型(例如 “image”)

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证

获取 API Key:

进入 仪表盘 → API 密钥(API Key 管理页面)获取你的 API Key

在请求头中添加:

查询参数

task_id
string
必填

音乐生成提交接口返回的唯一任务标识。

响应

200 - application/json

任务详情获取成功

code
integer
必填

HTTP 状态码

示例:

200

data
object
必填