Suno 音乐生成 Beta

模型名称

向后兼容： 之前接入的模型名（如 suno-v5、suno-v4.5、suno-v4.5plus、suno-v4.5all、suno-v4）仍然可用，会自动映射到对应的 -beta 版本

可选值：

• suno-v5-beta: V5最新版本（默认推荐），支持 Voice Persona，更卓越的音乐表现力，生成速度更快，prompt最多5000字符，style最多1000字符
• suno-v4.5plus-beta: V4.5+增强版，音色更丰富，新的创作方式，最长8分钟，prompt最多5000字符，style最多1000字符
• suno-v4.5all-beta: V4.5全功能版，更智能的提示词，更快的生成速度，最长8分钟，prompt最多5000字符，style最多1000字符
• suno-v4.5-beta: V4.5版本，更智能的提示词，更快的生成速度，最长8分钟，prompt最多5000字符，style最多1000字符
• suno-v4-beta: V4版本，改进的人声质量，最长4分钟，prompt最多3000字符，style最多200字符

是否开启自定义模式

说明：

• false：简单模式，只需提供prompt，AI自动生成歌词和风格
• true：自定义模式，可精细控制style、title、歌词等

自定义模式下的必填参数：

• style: 必填
• title: 必填
• prompt: 当instrumental=false时必填（作为歌词）

是否生成纯音乐（无人声）

说明：

• false：生成带人声的音乐
• true：生成无人声的纯音乐/背景音乐

注意：

• 在非自定义模式下，此参数对必填字段无影响
• 在自定义模式下，设为true时prompt变为可选

提示词，描述所需音乐内容

非自定义模式（custom_mode=false）：

• 必填，作为音乐描述，AI自动生成歌词和风格
• 最大长度：500字符

自定义模式（custom_mode=true）：

• 当instrumental=false时必填，作为精确歌词使用
• 当instrumental=true时可选
• 最大长度：V4为3000字符，V4.5+为5000字符

歌词格式建议：

• 使用[Verse]、[Chorus]、[Bridge]等标签组织歌词结构

音乐风格规范

说明：

• 在自定义模式（custom_mode=true）下必填
• 定义音乐的流派、情绪或艺术方向
• 建议使用英文逗号分隔的标签形式

字符限制：

• V4：最多200字符
• V4.5+：最多1000字符

常见风格标签：

• 流派：pop, rock, jazz, classical, electronic, hip-hop, r&b, country, folk
• 情绪：happy, sad, energetic, calm, romantic, dark, uplifting
• 乐器：piano, guitar, drums, bass, violin, saxophone, synthesizer
• 人声：male vocals, female vocals, choir, harmonies
• 节奏：slow, fast, upbeat, groovy, 120bpm

歌曲标题

说明：

• 在自定义模式（custom_mode=true）下必填
• 将显示在播放器界面和文件名中
• 最大长度：80字符

排除风格，指定不希望出现的音乐风格或特征

示例：

• heavy metal, screaming, sad
• rap, fast tempo

人声性别偏好

可选值：

• m: 男声
• f: 女声

注意：

• 仅在custom_mode=true时生效
• 此参数只能加强概率，不能保证一定遵循指定性别

风格权重，控制对指定风格的遵循强度

取值范围： 0.0 ~ 1.0，保留一位小数

说明：

• 值越高，生成结果越接近指定风格
• 值为0时视为未设置

怪异度约束，控制生成结果的创意/实验性程度

取值范围： 0.0 ~ 1.0，保留一位小数

说明：

• 值越高，生成结果越具有创意和实验性
• 值越低，生成结果越传统和保守
• 值为0时视为未设置

音频权重，控制音频特征的权重

取值范围： 0.0 ~ 1.0，保留一位小数

说明：

• 值为0时视为未设置

Persona ID，应用已创建的 Persona 风格到本次音乐生成

仅在 custom_mode=true 时可用。通过 Suno Persona 创建 接口获得，应用后可保持一致的声乐和风格特征

获取方式： 创建 Persona 任务完成后，从 result_data.persona_id 中获取

Persona 应用方式

可选值：

1. style_persona: 风格导向型，偏重音乐风格特征（编曲、节奏、音色），支持所有模型版本
2. voice_persona: 声音导向型，偏重声乐特征（音色、唱法、声线），仅 V5 支持

仅在 custom_mode=true 时可用，通常与 persona_id 搭配使用。使用 voice_persona 时模型必须为 suno-v5-beta，否则返回错误

任务完成后的HTTPS回调地址

回调时机：

• 回调过程分三个阶段：text（文本生成）、first（第一首完成）、complete（全部完成）
• 某些情况下可能跳过text和first阶段，直接返回complete

安全限制：

• 仅支持HTTPS协议
• 禁止回调到内网IP地址
• URL长度不超过2048字符

回调机制：

• 超时时间：10秒
• 失败后最多重试3次
• 回调地址返回2xx状态码视为成功

任务创建时间戳

任务ID，用于查询任务状态和结果

实际使用的模型名称

任务的具体类型

任务进度百分比 (0-100)

任务状态

任务的输出类型