Get Music Task Status
Get Music Task Status
Query the status and result of a Suno music task
- 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
AuthorizationstringheaderrequiredBearer Token. Get your API Key: API Key management
Path Parameters
task_idstringpathrequiredTask ID returned by the music generation API (tsk_aud_ prefix)
Response
idstringTask ID
statusstringsubmitted / queued / in_progress / completed / failed
progressintegerProgress 0-100
costnumberActual upstream cost (USD)
createdintegerCreated timestamp (Unix)
completedintegerCompleted timestamp (Unix)
resultobjectTask result; structure varies by operation:
result structure
musicarrayTracks with audio_url, image_url, title, tags, lyrics, duration
instrumentsarraymidi result: per-instrument name/program/is_drum/notes[]
filesarraydownload result: multi-format file URLs
videoUrlstringgenerateMp4 result: video URL
avg_bpmnumberbpm result (also max_bpm/min_bpm)
errorobjectError 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"])