302.AI API文档

Generate（生成音乐）

POST/udio/generate-proxy

输入提示词，生成一首歌，来自于Udio

参数说明

参数名	类型	描述	备注
`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。

价格：0.05 PTC/次

请求参数

Header 参数

Authorization

string

API KEY

可选

示例值:

Bearer {{YOUR_API_KEY}}

Content-Type

string

可选

示例值:

application/json

string

可选

示例值:

application/json

gen_params

object

必需

prompt

string

音乐生成的提示词

必需

lyrics

string

歌词内容

必需

lyrics_type

string

歌词类型

必需

bypass_prompt_optimization

boolean

是否跳过提示词优化

必需

seed

integer

随机种子

必需

song_section_start

integer

歌曲片段开始位置

必需

prompt_strength

number

提示词强度

必需

clarity_strength

number

清晰度强度

必需

lyrics_strength

number

歌词强度

必需

generation_quality

number

生成质量

必需

negative_prompt

string

负面提示词

必需

model_type

string

必需

config

object

必需

song_section_end

number

歌曲片段结束位置

必需

lyrics_placement_start

number

歌词放置开始位置

必需

lyrics_placement_end

number

歌词放置结束位置

必需

{
  "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": "udio130-v1.5",
    "config": {
      "mode": "regular"
    }
  }
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

string

必需

message

string

必需

data

string

必需

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

最后修改时间： 11 天前