跳转到主要内容

​
接口

POST /api/v1/music/{id}
返回单个音乐结果的详情。每个任务可能生成多个音乐结果 — 使用 获取任务 查看全部结果，再通过本接口获取单个结果详情。

​
路径参数

参数说明
id音乐结果 ID（来自获取任务响应中的 results[].id）

​
响应

{
  "code": 0,
  "message": "ok",
  "request_id": "req-1710000000000",
  "data": {
    "id": "clip-abc123",
    "audio_url": "https://cdn.example.com/tob/gen/abc123.mp3",
    "image_url": "https://cdn.example.com/tob/gen/abc123.jpg",
    "title": "我的曲目",
    "duration": 87.4,
    "tags": "流行 欢快",
    "prompt": "一首欢快的流行曲",
    "expire_at": 1710604800000
  }
}
字段类型说明
idstring音乐结果 ID（即音频处理接口中使用的 clip_id）
audio_urlstringMP3 下载 URL
image_urlstring封面图片 URL
titlestring曲目标题
durationfloat时长（秒）
tagsstring风格标签
promptstring生成描述
expire_atinteger文件过期的 Unix 时间戳（毫秒）。0 = 永不过期。

​
错误：结果已过期

若 expire_at 已过，接口返回： 
{
  "code": 4005,
  "message": "Music result has expired",
  "request_id": "req-1710000000000"
}

​
示例

curl -X POST https://api.example.com/api/v1/music/clip-abc123 \
  -H "Authorization: Bearer sk-mm-your-key" \
  -H "Content-Type: application/json" \
  -d '{}'