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"
  }
}
{
  "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": "",
        "audio_url": "https://cdn1.suno.ai/xxx.mp3",
        "image_url": "https://cdn2.suno.ai/image_xxxx.jpeg",
        "created_at": "2025-02-27T01:27:05.554Z",
        "timestamp": 1740590656617,
        "status": "first",
        "title": "",
        "prompt": "",
        "tags": "",
        "duration": 186,
        "model_name": "chirp-v3-5",
        "extra_message": "First audio generated successfully.",
        "fail_message": "",
        "error_message": ""
      },
      {
        "id": "",
        "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-02-27T01:27:05.554Z",
        "timestamp": 1740590656617,
        "status": "first",
        "title": "",
        "prompt": "",
        "tags": "",
        "duration": "",
        "model_name": "chirp-v3-5",
        "extra_message": "First audio generated successfully.",
        "fail_message": "",
        "error_message": ""
      }
    ],
    "created_at": "2025-01-01T22:10:31.665Z"
  }
}
{
  "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": "",
        "audio_url": "https://cdn1.suno.ai/xxx.mp3",
        "image_url": "https://cdn2.suno.ai/image_xxxx.jpeg",
        "created_at": "2025-02-27T01:27:05.554Z",
        "timestamp": 1740590656617,
        "status": "first",
        "title": "",
        "prompt": "",
        "tags": "",
        "duration": 186,
        "model_name": "chirp-v3-5",
        "extra_message": "First audio generated successfully.",
        "fail_message": "",
        "error_message": ""
      },
      {
        "id": "",
        "audio_url": "https://cdn1.suno.ai/xxx.mp3",
        "image_url": "https://cdn2.suno.ai/image_xxx.jpeg",
        "created_at": "2025-02-27T01:27:05.554Z",
        "timestamp": 1740590656617,
        "status": "first",
        "title": "",
        "prompt": "",
        "tags": "",
        "duration": "",
        "model_name": "chirp-v3-5",
        "extra_message": "All generated successfully.",
        "fail_message": "",
        "error_message": ""
      }
    ],
    "created_at": "2025-01-01T22:10:31.665Z"
  }
}
{
  "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": "",
        "audio_url": "",
        "image_url": "",
        "created_at": "",
        "timestamp": 1740590656617,
        "status": "first",
        "title": "",
        "prompt": "",
        "tags": "",
        "duration": 186,
        "model_name": "chirp-v3-5",
        "extra_message": "",
        "fail_message": "Does Not Meet Guidelines",
        "error_message": ""
      },
      {
        "id": "",
        "audio_url": "",
        "image_url": "",
        "created_at": "",
        "timestamp": 1740590656617,
        "status": "first",
        "title": "",
        "prompt": "",
        "tags": "",
        "duration": "",
        "model_name": "chirp-v3-5",
        "extra_message": "",
        "fail_message": "Does Not Meet Guidelines",
        "error_message": ""
      }
    ],
    "created_at": "2025-01-01T22:10:31.665Z"
  }
}
{
  "code": 404,
  "message": "Task not found"
}
{
  "code": 500,
  "message": "Internal Server Error"
}

curlCommand

curl -X GET "https://udioapi.pro/api/v2/feed?workId=xxx"