Generate（Music Generation）

POST

/udio/generate-proxy

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

Header Params

Body Params application/json

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 Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/udio/generate-proxy' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "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"
    }
  }
}'

Responses

🟢200成功

application/json

Body

Example

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

Modified at 2024-12-13 08:12:10

Analyze（emotions）

Generate（Music Continuation）