参数名 | 类型 | 描述 | 备注 |
---|---|---|---|
prompt | string | 音乐生成的提示词 | 例如: "pop, happy" |
lyrics | string | 歌词内容 | 支持多段式歌词格式 |
lyrics_type | string | 歌词类型 | 可选值:"user", "instrumental", "generate"。 说明: |
- user :使用用户提供的歌词生成音乐,此时 prompt 的作用类似于 tags,填写风格。 | |||
- instrumental :用于创建纯音乐,prompt 用于相关提示词。 | |||
- generate :自动生成歌词,prompt 用于描述需要生成什么样的歌曲。 | |||
model_type | string | 模型类型 | 可选值:"udio32-v1.5", "udio130-v1.5"。 说明: |
- "udio130-v1.5":歌曲时长固定位 130 秒。 | |||
- "udio32-v1.5":歌曲时长固定位 32 秒。 | |||
config.mode | string | 配置模式 | 默认为 "regular",表示生成音乐。 |
negative_prompt | string | 负面提示词 | 用于指定不想要的特征。 |
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。 |
{
"gen_params": {
"prompt": "a song about the moon",
"lyrics": "",
"lyrics_type": "generate",
"bypass_prompt_optimization": false,
"seed": -1,
"song_section_start": 0.1,
"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"
}
}
}
curl --location --request POST 'https://api.302.ai/udio/generate-proxy' \
--header 'Authorization: Bearer ' \
--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.1,
"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"
}
}
}'
{
"code": "success",
"message": "",
"data": "69c61512-278e-4ff4-b6ea-f3b278329b04"
}