接入流程
计费规则
一次提交会产出两首歌曲；不同模型的价格不一样。
- 生成 32 秒音频的模型：udio32-v1.5
- 生成 130 秒音频的模型：udio130-v1.5
具体单价待补，以控制台「日志与用量」为准。
基本配置
Base URL：https://api.allyang.cn
请求头参数：
js
{
"Authorization": "Bearer <令牌>"
}
提交生成音乐任务参数介绍
基础参数
| 参数名 | 类型 | 描述 | 备注 |
|---|---|---|---|
| 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 | 负面提示词 | 用于指定不想要的特征 |
高级参数
这些参数需一并提交，即使采用默认值也要带上。
详细说明：
- 选 **"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.5 落在中间，0 与 1 分别贴到开头和末尾。做歌曲扩展时尤其常用。
lyrics_placement 决定歌词被摆到整首歌的什么位置：0.08 靠开头，0.5 居中，0.9 接近尾声。歌曲扩展场景下同样常用。
prompt_strength 决定提示词对成品的左右力度：调高会更贴提示词，代价是声音自然度下降。
lyrics_strength 决定歌词对成品的左右力度：调低声音更自然，但可能漏掉部分歌词。
clarity_strength 决定清晰度与乐器分离度的优先级：调高更清晰，但自然度会打折扣。
generation_quality 实验性参数，用来权衡质量与速度。
warning
以上参数均为透传字段，平台侧不做改写；取值范围与边界行为以实际接口校验为准，未覆盖到的边界待补。