API reference
🇺🇸 English
  • 🇨🇳 Chinese
  • 🇺🇸 English
  1. Udio
API reference
🇺🇸 English
  • 🇨🇳 Chinese
  • 🇺🇸 English
  • Chat Models
    • Chat
      • Create chat completion
      • vision
    • OpenAI-Realtime
    • Completions
      • Instruct
    • Audio
      • Transcriptions
      • Translations
      • Speech
    • Image generation
      • DALL·E 3
    • Embeddings
      • Create
    • Models
      • model list
    • Help
      • 常见问题及解决办法
  • Anthropic
    • Anthropic Claude
      POST
  • Suno
    • Generate music
      POST
    • Generate lyrics
      POST
    • Upload music
      POST
    • Music concat
      POST
    • Fetch task
      GET
    • Fetch batch tasks
      POST
  • Udio
    • Generate music
      POST
    • Fetch task
      GET
  • Midjourney API
    • Quick
    • Task Submit
      • Imagine
      • Action
      • Modal
      • Blend
      • Describe
      • Shorten
      • Upload discord
    • Get Task
      • Fetch task by ids
      • Fetch task by id
      • Get seed
  • Flux
    • Official
      • Generate
      • Finetune
      • Fetch task
    • OpenAI Dalle3
      POST
  • Recraft
    • Official
      • Generate Image
      • Vectorize Image
      • Remove Background
      • Clarity Upscale
      • Generative Upscale
      • Create style
    • OpenAI Dalle3
      POST
  • Ideogram
    • Generate
    • Remix
    • Edit
    • Upscale
    • Describe
  • Luma
    • Official
      • Generate
      • Fetch task
    • Own format
      • Submit
        • Generate
        • Get video of no mark
        • 扩展视频
      • Get task
        • Get task
        • Get batch task
  • Runway
    • Official
      • image to video
      • get task
    • reverse
      • text to video
      • image to video
      • video2video
      • Act-one
      • Get task
  • Kling-API
    • Callback
    • Generate image
    • Text 2 Video
    • Image 2 Video
    • Video extend
    • Get task
    • lip-sync
    • kolors-virtual-try-on
  • Replicate
    • Generate
    • Get
  • MiniMax
    • Generate video
    • Get task
    • Get file
  1. Udio

Fetch task

GET
/udio/query
Last modified:2025-02-05 11:20:06

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
ids
string 
optional
Example:
4f6532fa-ef6f-495b-a7fe-98b58453c9bc,632ac4b3-83e0-4e52-8d92-57268ffdf116
Header Params
Authorization
string 
optional
Default:
{{YOUR_API_KEY}}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '/udio/query?ids=4f6532fa-ef6f-495b-a7fe-98b58453c9bc,632ac4b3-83e0-4e52-8d92-57268ffdf116' \
--header 'Authorization: '

Responses

