# 接入流程

## 计费规则

一次请求，返回两首歌曲。不同模型价格不同:
使用生成 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 网站抓包分析。