ToAPIsToAPIs
Get Music Task Status

Get Music Task Status

Query the status and result of a Suno music task

GET
/v1/music/tasks/{task_id}
  • Query async music task status and results
  • Real-time progress tracking
  • Retrieve audio, cover, and video URLs (mirrored to our CDN) on completion
  • Failed tasks are refunded automatically

All music tasks run asynchronously. Poll this endpoint after submission.

Authorizations

Authorizationstringheaderrequired

Bearer Token. Get your API Key: API Key management

Path Parameters

task_idstringpathrequired

Task ID returned by the music generation API (tsk_aud_ prefix)

Response

idstring
Task ID
statusstring

submitted / queued / in_progress / completed / failed

progressinteger
Progress 0-100
costnumber
Actual upstream cost (USD)
createdinteger
Created timestamp (Unix)
completedinteger
Completed timestamp (Unix)
resultobject

Task result; structure varies by operation:

result structure
musicarray

Tracks with audio_url, image_url, title, tags, lyrics, duration

instrumentsarray

midi result: per-instrument name/program/is_drum/notes[]

filesarray

download result: multi-format file URLs

videoUrlstring

generateMp4 result: video URL

avg_bpmnumber

bpm result (also max_bpm/min_bpm)

errorobject
Error info on failure (code/message)

requestExample

curl --request GET \
  --url https://toapis.com/v1/music/tasks/tsk_aud_01M3EXAMPLE \
  --header 'Authorization: Bearer <token>'
import time
import requests

task_id = "tsk_aud_01M3EXAMPLE"
while True:
    resp = requests.get(
        f"https://toapis.com/v1/music/tasks/{task_id}",
        headers={"Authorization": "Bearer <token>"}
    ).json()["data"]
    if resp["status"] in ("completed", "failed"):
        break
    time.sleep(5)
print(resp["result"])