Query Results

query generation results api, use workId to check generation status and get the final results

Query Generation Results

API Endpoint

URL: GET https://udioapi.pro/api/v2/feed
Query Parameter: workId

Code Examples

curl -X GET "https://udioapi.pro/api/v2/feed?workId=16e2dff2-9896-4ac9-a050-5bca6e83904e"

Response Format

A successful response will return a JSON object with the following structure:

Normally, music generation goes through three stages: text, first, and complete.

Once the lyrics generation is completed

{
    "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://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": "d23efe77-b463-4ee5-8a7c-6476d45a6656",
                "audio_url": "https://audiopipe.suno.ai/?item_id=d23efe77-b463-4ee5-8a7c-6476d45a6656",
                "image_url": "https://cdn2.suno.ai/image_d23efe77-b463-4ee5-8a7c-6476d45a6656.jpeg",
                "image_large_url": "https://cdn2.suno.ai/image_d23efe77-b463-4ee5-8a7c-6476d45a6656.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"
    }
}

First audio generated successfully Response

{
    "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"
    }
}

All two audios generated successfully Response

{
    "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_xxx.jpeg",
                "image_large_url": "https://cdn2.suno.ai/image_xxx.jpeg",
                "created_at": "2025-01-01T22:10:31.665Z",
                "timestamp": 1740620001575,
                "status": "complete",
                "title": "",
                "prompt": "",
                "tags": "",
                "duration": 168.92,
                "model_name": "chirp-v3-5",
                "extra_message": "All generated successfully.",
                "fail_message": "",
                "error_message": ""
            },
            {
                "id": "",
                "audio_url": "https://cdn1.suno.ai/xxx.mp3",
                "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": 1740620001575,
                "status": "complete",
                "title": "",
                "prompt": "",
                "tags": "",
                "duration": 89.08,
                "model_name": "chirp-v3-5",
                "extra_message": "All generated successfully.",
                "fail_message": "",
                "error_message": ""
            }
        ],
        "created_at": "2025-01-01T22:10:31.665Z"
    }
}

Response Fields

Field	Type	Description
code	number	HTTP status code
message	string	Response message
data.type	string	Result type ("SUCCESS", "IN_PROGRESS", etc.)
data.request_body	object	Original generation request parameters
data.response_data	array	Array of generated results
data.created_at	string	Timestamp of the generation request

Generated Result Fields

Field	Type	Description
id	string	Unique identifier of the generated result
audio_url	string	URL to the generated audio file (MP3)
image_url	string	URL to the generated cover image
image_large_url	string	URL to the high-resolution cover image, now unused
created_at	string	Timestamp of the result creation
timestamp	number	Unix timestamp in milliseconds
status	string	Status of the generation ("complete", "pending", etc.)
title	string	Title of the generated music
prompt	string	Original prompt used for generation
tags	string	Style tags of the generated music
duration	number	Duration of the generated audio in seconds
model_name	string	Name of the model used for generation
extra_message	string	Additional success information message
fail_message	string	Failure message if generation failed
error_message	string	Error message if any errors occurred

fail_message sample

Suno Official Regulatory restrictions：
Does Not Meet Guidelines
Prompt contained inappropriate material
This song violates Suno's content moderation policy.

500 Audio generation failed.
500 Internal Error, Please try again later.
408 timeout

Generate

Generate With Callback

On This Page

Query Generation Results