API介绍
Suno 是由美国公司 Suno Inc. 开发的 AI 音乐生成平台,用户可通过简单的文本提示词快速创作含旋律、歌词与人声的高质量音乐。Suno 支持多种曲风,覆盖流行、电音、R&B 等,适用于创作者、广告、短视频等场景,无需音乐专业背景即可上手,被誉为“音乐界的 ChatGPT”。
相关评测:《2025年AI音乐模型评测:孤独的Suno与国产模型的追赶者们》
相关测评:《一站式打造爆火AI数字人音乐视频,附两大主流数字人模型实测》
API调试台
登录后,探索更多精彩功能! 点击登录
API统计
API列表 (11)
| API描述 | 接口地址 | 请求方法 | 稳定性 | 参数说明 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Music(Suno全自动模式) | POST | 不稳定 | 查看详情 | ||||||||||
文档详情 输入一个关键词,自动生成2首歌 价格:0.1PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonAcceptstring可选 示例值: application/jsonBody参数 application/jsonmvenum<string>必需 模型,chirp-crow (suno-v5)、chirp-bluejay(suno-v4.5+)、chirp-auk(suno-v4.5)、chirp-v4、chirp-v3-5。默认 chirp-v3-5 枚举值: chirp-crowchirp-bluejaychirp-aukchirp-v4chirp-v3-5make_instrumentalboolean必需 是否为纯音乐 gpt_description_promptstring必需 歌曲灵感。基本上是一句话或几个词来描述您希望歌曲的主题。 | |||||||||||||
Music(Suno自定义模式) | POST | 不稳定 | 查看详情 | ||||||||||
文档详情 通过自定义歌曲的歌词、风格等设置,生成2首歌曲。 使用说明参数要求根据
字符长度限制不同模型版本有不同的字符限制:
回调机制任务处理过程中会触发三个阶段的回调:
注意事项
定价0.1 PTC/次 请求参数 Header参数Authorizationstring必需 示例值: Bearer {{YOUR_API_KEY}}Content-Typeenum<string>必需 枚举值: application/json示例值: application/jsonAcceptenum<string>可选 枚举值: application/json示例值: application/jsonBody参数 application/jsonpromptstring可选 歌词内容。当 字符限制:
格式建议:
示例值: [Verse]
月光映山河
清风拂柳枝
心中千言万语
只想诉与你
[Chorus]
一生一世
与你共舞风雨
不离不弃
共度春夏冬秋
tagsstring必需 音乐风格标签,使用逗号分隔多个标签。 字符限制:
常见风格示例:
示例值: pop, ballad, emotional, pianonegative_tagsstring可选 需要排除的风格标签,使用逗号分隔。 用于指定不希望出现在生成音乐中的风格元素。 示例值: heavy metal, aggressivemvenum<string>必需 Suno AI 模型版本。不同版本有不同的特性和限制。 模型对比:
默认值: chirp-v3-5 枚举值: chirp-crowchirp-bluejaychirp-aukchirp-v4chirp-v3-5示例值: chirp-crowtitlestring必需 歌曲标题。 长度限制: 最多 80字符(所有模型统一限制) 标题将显示在播放器界面和文件名中。 示例值: 不离不弃task_idstring可选 任务ID。用于对之前的任务进行再操作时必填。 该ID可从查询任务接口(fetch)的返回结果中获取。 使用场景:
示例值: task_abc123xyzmake_instrumentalboolean必需 是否生成纯音乐(无歌词)。 参数要求:
metadataobject可选 高级元数据配置,用于精细控制音乐生成参数。 create_modeenum<string>可选 创建模式,固定为 custom(自定义模式) 枚举值: custom示例值: customvocal_genderenum<string>可选 声音性别偏好。 选项:
枚举值: fm示例值: fcontrol_slidersobject可选 高级控制滑块参数 style_weightnumber可选 风格参考度。控制生成音乐对指定风格的遵循程度。 取值范围: 0.00 - 1.00(保留两位小数)
示例值: 0.87weirdness_constraintnumber可选 创意发散度/奇异度约束。控制音乐的创新程度。 取值范围: 0.00 - 1.00(保留两位小数)
示例值: 0.75can_control_slidersarray[string]可选 可控制的滑块参数列表。 指定哪些控制滑块参数在此次请求中生效。 示例值: [
"style_weight",
"weirdness_constraint"
] | |||||||||||||
Upload(上传素材) | POST | 不稳定 | 查看详情 | ||||||||||
文档详情 上传素材,以便之后使用 价格:0.01PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonAcceptstring可选 示例值: application/jsonBody参数 application/jsonurlstring必需 | |||||||||||||
Add Instrumental(清唱配乐) | POST | 不稳定 | 查看详情 | ||||||||||
文档详情 2025 年 8 月份 suno 新出 Add Instrumental功能
使用步骤:
价格:0.1PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonAcceptstring可选 示例值: application/jsonBody参数 application/jsonmvenum<string>必需 仅支持Suno-4.6(chirp-bluejay) 枚举值: chirp-bluejaytagsstring必需 上传返回的metadata.tags titlestring必需 歌曲标题 underpainting_clip_idstring必需 上传的文件id查询后获得的clip_id underpainting_start_sinteger必需 开始配乐的秒数,一般为0 underpainting_end_snumber必需 歌曲长度 taskenum<string>必需 固定为underpainting 枚举值: underpaintingpromptstring可选 不必填,留空 override_fieldsarray[string]必需 不必改动 | |||||||||||||
Add Vocals(纯音乐配人声) | POST | 不稳定 | 查看详情 | ||||||||||
文档详情 2025 年 8 月份 suno 新出 Add Vocals功能
使用步骤:
价格:0.1PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonAcceptstring可选 示例值: application/jsonBody参数 application/jsonmvenum<string>必需 仅支持Suno-4.6(chirp-bluejay) 枚举值: chirp-bluejaytagsstring必需 上传查询后的metadata.tags titlestring必需 歌曲名称 overpainting_clip_idstring必需 上传查询之后的clip_id overpainting_start_sinteger必需 开始配乐的秒数,一般为0 overpainting_end_sinteger必需 歌曲长度 taskenum<string>必需 固定为overpainting 枚举值: overpaintingpromptstring必需 prompt 为 填词,必填 override_fieldsarray[string]必需 | |||||||||||||
Timing(歌词时间线) | POST | 不稳定 | 查看详情 | ||||||||||
文档详情 获取歌词时间线,例如:
传入生成歌曲接口的id,填入task_id 价格:0.01PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonAcceptstring可选 示例值: application/jsonBody参数 application/jsontask_idstring必需 上一次歌曲生成的任务ID | |||||||||||||
Wav(获取Wav文件) | POST | 不稳定 | 查看详情 | ||||||||||
文档详情 获取Wav文件 传入生成歌曲接口的id,填入task_id 价格:0.01PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonAcceptstring可选 示例值: application/jsonBody参数 application/jsontask_idstring必需 上一次歌曲生成的任务ID | |||||||||||||
Video(获取视频) | POST | 不稳定 | 查看详情 | ||||||||||
文档详情 获取视频 传入生成歌曲接口的id,填入task_id 价格:0.01PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonAcceptstring可选 示例值: application/jsonBody参数 application/jsontask_idstring必需 上一次歌曲生成的任务ID | |||||||||||||
Speed(调整歌曲速度) | POST | 不稳定 | 查看详情 | ||||||||||
文档详情 调整歌曲速度 传入生成歌曲接口的id,填入task_id 价格:0.01PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonAcceptstring可选 示例值: application/jsonBody参数 application/jsontask_idstring必需 上一次歌曲生成的任务ID speed_multipliernumber必需 倍率,0.25-4之间 keep_pitchboolean必需 是否保持高音 titlestring必需 新歌曲标题 | |||||||||||||
Crop(裁剪音乐) | POST | 不稳定 | 查看详情 | ||||||||||
文档详情 裁剪音乐 传入生成歌曲接口的id,填入task_id 价格:0.01PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonAcceptstring可选 示例值: application/jsonBody参数 application/jsontask_idstring必需 上一次歌曲生成的任务ID crop_start_snumber必需 crop_end_sinteger必需 is_crop_removeboolean必需 | |||||||||||||
Fetch(Suno查询任务) | GET | 不稳定 | 查看详情 | ||||||||||
文档详情 查询任务情况 价格:0PTC/次 请求参数 Path参数task_idstring必需 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}} | |||||||||||||
API价格表
| 模型 | 说明 | 302.AI价格 |
|---|
Music(Automatic Mode) | Suno全自动模式 |
|
Music(Custom Mode) | Suno自定义模式 |
|
Upload(上传素材) | 上传素材 |
|
Add Instrumental(清唱配乐) | 清唱配乐 |
|
Add Vocals(纯音乐配人声) | 纯音乐配人声 |
|
Timing(歌词时间线) | 歌词时间线 |
|
Wav(获取Wav文件) | 获取Wav文件 |
|
Video(获取视频) | 获取视频 |
|
Speed(调整歌曲速度) | 调整歌曲速度 |
|
Crop(裁剪音乐) | 裁剪音乐 |
|
Fetch | Suno查询任务 |
|
