Suno
Query Result
Suno music / lyrics async task result query endpoint
Queries the status and result of a Suno music / lyrics async generation task by task ID. After submitting a music / lyrics generation task, poll this endpoint with the returned task_id until the task completes.
Task status
QUEUED/IN_PROGRESS: still running,progressshows the progress — retry later;SUCCESS: completed;result_urlholds the final audio URL (music tasks) anddatacontains song details or lyrics;FAILURE: failed;fail_reasonexplains why.
Audio URLs are temporary
The generated audio URLs are temporary upstream CDN URLs and may expire after a while — download them in time if you need long-term storage.
Authorization
BearerAuth
AuthorizationBearer <token>
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
令牌需开通对应模型的调用权限。
In: header
Path Parameters
id*string
提交音乐 / 歌词生成任务时返回的任务 ID（data 字段）
Response Body
application/json
application/json
curl -X GET "https://www.omwai.xyz/suno/fetch/task_01J8ABCDEFGHIJKLMNOPQRST"{
"code": "success",
"data": {
"task_id": "task_01J8ABCDEFGHIJKLMNOPQRST",
"platform": "ttapi-suno",
"action": "MUSIC",
"status": "SUCCESS",
"progress": "100%",
"fail_reason": "",
"result_url": "https://cdn1.suno.ai/xxxxxxxxxxxxxxxxx.mp3",
"submit_time": 1788500000,
"finish_time": 1788500200,
"data": {
"musics": [
{
"musicId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"title": "Midnight Drive",
"tags": "synthwave, female vocal, cinematic",
"audioUrl": "https://cdn1.suno.ai/xxxxxxxxxxxxxxxxx.mp3",
"videoUrl": "https://cdn1.suno.ai/xxxxxxxxxxxxxxxxx.mp4",
"duration": 211.44
}
]
}
}
}{
"code": "task_not_exist",
"message": "string"
}Note
Only tasks created under the current account can be queried. Missing or unauthorized tasks return 400 task_not_exist.
How is this guide?
Last updated on