Skip to main content

​
Endpoint

POST /api/v1/music/{id}
Returns details for a single music result. Each task may produce multiple music results — use Get Task to list them all, then use this endpoint to fetch individual results.

​
Path parameter

ParameterDescription
idMusic result ID (from results[].id in Get Task response)

​
Response

{
  "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": "My Track",
    "duration": 87.4,
    "tags": "pop upbeat",
    "prompt": "An upbeat pop track",
    "expire_at": 1710604800000
  }
}
FieldTypeDescription
idstringMusic result ID (the clip_id used in audio processing endpoints)
audio_urlstringMP3 download URL
image_urlstringCover art URL
titlestringTrack title
durationfloatDuration in seconds
tagsstringStyle tags
promptstringGeneration prompt
expire_atintegerUnix timestamp (ms) when the file expires. 0 = no expiry.

​
Error: expired result

If expire_at has passed, the endpoint returns: 
{
  "code": 4005,
  "message": "Music result has expired",
  "request_id": "req-1710000000000"
}

​
Example

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 '{}'