API介绍
AI歌曲生成
API调试台
登录后，探索更多精彩功能！ 点击登录
API列表 (5)
| 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"
] | ||||||||||||||||||||||
Music（Suno生成歌词） | POST | 不稳定 | 查看详情 | |||||||||||||||||||
文档详情 使用指南
开发者注意事项
价格：0.01PTC/次 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonAcceptstring可选 示例值: application/jsonBody参数 application/jsonpromptstring必需 详细描述期望的歌词内容。
示例值: "一首关于城市宁静夜晚的歌" | ||||||||||||||||||||||
Music（Suno歌曲续写） | POST | 不稳定 | 查看详情 | |||||||||||||||||||
文档详情 根据之前生成的歌曲，续写一首歌。可以设置歌曲续写的时间，每次续写固定2分钟。 使用指南
参部分数说明
字符长度限制
注意事项
价格：0.1PTC/次** 请求参数 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}}Content-Typestring可选 示例值: application/jsonAcceptstring可选 示例值: application/jsonBody参数 application/jsonpromptstring必需 歌词内容，仅当
tagsstring必需 音乐风格标签，使用逗号分隔多个标签，用于指定续曲的风格方向，建议与源歌曲风格保持一致。
示例值: pop, ballad, emotional, pianomvenum<string>必需 模型版本，必须与源歌曲的模型版本一致。不同版本有不同的特性和限制：
枚举值: chirp-crowchirp-bluejaychirp-aukchirp-v4chirp-v3-5示例值: chirp-crowtitlestring必需 续曲的歌曲标题。长度限制：80字符 示例值: 不离不弃task_idstring必需 源歌曲的任务ID，用于关联续写任务与原始任务，需从查询任务接口（fetch）的返回结果中获取，对之前的任务进行再操作时必填，在fetch接口返回 continue_clip_idstring必需 源歌曲的音频ID，每次生成歌曲会返回两首作品，需选择其中一首的ID作为续写基础，从查询任务接口（fetch）的返回结果中获取 continue_atnumber必需 从源歌曲开始续写的时间点（单位：秒），取值范围需大于0且小于源歌曲的总时长，用于精准对接源歌曲的旋律 make_instrumentalboolean必需 是否为纯音乐（无歌词）。 negative_tagsstring可选 需要排除的风格标签，使用逗号分隔。 示例值: heavy metal, aggressivemetadataobject必需 高级元数据配置，用于精细控制音乐生成参数。 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"
] | ||||||||||||||||||||||
Fetch（Suno查询任务） | GET | 不稳定 | 查看详情 | |||||||||||||||||||
文档详情 查询任务情况 价格：0PTC/次 请求参数 Path参数task_idstring必需 Header参数Authorizationstring可选 示例值: Bearer {{YOUR_API_KEY}} | ||||||||||||||||||||||
API价格表
| 模型 | 说明 | 302.AI价格 |
|---|
Music（Automatic Mode） | Suno全自动模式 |
|
Music（Custom Mode） | Suno自定义模式 |
|
Music（Generate Lyrics） | Suno生成歌词 |
|
Music（Song Continuation） | Suno歌曲续写 |
|
Fetch | Suno查询任务 |
|
猜你喜欢
Elevenlabs
起
