模型广场
Suno 音频

Suno API

用音乐描述或自定义歌词创作歌曲,也支持纯音乐。提供 V6、V6 Wild 和 V6 Mini。

  • 描述生成音乐
  • 自定义歌词
  • 纯音乐

Playground

创作音乐

正在确认登录状态…

每次成功生成结算一次,一次生成多首也按一个任务计费。

最近生成

生成的歌曲会显示在这里。

人民币计费

V6 · V6 Wild · V6 Mini ¥0.385 / 次

每次成功任务结算一次。提交时预留余额,失败后退回;试听和下载不另收费。以任务账单为准。

接入方式

基础域名 https://api.icodeeasy.cc

  • 创建音乐任务POST/v1/music/generations
  • 查询音乐任务GET/v1/music/tasks/{task_id}

API 示例

POST/v1/music/generations
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可选stringv6(默认)、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可选stringmp3(默认)、m4a 或 wav。
查询音乐任务
参数类型说明
task_id必填string路径参数。完成后在 result.music 读取全部曲目和播放地址。

核心功能

描述生成音乐

描述曲风、节奏、乐器和情绪,让模型生成歌曲小样。

支持 V6、V6 Wild、V6 Mini

支持
自定义歌词

使用自己的歌词,并用曲名和风格描述引导编曲。

自定义模式可填入歌词、曲名与风格

支持
纯音乐

开启纯音乐选项,用节奏、乐器和氛围描述引导无歌词的配乐。

启用纯音乐模式生成无歌词音乐

支持
音频下载

在任务结果中获取各曲目的试听和下载地址,逐首比较版本。

生成完成后返回各曲目的试听和下载地址

支持
音频格式

API 可输出 MP3、M4A 或 WAV。

支持
异步创作任务

提交后用任务 ID 查询状态,完成时读取本次返回的全部曲目。

支持

模型亮点

自带歌词编曲,也能生成纯音乐

可把自己写好的歌词、曲名和曲风交给 Suno V6 编曲,或切换纯音乐模式制作配乐。可选 MP3、M4A 或 WAV。

核对来源 · 2026-11-15

使用场景

  • 原创歌曲小样

    写明主题、曲风与演唱情绪,生成小样后比较旋律和编曲方向。

  • 歌词试唱

    输入自己写的歌词试听,调整拗口的句子或副歌段落后再生成新版本。

  • 视频旁白配乐

    用纯音乐模式描述低密度节奏与简洁乐器,生成可在剪辑中垫在旁白下的备选音轨。

  • 播客片头

    描述节目主题和标志性的音色,试听多个版本并剪取适合做片头的段落。

  • 游戏场景音乐草稿

    为探索、战斗或休息区分别生成气氛样曲,供制作团队确认方向。

  • 活动或品牌提案

    围绕同一个主题制作几种配器和节奏版本,配合分镜试听整体风格。

  • 语言版本试听

    为不同语言的歌词分别生成小样,比较音节是否贴合旋律,再定使用版本。

相关文章

常见问题

第一次生成歌曲,从哪个模式开始?

先选「仅描述」,写清风格、节奏和主要乐器,例如慢速爵士三重奏、钢琴为主。已有歌词时,再用「描述 + 歌词」。

打开本页 Playground
有自己的歌词,还要写歌曲描述吗?

建议写。把正文放在歌词栏,把温柔原声、慢拍、吉他等编曲要求放在歌曲描述栏。纯音乐模式可以省略歌词。

打开本页 Playground
只想给视频配乐,怎么避免生成演唱?

开启「纯音乐」,提示词写乐器、节奏和氛围。为旁白配乐时,可以要求节奏稀疏、主旋律轻一些,把空间留给说话声。

打开本页 Playground
返回两首歌,会收两次费用吗?

一个成功生成任务结算一次。播放器按任务展示本次返回的曲目,可分别试听或下载。

查看本站计费
API 提交超时,怎么避免重复生成?

保留原来的请求体和 Idempotency-Key,用它们重试。已经收到 task_id 时,先查询原任务。

查看接入方式
下载链接过期了,歌曲需要重新生成吗?

用原任务 ID 查询一次,从结果中获取新的播放或下载地址。API 生成时可以选 MP3、M4A 或 WAV。

查看调用参数