Generate（Music Generation）

Enter prompt and generate a song

song_section
This setting specifies the start and end positions for generating clips within a full song: 0% (0) represents the beginning, 50% (0.5) the middle, and 100% (1) the end. Clicking the value indicator enables automatic mode, letting the model determine the optimal position. This is particularly useful when using the Song Expansion feature.

lyrics_placement
This setting specifies the placement of lyrics within the complete song: 8% places them at the beginning, 50% at the middle, and 90% generates a snippet toward the end. This feature is particularly useful when using Song Extension.

prompt_strength
This setting controls the extent to which the prompt influences the generated content. Higher values enhance adherence to prompt but may produce less natural-sounding audio.

lyrics_strength
This setting controls the influence of lyrics on the generated content. Lower values may yield a more natural sound, but some lyrical content might be disregarded.

clarity_strength
This setting controls how the model prioritizes clarity and instrument separation in audio generation. Higher values may result in clearer audio, but the sound may feel less natural.

generation_quality
This is an experimental feature used to balance generation quality and speed.

Price：Udio32-v1.5：0.05 PTC/call
Udio130-v1.5：0.1 PTC/call

Request

Authorization

Header Params

Authorization

string

optional

API KEY

Example:

Bearer {{YOUR_API_KEY}}

Content-Type

string

optional

Example:

application/json

string

optional

Example:

application/json

Body Params application/json

gen_params

object

required

prompt

string

required

Music-generated prompt

lyrics

string

required

Lyrics

lyrics_type

enum<string>

required

Lyrics type

Allowed values:

userinstrumentalgenerate

model_type

enum<string>

required

Allowed values:

udio32-v1.5udio130-v1.5

config

object

optional

negative_prompt

string

optional

Negative prompt

song_section_start

number

required

Song clip start position

song_section_end

number

required

End position of the song clip

lyrics_placement_start

number

required

Lyrics placement start position

lyrics_placement_end

number

required

Lyrics placement end position

prompt_strength

number

required

prompt_strength

clarity_strength

number

required

clarity_strength

lyrics_strength

number

required

lyrics_strength

generation_quality

enum<number>

required

generation_quality

Allowed values:

0.250.50.751

seed

number

required

random seed

bypass_prompt_optimization

boolean

required

Whether to skip prompt word optimization

Example

{
  "gen_params": {
    "prompt": "a song about the moon",
    "lyrics": "",
    "lyrics_type": "generate",
    "bypass_prompt_optimization": false,
    "seed": -1,
    "song_section_start": 0,
    "prompt_strength": 0.5,
    "clarity_strength": 0.25,
    "lyrics_strength": 0.5,
    "generation_quality": 0.75,
    "negative_prompt": "",
    "model_type": "udio32-v1.5",
    "config": {
      "mode": "regular"
    }
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

code

string

required

message

string

required

data

string

required

Example

{
  "code": "success",
  "message": "",
  "data": "69c61512-278e-4ff4-b6ea-f3b278329b04"
}

Request

Request samples

Responses