v1
latestOpenAPI 3.1.02026-07-2611077199.5 KBget/suno/v1/fetch
Query parameters
jobIdstring required
Job ID returned by the generation request
Response
Request successful
Example response
{
"status": "SUCCESS",
"message": "success",
"jobId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"data": {
"jobId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"action": "music",
"progress": "100%",
"mv": "chirp-v5",
"quota": "6",
"hookUrl": "https://webhook-test.com/ed9731f4026f04e7c0cfa99e41d2b2fc",
"musics": [
{
"musicId": "xxxxxxxxxxxxxxxxx",
"prompt": "xxxxxxxxxxxxxxxxxx",
"title": "xxxxx",
"tags": "xxxxx",
"imageUrl": "https://cdn2.suno.ai/xxxxxxxxxxxxxxxxx.jpeg",
"imageLargeUrl": "https://cdn2.suno.ai/xxxxxxxxxxxxxx.jpeg",
"audioUrl": "https://cdn1.suno.ai/xxxxxxxxxxxxxxx.mp3",
"videoUrl": "https://cdn1.suno.ai/xxxxxxxxxxxxxxx.mp4",
"duration": "211.44",
"negativeTags": "xxxxxxxxxxxxxxxxxxx",
"styleWeight": null,
"weirdnessConstraint": null,
"audioWeight": null,
"createdAt": "2026-03-03T02:23:51.401Z"
}
]
}
}