AI模型API中文文档

生成音乐

POST/udio/generate-proxy

详细说明：

song_section
用于指定在完整歌曲中生成片段的起始和结束位置。0% (0) 对应歌曲开头，50% (0.5) 对应歌曲中间，100% (1) 对应歌曲结尾。点击数值指示器可切换为自动模式，让模型自行决定最佳位置。这个功能在使用歌曲扩展特性时特别有用。

lyrics_placement
用于指定在完整歌曲中放置歌词的位置。8% 对应歌曲开头，50% 对应歌曲中间，90% 将在歌曲结尾处生成片段。这个功能在使用歌曲扩展特性时特别有用。

prompt_strength
控制提示词对生成内容的影响程度。较高的值可以提高对提示词的遵循度，但可能会导致生成的声音不够自然。

lyrics_strength
控制歌词对生成内容的影响程度。较低的值可能会产生更自然的声音，但可能会忽略部分歌词内容。

clarity_strength
控制模型在生成音频时对清晰度和乐器分离度的优先级。较高的值可能会产生更清晰的音频，但声音可能不够自然。

generation_quality
实验性功能。用于在生成质量和生成速度之间进行权衡。

请求参数

Authorization: Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例

Authorization: Bearer 2f68dbbf-519d-4f01-9636-e2421b68f379

Header 参数

Authorization

string

可选

示例值:

Bearer

gen_params

object

必需

prompt

string

音乐生成的提示词

必需

示例值:

rock, pop soul, electronic

lyrics

string

歌词内容

必需

示例值:

[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<string>

歌词类型

必需

枚举值:

userinstrumentalgenerate

示例值:

user

model_type

enum<string>

模型类型

必需

枚举值:

udio32-v1.5udio130-v1.5

示例值:

udio130-v1.5

config

object

必需

negative_prompt

string

负面提示词

可选

示例值:

song_section_start

number

歌曲片段开始位置

必需

>= 0<= 1

默认值:

示例值:

song_section_end

number

歌曲片段结束位置

必需

>= 0<= 1

默认值:

示例值:

lyrics_placement_start

number

歌词放置开始位置

必需

>= 0<= 1

示例值:

lyrics_placement_end

number

歌词放置结束位置

必需

>= 0<= 1

示例值:

0.95

prompt_strength

number

提示词强度

必需

>= 0<= 1

默认值:

0.5

示例值:

0.5

clarity_strength

number

清晰度强度

必需

>= 0<= 1

默认值:

0.25

示例值:

0.25

lyrics_strength

number

歌词强度

必需

>= 0<= 1

默认值:

0.5

示例值:

0.5

generation_quality

enum<number>

生成质量

必需

枚举值:

0.250.50.751

默认值:

0.75

示例值:

0.75

seed

number

随机种子

必需

默认值:

-1

示例值:

-1

bypass_prompt_optimization

boolean

是否跳过提示词优化

必需

默认值:

false

示例值:

false

{
  "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"
    }
  }
}

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

string

必需

message

string

必需

data

string

task_id

必需

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

最后修改时间： 2 个月前