GET /v2/feed?workId=xxx
Fetch the status and results of a generation task.
GEThttps://udioapi.pro/api/v2/feed?workId=xxx
tips
After starting a generation task, use this endpoint to poll for its status.
Generation has 3 stages:
- Text Stage: status="text" - Lyrics and metadata generated
- First Audio Stage: status="first" - First audio segment generated successfully
- Complete Stage: status="first" with "All generated successfully." - Both audio segments finished
Failure Detection: Check fail_message
field for errors like:
- "Does Not Meet Guidelines"
- "Prompt contained inappropriate material"
- "This song violates Suno's content moderation policy"
Poll this endpoint every 5-10 seconds until generation completes or fails.
responses
{
"code": 200,
"message": "success",
"data": {
"type": "SUCCESS",
"request_body": {
"prompt": "prompt sample",
"title": "title sample",
"tags": "tags sample",
"make_instrumental": false,
"model": "chirp-v3-5"
},
"response_data": [
{
"id": "xxx",
"audio_url": "https://audiopipe.suno.ai/?item_id=xxx",
"image_url": "https://cdn2.suno.ai/image_xxx.jpeg",
"image_large_url": "https://cdn2.suno.ai/image_xxx.jpeg",
"created_at": "2025-01-01T22:10:31.665Z",
"timestamp": 1740620331100,
"status": "text",
"title": "",
"prompt": "",
"tags": "",
"duration": "",
"model_name": "chirp-v3-5",
"extra_message": "Text generated successfully.",
"fail_message": "",
"error_message": ""
},
{
"id": "xxx",
"audio_url": "https://audiopipe.suno.ai/?item_id=xxx",
"image_url": "https://cdn2.suno.ai/image_xxxx.jpeg",
"image_large_url": "https://cdn2.suno.ai/image_xxx.jpeg",
"created_at": "2025-01-01T22:10:31.665Z",
"timestamp": 1740620331100,
"status": "text",
"title": "",
"prompt": "",
"tags": "",
"duration": "",
"model_name": "chirp-v3-5",
"extra_message": "Text generated successfully.",
"fail_message": "",
"error_message": ""
}
],
"created_at": "2025-01-01T22:10:31.665Z"
}
}
curlCommand
curl -X GET "https://udioapi.pro/api/v2/feed?workId=xxx"