English

简体中文

English

简体中文
中文

GET /udio/fetch/ ​

Method: GETEndpoint: /udio/fetch/{task_id}

This section contains endpoint-specific behavior, parameters, or usage notes for this API.

Request Parameters ​

Path Parameters ​

text
task_id
string
Task ID
Required

Header Parameters ​

text
Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Example Request ​

Shell ​

bash
curl --location --request GET '/udio/fetch/' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}'

Response ​

🟢 200 Success ​

Content Type: application/json

Response Schema ​

text
code
string
Required
message
string
Required
data
object
Required
task_id
string
Required
notify_hook
string
Required
action
string
Required
status
string
Required
fail_reason
string
Required
submit_time
integer
Required
start_time
integer
Required
finish_time
integer
Required
progress
string
Required
data
object
Required

Example ​

json
{
    "code": "success",
    "message": "",
    "data": {
        "task_id": "4232a6c9-c293-4eec-b396-e78221120e13",
        "notify_hook": "",
        "action": "udio-generate",
        "status": "SUCCESS",
        "fail_reason": "",
        "submit_time": 1730993284,
        "start_time": 1730993497,
        "finish_time": 1730993911,
        "progress": "100%",
        "data": {
            "songs": [
                {
                    "artist": "TraditionalTabla2803",
                    "artist_image": "https://lh3.googleusercontent.com/a/ACg8ocLyeNbOgAtI0tmcohNAV7C9hRnIVlGqaeOOcW0ZSgg4VQEYXQ=s96-c",
                    "attribution": "",
                    "audio_conditioning_type": null,
                    "created_at": "2024-11-07T15:24:52.280417+00:00",
                    "description": "",
                    "disliked": false,
                    "duration": 32.8106666666667,
                    "error_code": null,
                    "error_detail": null,
                    "error_id": null,
                    "error_type": null,
                    "finished": true,
                    "generation_id": "4232a6c9-c293-4eec-b396-e78221120e13",
                    "id": "2ff9b3fb-842b-4a70-9708-61210edc2867",
                    "image_path": "https://imagedelivery.net/C9yUr1FL21Q6JwfYYh2ozQ/63006f79-2b52-4784-9975-0a8dbbc7c200/public",
                    "liked": false,
                    "likes": 0,
  // provider-specific example normalized for English documentation
                    "original_song_path": null,
                    "plays": 0,
                    "prompt": "Example prompt from provider documentation.",
                    "publishable": true,
                    "published_at": null,
                    "replaced_tags": {
                        "male vocalist, adult contemporary, pop soul, pop, love, mellow, melodic, romantic": {
                            "tags": [
                                "male vocalist",
                                "pop",
                                "pop soul",
                                "melodic",
                                "love",
                                "romantic",
                                "adult contemporary",
                                "mellow"
                            ],
                            "type": "tags"
                        },
                        "melodic, emotional, contemporary, R&B, male vocalist, mandopop": {
                            "tags": [
                                "male vocalist",
                                "adult contemporary",
                                "pop soul",
                                "pop",
                                "love",
                                "mellow",
                                "melodic",
                                "romantic"
                            ],
                            "type": "tags"
                        }
                    },
                    "song_path": "https://storage.googleapis.com/udio-artifacts-c33fe3ba-3ffe-471f-92c8-5dfef90b3ea3/samples/5945acbaf0094ba19b246932c4534ed2/1/Eternal%2520Waves%2520of%2520Emotion.mp3",
                    "tags": [
                        "male vocalist",
                        "pop",
                        "pop soul",
                        "melodic",
                        "love",
                        "romantic",
                        "adult contemporary",
                        "mellow"
                    ],
                    "title": "Eternal Waves of Emotion",
                    "user_id": "289624f6-c4f0-4a22-a1f4-43d8bac3a9b2",
                    "user_tags": [],
                    "video_path": null
                },
                {
                    "artist": "TraditionalTabla2803",
                    "artist_image": "https://lh3.googleusercontent.com/a/ACg8ocLyeNbOgAtI0tmcohNAV7C9hRnIVlGqaeOOcW0ZSgg4VQEYXQ=s96-c",
                    "attribution": "",
                    "audio_conditioning_type": null,
                    "created_at": "2024-11-07T15:24:52.280417+00:00",
                    "description": "",
                    "disliked": false,
                    "duration": 32.8106666666667,
                    "error_code": null,
                    "error_detail": null,
                    "error_id": null,
                    "error_type": null,
                    "finished": true,
                    "generation_id": "4232a6c9-c293-4eec-b396-e78221120e13",
                    "id": "f4307fca-13bb-4fdc-bd6a-db8459a81a51",
                    "image_path": "https://imagedelivery.net/C9yUr1FL21Q6JwfYYh2ozQ/172352d3-1199-4b2f-2e46-05fef728ce00/public",
                    "liked": false,
                    "likes": 0,
  // provider-specific example normalized for English documentation
                    "original_song_path": null,
                    "plays": 0,
                    "prompt": "Example prompt from provider documentation.",
                    "publishable": true,
                    "published_at": null,
                    "replaced_tags": {
                        "male vocalist, pop, romantic, melodic, love": {
                            "tags": [
                                "male vocalist",
                                "pop",
                                "melodic",
                                "romantic",
                                "love"
                            ],
                            "type": "tags"
                        },
                        "melodic, romantic, male vocalist, Mandopop, catchy, pop": {
                            "tags": [
                                "male vocalist",
                                "pop",
                                "romantic",
                                "melodic",
                                "love"
                            ],
                            "type": "tags"
                        }
                    },
                    "song_path": "https://storage.googleapis.com/udio-artifacts-c33fe3ba-3ffe-471f-92c8-5dfef90b3ea3/samples/5945acbaf0094ba19b246932c4534ed2/2/Echoes%2520of%2520Affection.mp3",
                    "tags": [
                        "male vocalist",
                        "pop",
                        "melodic",
                        "romantic",
                        "love"
                    ],
                    "title": "Echoes of Affection",
                    "user_id": "289624f6-c4f0-4a22-a1f4-43d8bac3a9b2",
                    "user_tags": [],
                    "video_path": null
                }
            ]
        }
    }
}

YutoAI © 2021-2026