🟢200成功
application/json
Body
songs
array [object {31}] 
required
artist
string 
required
artist_image
string 
required
attribution
string 
required
audio_conditioning_type
null 
required
created_at
string 
required
description
string 
required
disliked
boolean 
required
duration
number 
required
error_code
null 
required
error_detail
null 
required
error_id
null 
required
error_type
null 
required
finished
boolean 
required
generation_id
string 
required
id
string 
required
image_path
string 
required
liked
boolean 
required
likes
integer 
required
lyrics
string 
required
original_song_path
null 
required
plays
integer 
required
prompt
string 
required
publishable
boolean 
required
published_at
null 
required
replaced_tags
object 
required
song_path
string 
required
tags
array[string]
required
title
string 
required
user_id
string 
required
user_tags
array[string]
required
video_path
null 
required
Example
{
  "songs": [
    {
      "artist": "IntenseOud7926",
      "artist_image": "https://lh3.googleusercontent.com/a/ACg8ocKvJm3a7aflzezMn2Px3z53YQ8ohs_6W9FIfVkkO8ZiZ-1fMQ=s96-c",
      "attribution": "",
      "audio_conditioning_type": null,
      "created_at": "2024-11-04T15:47:35.363658+00:00",
      "description": "",
      "disliked": false,
      "duration": 32.8106666666667,
      "error_code": null,
      "error_detail": null,
      "error_id": null,
      "error_type": null,
      "finished": true,
      "generation_id": "ffbd57bd-b024-4088-a49c-dcbeaf429725",
      "id": "4f6532fa-ef6f-495b-a7fe-98b58453c9bc",
      "image_path": "https://imagedelivery.net/C9yUr1FL21Q6JwfYYh2ozQ/146dbe33-0109-45ed-7750-1bbe25da2e00/public",
      "liked": false,
      "likes": 0,
      "lyrics": "[Verse]\nWhen the echoes are all we hear\nAnd the stars fade, far and near\nThe whispering winds finally clear\nA moment of truth, our greatest fear\n\n[Chorus]\nThe last song ever sung\nAs the earth breathes its final hum\nMelodies of hope unsprung\nAnd the world in a gentle strum",
      "original_song_path": null,
      "plays": 0,
      "prompt": "The last song ever sung on the planet earth",
      "publishable": true,
      "published_at": null,
      "replaced_tags": {
        "alternative, acoustic, pop, indie pop, serene, emotional, reflective": {
          "tags": [
            "twee pop",
            "indie pop",
            "jangle pop",
            "neo-acoustic",
            "pop",
            "alternative rock",
            "indie rock",
            "rock",
            "sunshine pop",
            "female vocalist",
            "longing",
            "peaceful",
            "nature",
            "lush",
            "introspective",
            "melodic",
            "summer",
            "bittersweet",
            "passionate",
            "soft",
            "uplifting",
            "energetic",
            "depressive"
          ],
          "type": "tags"
        },
        "twee pop, indie pop, jangle pop, neo-acoustic, pop, alternative rock, indie rock, rock, sunshine pop, female vocalist, longing, peaceful, nature, lush, introspective, melodic, summer, bittersweet, passionate, soft, uplifting, energetic, depressive": {
          "tags": [
            "female vocalist",
            "rock",
            "pop",
            "indie pop",
            "alternative rock",
            "twee pop",
            "melodic",
            "uplifting"
          ],
          "type": "tags"
        }
      },
      "song_path": "https://storage.googleapis.com/udio-artifacts-c33fe3ba-3ffe-471f-92c8-5dfef90b3ea3/samples/be90492af2494d349ab1fd7737867931/1/Final%2520Echoes.mp3",
      "tags": [
        "female vocalist",
        "rock",
        "pop",
        "indie pop",
        "alternative rock",
        "twee pop",
        "melodic",
        "uplifting"
      ],
      "title": "Final Echoes",
      "user_id": "26bd7dea-8962-46b8-8a0c-27a9744dc44d",
      "user_tags": [],
      "video_path": null
    },
    {
      "artist": "EYST HINE",
      "artist_image": "https://lh3.googleusercontent.com/a/ACg8ocIV_Kca-ymVEPKytDhlIZHFCG73Z7GFqb02F91WOcy1tkGCTA=s96-c",
      "attribution": "",
      "audio_conditioning_type": null,
      "created_at": "2024-11-06T13:29:08.035421+00:00",
      "description": "",
      "disliked": false,
      "duration": 131.114666666667,
      "error_code": null,
      "error_detail": null,
      "error_id": null,
      "error_type": null,
      "finished": true,
      "generation_id": "78decf9d-70de-45cb-bb13-18fb03800113",
      "id": "632ac4b3-83e0-4e52-8d92-57268ffdf116",
      "image_path": "https://imagedelivery.net/C9yUr1FL21Q6JwfYYh2ozQ/e1f79fad-dd62-4849-7a3a-d6644054b100/public",
      "liked": false,
      "likes": 0,
      "lyrics": "-verse 1-\nLast light fading on this spinning sphere\nVoices rising, final echoes we hear (yeah)\nDancing in the shadows, no tomorrow bound\nLife’s a melody with a chaotic sound\nWe’re the last survivors, singing it loud\nIn this urban jungle, crowds and clouds\n\n-chorus-\nSing it loud, can you feel the beat?\nFinal rhythm in the city streets\nManic hearts lost in the night\nDance with me till morning light\n\n-verse 2-\nConcrete jungle, only stars align (yeah)\nWe blaze a trail, shadows intertwine\nMood’s electric, hedonistic chase\nChasing dreams in this final race\nMadness colors every note and line\nEchoes of the last urban sunshine\n\n-chorus-\nSing it loud, can you feel the beat?\nFinal rhythm in the city streets\nManic hearts lost in the night\nDance with me till morning light\n\n-bridge-\nEarth's song ending with a wild embrace\nLove and chaos, one final space\nLet's make this count, the end is near\nIn our hearts, we hold this moment dear\n\n-chorus-\nSing it loud, can you feel the beat?\nFinal rhythm in the city streets\nManic hearts lost in the night\nDance with me till morning light",
      "original_song_path": null,
      "plays": 0,
      "prompt": "The last song ever sung on the planet earth",
      "publishable": true,
      "published_at": null,
      "replaced_tags": {
        "electropop, synthpop, new rave, electroclash, dance-punk, alternative r&b, alternative dance, energetic, manic, rhythmic, melodic, urban, drugs, hedonistic, 2010s, male vocalist": {
          "tags": [
            "male vocalist",
            "rhythmic",
            "energetic",
            "dance-punk",
            "urban",
            "melodic",
            "drugs",
            "hedonistic",
            "manic",
            "alternative r&b",
            "2010s"
          ],
          "type": "tags"
        },
        "pop": {
          "tags": [
            "electropop",
            "synthpop",
            "new rave",
            "electroclash",
            "dance-punk",
            "alternative r&b",
            "alternative dance",
            "energetic",
            "manic",
            "rhythmic",
            "melodic",
            "urban",
            "drugs",
            "hedonistic",
            "2010s",
            "male vocalist"
          ],
          "type": "tags"
        }
      },
      "song_path": "https://storage.googleapis.com/udio-artifacts-c33fe3ba-3ffe-471f-92c8-5dfef90b3ea3/samples/d21ef5e6d9c549a2a14117384f3743f1/1/Echoes%2520of%2520Tomorrow.mp3",
      "tags": [
        "male vocalist",
        "rhythmic",
        "energetic",
        "dance-punk",
        "urban",
        "melodic",
        "hedonistic",
        "manic",
        "alternative r&b",
        "2010s"
      ],
      "title": "Echoes of Tomorrow",
      "user_id": "9c6984d5-4043-44d7-bef0-6c0a538fa576",
      "user_tags": [],
      "video_path": null
    }
  ]
}
Previous
Generate music
Next
Midjourney API
Built with