接入流程

计费规则

一次请求，返回两首歌曲。不同模型价格不同: 使用生成 32 秒音频的模型 udio32-v1.5 使用生成 130 秒音频的模型 udio130-v1.5

基本配置

Base URL headers 参数

{
"Authorization": "Bearer Your API Key",
}

提交生成音乐任务参数介绍

基础参数

参数名	类型	描述	备注
prompt	string	音乐生成的提示词	例如: "pop, happy"
lyrics	string	歌词内容	支持多段式歌词格式
lyrics_type	string	歌词类型	可选 "user", "instrumental", "generate"
model_type	string	模型类型	分为 "udio32-v1.5", "udio130-v1.5"
config.mode	string	配置模式	默认为 "regular"
negative_prompt	string	负面提示词	用于指定不想要的特征

高级参数

这些参数也必须带上，即便是用默认值

详细说明：

model_type = "udio130-v1.5" 时，歌曲时长固定位 130 秒；为 "udio32-v1.5" 时，歌曲时长固定位 32 秒。

lyrics_type = user，表示使用用户提供的歌词生成音乐，此时 prompt 的作用类似于 tags，填写风格。

lyrics_type = instrumental，用于创建纯音乐，prompt 用于相关提示词。

lyrics_type = generate 时，表示自动生成歌词，prompt 用于描述需要生成什么样的歌曲。

config.mode = regular，表示生成音乐。

参数名	类型	描述	备注
song_section_start	number	歌曲片段开始位置	范围 0-1, 默认 0
song_section_end	number	歌曲片段结束位置	范围 0-1, 默认 1
lyrics_placement_start	number	歌词放置开始位置	范围 0-1
lyrics_placement_end	number	歌词放置结束位置	范围 0-1
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.25, 0.5, 0.75, 1。默认 0.75，数字越大，质量越高，速度越慢。
seed	number	随机种子	默认 -1 表示随机
bypass_prompt_optimization	boolean	是否跳过提示词优化	默认为 false

详细说明：

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

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

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

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

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

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

warning

以上所有参数都由我抓包分析得来，参数全部转发至 Udio, 没有任何处理。 因此，你也可以自己到 Udio 网站抓包分析。