API Endpoints

Task Status

GET/v2/feed?workId=xxx

Music Generate Task Status API

Fetch the status and results of a Music Generate task.

GEThttps://udioapi.pro/api/v2/feed?workId=xxx

tips

Use this endpoint to poll task status after generation.

Stages: text, first, complete.

Poll every 5-10 seconds until success or failure.

requestParams

paramNameparamTyperequireddescription
workIdstringyesThe unique ID of the music generation task.

responses

json
{
  "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"
  }
}
json
{
  "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"
  }
}
json
{
  "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"
  }
}
json
{
  "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"
  }
}
json
{
  "code": 404,
  "message": "Task not found"
}
json
{
  "code": 500,
  "message": "Internal Server Error"
}