
Suno API
用音乐描述或自定义歌词创作歌曲,也支持纯音乐。提供 V6、V6 Wild 和 V6 Mini。
- 描述生成音乐
- 自定义歌词
- 纯音乐
sunoPlayground
最近生成
生成的歌曲会显示在这里。
人民币计费
V6 · V6 Wild · V6 Mini ¥0.385 / 次
每次成功任务结算一次。提交时预留余额,失败后退回;试听和下载不另收费。以任务账单为准。
接入方式
API 接入
查看接入文档基础域名 https://api.icodeeasy.cc
- 创建音乐任务
POST/v1/music/generations - 查询音乐任务
GET/v1/music/tasks/{task_id}
API 示例
curl -X POST "https://api.icodeeasy.cc/v1/music/generations" \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary @- <<'JSON'
{
"model": "suno",
"version": "v6",
"prompt": "温暖的原声钢琴华尔兹,适合安静的夜晚",
"instrumental": true,
"audio_format": "mp3"
}
JSON先在本地设置 ICODEEASY_API_KEY。示例中的参考素材链接或任务 ID 请替换为你自己的值。
调用参数
创建音乐任务
| 参数 | 类型 | 说明 |
|---|---|---|
model可选 | string | 固定为 suno。 |
version可选 | string | v6(默认)、v6-wild 或 v6-mini。 |
custom可选 | boolean | 默认 false;开启后使用自定义歌词。 |
prompt条件必填 | string | 普通模式为音乐描述,最多 3,000 字符;自定义模式为歌词,最多 5,000 字符。仅自定义纯音乐模式下可省略。 |
instrumental可选 | boolean | 设为 true 生成纯音乐。 |
title可选 | string | 自定义模式的曲名,最多 80 字符。 |
style可选 | string | 自定义模式的音乐风格,最多 1,000 字符。 |
audio_format可选 | string | mp3(默认)、m4a 或 wav。 |
查询音乐任务
| 参数 | 类型 | 说明 |
|---|---|---|
task_id必填 | string | 路径参数。完成后在 result.music 读取全部曲目和播放地址。 |
核心功能
- 描述生成音乐
描述曲风、节奏、乐器和情绪,让模型生成歌曲小样。
支持 V6、V6 Wild、V6 Mini
- 支持
- 自定义歌词
使用自己的歌词,并用曲名和风格描述引导编曲。
自定义模式可填入歌词、曲名与风格
- 支持
- 纯音乐
开启纯音乐选项,用节奏、乐器和氛围描述引导无歌词的配乐。
启用纯音乐模式生成无歌词音乐
- 支持
- 音频下载
在任务结果中获取各曲目的试听和下载地址,逐首比较版本。
生成完成后返回各曲目的试听和下载地址
- 支持
- 音频格式
API 可输出 MP3、M4A 或 WAV。
- 支持
- 异步创作任务
提交后用任务 ID 查询状态,完成时读取本次返回的全部曲目。
- 支持
模型亮点
自带歌词编曲,也能生成纯音乐
可把自己写好的歌词、曲名和曲风交给 Suno V6 编曲,或切换纯音乐模式制作配乐。可选 MP3、M4A 或 WAV。
使用场景
原创歌曲小样
写明主题、曲风与演唱情绪,生成小样后比较旋律和编曲方向。
歌词试唱
输入自己写的歌词试听,调整拗口的句子或副歌段落后再生成新版本。
视频旁白配乐
用纯音乐模式描述低密度节奏与简洁乐器,生成可在剪辑中垫在旁白下的备选音轨。
播客片头
描述节目主题和标志性的音色,试听多个版本并剪取适合做片头的段落。
游戏场景音乐草稿
为探索、战斗或休息区分别生成气氛样曲,供制作团队确认方向。
活动或品牌提案
围绕同一个主题制作几种配器和节奏版本,配合分镜试听整体风格。
语言版本试听
为不同语言的歌词分别生成小样,比较音节是否贴合旋律,再定使用版本。
相关文章
常见问题
第一次生成歌曲,从哪个模式开始?
先选「仅描述」,写清风格、节奏和主要乐器,例如慢速爵士三重奏、钢琴为主。已有歌词时,再用「描述 + 歌词」。
打开本页 Playground有自己的歌词,还要写歌曲描述吗?
建议写。把正文放在歌词栏,把温柔原声、慢拍、吉他等编曲要求放在歌曲描述栏。纯音乐模式可以省略歌词。
打开本页 Playground只想给视频配乐,怎么避免生成演唱?
开启「纯音乐」,提示词写乐器、节奏和氛围。为旁白配乐时,可以要求节奏稀疏、主旋律轻一些,把空间留给说话声。
打开本页 Playground返回两首歌,会收两次费用吗?
一个成功生成任务结算一次。播放器按任务展示本次返回的曲目,可分别试听或下载。
查看本站计费API 提交超时,怎么避免重复生成?
保留原来的请求体和 Idempotency-Key,用它们重试。已经收到 task_id 时,先查询原任务。
查看接入方式下载链接过期了,歌曲需要重新生成吗?
用原任务 ID 查询一次,从结果中获取新的播放或下载地址。API 生成时可以选 MP3、M4A 或 WAV。
查看调用参数