Generate music

Generate Proxy

This endpoint allows you to generate a proxy for a song based on the provided parameters.

Request Body

gen_params (object): Required

prompt (string): The prompt for song generation. Required

Example: "rock, pop soul, electronic"

lyrics (string): The lyrics content. Required

Example: "[Verse 1] In the silence, echoes fade, footsteps in the ground Time's slipping, memories made, with whispers all around As the stars dim, shadows play, we take our final bow"

lyrics_type (enum): The type of lyrics. Required

Possible Values: user, instrumental, generate

Example: user

model_type (enum): The type of model. Required

Possible Values: udio32-v1.5, udio130-v1.5

Example: udio130-v1.5

config (object): Required

negative_prompt (string): Negative prompt. Optional

Example: ""

song_section_start (number): Starting position of the song fragment. Required

Constraints: >= 0, <= 1

Default: 0

Example: 0

song_section_end (number): Ending position of the song fragment. Required

Constraints: >= 0, <= 1

Default: 1

Example: 1

lyrics_placement_start (number): Starting position for lyrics placement. Required

Constraints: >= 0, <= 1

Example: 0

lyrics_placement_end (number): Ending position for lyrics placement. Required

Constraints: >= 0, <= 1

Example: 0.95

prompt_strength (number): Strength of the prompt. Required

Constraints: >= 0, <= 1

Default: 0.5

Example: 0.5

clarity_strength (number): Clarity strength. Required

Constraints: >= 0, <= 1

Default: 0.25

Example: 0.25

lyrics_strength (number): Lyrics strength. Required

Constraints: >= 0, <= 1

Default: 0.5

Example: 0.5

generation_quality (enum): Quality of generation. Required

Possible Values: 0.25, 0.5, 0.75, 1

Default: 0.75

Example: 0.75

seed (number): Random seed. Required

Default: -1

Example: -1

bypass_prompt_optimization (boolean): Whether to skip prompt optimization. Required

Default: false

Example: false

Request

Header Params

Authorization

string

required

Example:

Bearer {{api-key}}

Body Params application/json

gen_params

object

required

prompt

string

required

lyrics

string

required

lyrics_type

string

required

bypass_prompt_optimization

boolean

required

seed

integer

required

song_section_start

number

required

prompt_strength

number

required

clarity_strength

number

required

lyrics_strength

number

required

generation_quality

number

required

negative_prompt

string

required

model_type

string

required

config

object

required

Example

{
  "gen_params": {
    "prompt": "The last song ever sung on the planet earth",
    "lyrics": "",
    "lyrics_type": "generate",
    "bypass_prompt_optimization": false,
    "seed": -1,
    "song_section_start": 0.4,
    "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

text/plain

Body

code

string

required

message

string

required

data

string

required

Example

{
  "code": "success",
  "message": "",
  "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}

Generate Proxy#

Request Body#

Request

Request samples

Responses

Generate Proxy

Request Body