How do I call the Udio Audios Generation API endpoint?

Send an HTTP request to https://api.acedata.cloud/udio/audios with a Bearer token in the Authorization header. See the documentation for request parameters and response format.

What authentication does Udio Music Generation require?

All Ace Data Cloud APIs use Bearer token authentication. Get your API key from the platform dashboard at https://platform.acedata.cloud and include it as: Authorization: Bearer YOUR_TOKEN

How much does Udio Music Generation cost?

Udio Music Generation uses pay-as-you-go pricing with no monthly fees. Each API call costs credits based on the model and parameters used. Visit the service page for detailed pricing.

Ace Data Cloud

Udio Audios Generation API

POSThttps://api.acedata.cloud/udio/audios

Udio AI music generation API, generates 2 songs per request.

Request Headers

acceptstring

The response format returned by the specified server should be set to application/json.

Please select

authorizationstring

Bearer token

Request Body

actionstringRequired parameter

Types of operations for generating audio.

modelstringRequired parameter

The model used for generating audio, with a default value of udio32-v1.5.

lyrics_typestringRequired parameter

Lyric generation type, default value is `user`. Optional values: `user` (use lyrics provided by the user), `instrumental` (pure music, no lyrics), `generate` (automatically generate lyrics).

promptstringRequired parameter

Prompts for generating audio.

lyricsstring

Custom lyrics text for the song. When `lyrics_type` is `user`, this field is used to pass in user-defined lyrics.

lyrics_strengthnumber

Lyric intensity, with a value range of [0, 1].

negative_promptstring

Negative prompt words, used to exclude unwanted music elements, up to 200 characters (optional).

prompt_strengthnumber

Prompt strength, with a value range of [0, 1].

clarity_strengthnumber

Clarity intensity, with a value range of [0, 1].

song_section_endnumber

The ending position of the song segment ranges from [0, 1].

song_section_startnumber

The starting position of the song segment ranges from [0, 1].

lyrics_placement_endnumber

The ending position of the lyrics placement ranges from [0, 1].

lyrics_placement_startnumber

The starting position for the lyrics placement ranges from [0, 1].

qualitynumber

The quality parameters for music generation have a value range of [-1, 1].

callback_urlstring

The callback URL that will be called after the audio generation is complete.

asyncboolean

Whether to process in asynchronous mode. When set to `true`, the interface immediately returns `task_id`, without the need to provide `callback_url`, and then the result can be obtained by polling the corresponding task query interface; if `callback_url` is also provided, the result will be pushed to that callback address.

Please select

Response

Request successful, return OK.

Response Body

dataobject

Music playlist generated based on the prompts.

successboolean

Flag indicating whether the request was successful

Example

{
  "data": [
    {
      "id": "75d8e08f-b25f-450e-9496-7b52e393098b",
      "lyric": "[Verse]\nSleigh bells ringin', choirs singin'\nSnowflakes fallin', presents glistenin' (glistenin')\nIn the air, there's a feeling of joy\nSpreadin' love to every girl and boy\n[Verse 2]\nCandles glowin', fire cracklin'\nStockings hangin', children wrappin'\nWith a smile, they unwrap their surprise\nIn their hearts, the magic never dies\n[Chorus]\nJingle all the way (jingle all the way)\nIn the winter wonderland, we play (oh-oh)\nHear the carols echo through the night (echo through the night)\nMerry Christmas, oh what a delight (oh-oh-oh)",
      "model": "chirp-v3",
      "style": "pop upbeat",
      "title": "Jingle All the Way",
      "prompt": "a christmas song",
      "audio_url": "https://audiopipe.suno.ai/?item_id=75d8e08f-b25f-450e-9496-7b52e393098b",
      "image_url": "https://cdn1.suno.ai/image_75d8e08f-b25f-450e-9496-7b52e393098b.png",
      "video_url": "",
      "created_at": "2024-04-03T11:54:30.424Z"
    },
    {
      "id": "e639fefd-bbd3-4858-b16d-45e7d4aa9313",
      "lyric": "[Verse]\nSleigh bells ringin', choirs singin'\nSnowflakes fallin', presents glistenin' (glistenin')\nIn the air, there's a feeling of joy\nSpreadin' love to every girl and boy\n[Verse 2]\nCandles glowin', fire cracklin'\nStockings hangin', children wrappin'\nWith a smile, they unwrap their surprise\nIn their hearts, the magic never dies\n[Chorus]\nJingle all the way (jingle all the way)\nIn the winter wonderland, we play (oh-oh)\nHear the carols echo through the night (echo through the night)\nMerry Christmas, oh what a delight (oh-oh-oh)",
      "model": "chirp-v3",
      "style": "pop upbeat",
      "title": "Jingle All the Way",
      "prompt": "a christmas song",
      "audio_url": "https://audiopipe.suno.ai/?item_id=e639fefd-bbd3-4858-b16d-45e7d4aa9313",
      "image_url": "https://cdn1.suno.ai/image_e639fefd-bbd3-4858-b16d-45e7d4aa9313.png",
      "video_url": "",
      "created_at": "2024-04-03T11:54:30.424Z"
    }
  ],
  "success": true
}

Allow Use General Balance

When 'Allow General Balance' is enabled, the general balance is used automatically if an app's balance is insufficient.

Shell

Python

JavaScript

Java

PHP

Kind reminder: For streaming requests, the above code may not be fully applicable. Please refer to the integration documentation for changes.