生成音乐

POST

/udio/generate-proxy

请求参数

Body 参数application/json

Udio API 音乐生成请求参数的 JSON Schema 定义

prompt

string

生成提示词

必需

描述期望生成的音乐风格、情感或场景的文本提示

>= 1 字符

示例值:

A submarine crew discovering an underwater civilization, orchestral, cinematic

lyrics

string

歌词内容

必需

需要配合音乐的歌词内容，可以为空字符串

默认值:

lyrics_type

enum<string>

歌词生成类型

必需

指定歌词的生成方式

枚举值:

generateuserinstrumental

默认值:

generate

bypass_prompt_optimization

boolean

跳过提示词优化

必需

是否跳过系统对提示词的优化处理

默认值:

false

seed

integer

随机种子

必需

用于控制生成结果的随机种子值，-1 表示使用随机种子

默认值:

-1

song_section_start

number

歌曲片段起始位置

必需

指定在完整歌曲中的生成起始位置，0% 对应开始，50% 对应中间，90% 对应结尾

>= 0<= 1

默认值:

0.4

prompt_strength

number

提示词影响强度

必需

控制提示词对生成结果的影响程度

>= 0<= 1

默认值:

0.5

clarity_strength

number

清晰度强度

必需

控制生成音频的清晰度水平

>= 0<= 1

默认值:

0.25

lyrics_strength

number

歌词影响强度

必需

控制歌词对生成结果的影响程度

>= 0<= 1

默认值:

0.5

generation_quality

number

生成质量

必需

控制整体生成质量的水平

>= 0<= 1

默认值:

0.75

negative_prompt

string

反向提示词

必需

指定生成时要避免的音乐元素或风格

默认值:

model_type

enum<string>

模型类型

必需

使用的生成模型版本

枚举值:

udio32-v1.5udio130-v1.5

默认值:

udio32-v1.5

config

object

配置选项

必需

额外的配置参数

mode

enum<string>

生成模式

必需

指定音乐生成的模式

枚举值:

regular

默认值:

regular

示例

{
    "prompt": "A submarine crew discovering an underwater civilization, orchestral, cinematic",
    "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": "udio130-v1.5",
    "config": {
        "mode": "regular"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.tu-zi.com/udio/generate-proxy' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A submarine crew discovering an underwater civilization, orchestral, cinematic",
    "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": "udio130-v1.5",
    "config": {
        "mode": "regular"
    }
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{"message":"Success","generation_id":"0b77a2ce-980c-4a33-bf37-2deac7adaab1","track_ids":["ff89d562-4b05-4e31-a0d6-ad9795d599ee","0d23e494-4576-4d55-bb44-bbe31f8d785e"]}

🟢200成功

修改于 2025-04-11 06:15:18

查询任务(feed)

查询任务