suno-music

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Suno Music Generation

Suno音乐生成

Generate AI-powered music through AceDataCloud's Suno API.

Setup: See authentication for token setup.

通过AceDataCloud的Suno API生成AI驱动的音乐。

设置： 查看身份验证了解令牌设置方法。

Quick Start

快速开始

bash

curl -X POST https://api.acedata.cloud/suno/audios \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a happy pop song about coding", "model": "chirp-v5-5", "callback_url": "https://api.acedata.cloud/health"}'

Async: All generation is async. See async task polling. Poll via
POST /suno/tasks
with
{"id": "<task_id>"}
every 3-5 seconds.

bash

curl -X POST https://api.acedata.cloud/suno/audios \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a happy pop song about coding", "model": "chirp-v5-5", "callback_url": "https://api.acedata.cloud/health"}'

异步说明： 所有生成操作均为异步。查看异步任务轮询。每隔3-5秒通过
POST /suno/tasks
接口，传入
{"id": "<task_id>"}
进行轮询。

Available Models

可用模型

Model	Best For
`chirp-v5-5`	Latest, highest quality
`chirp-v5`	High quality
`chirp-v4-5-plus`	Enhanced v4.5
`chirp-v4-5`	Good balance of quality and speed
`chirp-v4`	Fast, reliable
`chirp-v3-5`	Legacy, stable
`chirp-v3-0`	Legacy

模型	适用场景
`chirp-v5-5`	最新版本，最高音质
`chirp-v5`	高音质
`chirp-v4-5-plus`	增强版v4.5
`chirp-v4-5`	音质与速度平衡较好
`chirp-v4`	快速、可靠
`chirp-v3-5`	旧版，稳定
`chirp-v3-0`	旧版

Core Workflows

核心工作流程

1. Quick Generation (Inspiration Mode)

1. 快速生成（灵感模式）

Generate a song from a text description. Suno creates lyrics, style, and music automatically.

json

POST /suno/audios
{
  "prompt": "an upbeat electronic track about the future of AI",
  "model": "chirp-v5-5",
  "instrumental": false
}

根据文本描述生成歌曲。Suno会自动创作歌词、风格和音乐。

json

POST /suno/audios
{
  "prompt": "an upbeat electronic track about the future of AI",
  "model": "chirp-v5-5",
  "instrumental": false
}

2. Custom Generation (Full Control)

2. 自定义生成（完全控制）

Provide your own lyrics, title, and style for precise control.

json

POST /suno/audios
{
  "custom": true,
  "lyric": "[Verse]\nCode is poetry in motion\n[Chorus]\nWe build the future tonight",
  "title": "Digital Dreams",
  "style": "Synthwave, Electronic, Dreamy",
  "model": "chirp-v5-5",
  "vocal_gender": "f"
}

提供自己的歌词、标题和风格，实现精准控制。

json

POST /suno/audios
{
  "custom": true,
  "lyric": "[Verse]\nCode is poetry in motion\n[Chorus]\nWe build the future tonight",
  "title": "Digital Dreams",
  "style": "Synthwave, Electronic, Dreamy",
  "model": "chirp-v5-5",
  "vocal_gender": "f"
}

3. Extend a Song

3. 扩展歌曲

Continue an existing song from a specific timestamp with new lyrics.

json

POST /suno/audios
{
  "action": "extend",
  "audio_id": "existing-audio-id",
  "lyric": "[Bridge]\nNew section lyrics here",
  "continue_at": 120.0,
  "style": "Same style as original"
}

从特定时间点继续现有歌曲，并添加新歌词。

json

POST /suno/audios
{
  "action": "extend",
  "audio_id": "existing-audio-id",
  "lyric": "[Bridge]\nNew section lyrics here",
  "continue_at": 120.0,
  "style": "Same style as original"
}

4. Cover / Remix

4. 翻唱/混音

Create a new version of an existing song in a different style.

json

POST /suno/audios
{
  "action": "cover",
  "audio_id": "existing-audio-id",
  "style": "Jazz, Acoustic, Mellow"
}

为现有歌曲创建不同风格的新版本。

json

POST /suno/audios
{
  "action": "cover",
  "audio_id": "existing-audio-id",
  "style": "Jazz, Acoustic, Mellow"
}

5. Full Song Creation Workflow

5. 完整歌曲创作流程

For best results follow this multi-step workflow:

Generate lyrics —
```
POST /suno/lyrics
```
with a topic/prompt
Optimize style —
```
POST /suno/style
```
to refine style description
Generate music —
```
POST /suno/audios
```
with custom action, lyrics + style
Poll task —
```
POST /suno/tasks
```
with
```
id
```
(or
```
ids
```
for batch) until status is complete
Optional: Extend — Use extend action to add more sections
Optional: Concat — Use concat action to merge extended segments
Optional: Convert — Get WAV (
```
/suno/wav
```
), MIDI (
```
/suno/midi
```
), or MP4 (
```
/suno/mp4
```
)

为获得最佳效果，请遵循以下多步骤工作流程：

生成歌词 — 传入主题/提示调用
```
POST /suno/lyrics
```
接口
优化风格 — 调用
```
POST /suno/style
```
接口优化风格描述
生成音乐 — 调用
```
POST /suno/audios
```
接口，选择自定义模式，传入歌词和风格
轮询任务 — 传入
```
id
```
（或批量任务的
```
ids
```
）调用
```
POST /suno/tasks
```
接口，直到任务状态完成
可选：扩展 — 使用extend操作添加更多段落
可选：拼接 — 使用concat操作合并扩展片段
可选：转换格式 — 通过
```
/suno/wav
```
、
```
/suno/midi
```
或
```
/suno/mp4
```
接口获取对应格式文件

Available Actions

可用操作

Action	Description
`generate`	Generate from prompt (default)
`extend`	Continue an existing audio from a timestamp
`upload_extend`	Upload external audio, then extend it
`upload_cover`	Upload external audio, then create a cover
`concat`	Concatenate extended segments into one track
`cover`	Copy the style of an existing audio
`artist_consistency`	Generate in a custom singer's style
`artist_consistency_vox`	Artist consistency with vocal focus
`stems`	Separate a track into stems
`all_stems`	Separate into all available stems
`replace_section`	Replace a specific time range in a song
`underpainting`	Add accompaniment to an uploaded song
`overpainting`	Add vocals to an uploaded song
`remaster`	Remaster an existing audio
`mashup`	Blend multiple audio IDs together
`samples`	Add samples to an uploaded song

操作	描述
`generate`	根据提示生成（默认操作）
`extend`	从指定时间点继续现有音频
`upload_extend`	上传外部音频后进行扩展
`upload_cover`	上传外部音频后制作翻唱
`concat`	将扩展片段拼接成单首曲目
`cover`	借鉴现有音频的风格
`artist_consistency`	以自定义歌手风格生成
`artist_consistency_vox`	聚焦人声的歌手风格一致性生成
`stems`	将曲目分离为音轨
`all_stems`	分离为所有可用音轨
`replace_section`	替换歌曲中特定时间段的内容
`underpainting`	为上传的歌曲添加伴奏
`overpainting`	为上传的歌曲添加人声
`remaster`	重新制作现有音频
`mashup`	将多个音频ID的内容混合
`samples`	为上传的歌曲添加采样

Auxiliary Endpoints

辅助接口

Endpoint	Method	Purpose
`/suno/lyrics`	POST	Generate structured lyrics from a prompt ( `model` : `"default"` or `"remi-v1"` )
`/suno/style`	POST	Optimize/refine a style description
`/suno/mashup-lyrics`	POST	Combine two sets of lyrics
`/suno/mp4`	POST	Get MP4 video version of a song
`/suno/wav`	POST	Convert to lossless WAV format
`/suno/midi`	POST	Extract MIDI data for DAW editing
`/suno/vox`	POST	Extract vocal track (stem separation)
`/suno/timing`	POST	Get word-level timing/subtitles
`/suno/persona`	POST	Save a vocal style as a reusable persona
`/suno/upload`	POST	Upload external audio for extend/cover
`/suno/tasks`	POST	Query task status and results

接口	请求方法	用途
`/suno/lyrics`	POST	根据提示生成结构化歌词（ `model` 可选 `"default"` 或 `"remi-v1"` ）
`/suno/style`	POST	优化/细化风格描述
`/suno/mashup-lyrics`	POST	合并两组歌词
`/suno/mp4`	POST	获取歌曲的MP4视频版本
`/suno/wav`	POST	转换为无损WAV格式
`/suno/midi`	POST	提取MIDI数据用于DAW编辑
`/suno/vox`	POST	提取人声轨（音轨分离）
`/suno/timing`	POST	获取逐词时间轴/字幕
`/suno/persona`	POST	将人声风格保存为可重用的角色
`/suno/upload`	POST	上传外部音频用于扩展/翻唱
`/suno/tasks`	POST	查询任务状态和结果

Advanced Parameters

高级参数

Parameter	Type	Description
`lyric_prompt`	object	Structured prompt payload for auto-generating lyrics (used when `custom: true` without explicit `lyric` )
`style_negative`	string	Style tags to avoid (e.g., `"heavy metal, distortion"` )
`style_influence`	number	Strength of style influence (advanced custom mode, v5+ only)
`audio_weight`	number	Weight for audio reference when covering (advanced, v5+ only)

参数	类型	描述
`lyric_prompt`	object	用于自动生成歌词的结构化提示负载（当 `custom: true` 且未显式传入 `lyric` 时使用）
`style_negative`	string	需要避免的风格标签（例如： `"heavy metal, distortion"` ）
`style_influence`	number	风格影响强度（高级自定义模式，仅v5+模型支持）
`audio_weight`	number	制作翻唱时音频参考的权重（高级功能，仅v5+模型支持）

Lyrics Format

歌词格式

Use section markers in square brackets:

[Verse 1]
Your verse lyrics here

[Chorus]
Catchy chorus lyrics

[Bridge]
Bridge section

[Outro]
Ending lyrics

使用方括号包裹段落标记：

[Verse 1]
Your verse lyrics here

[Chorus]
Catchy chorus lyrics

[Bridge]
Bridge section

[Outro]
Ending lyrics

Gotchas

注意事项

All generation is async — always set

"callback_url"

to get a task id immediately, then poll

/suno/tasks

using

{"id":"<task_id>"}

{"ids":[...],"action":"retrieve_batch"}

CRITICAL: Check the
```
state
```
field — only
```
state: "complete"
```
with
```
success: true
```
means done. During
```
pending
```
, the API may return intermediate
```
audio_url
```
values (streaming previews). Do NOT stop polling just because
```
audio_url
```
is non-empty
Lyrics max ~3000 characters. For longer songs, use the extend workflow
Style tags are descriptive phrases, not enum values (e.g., "Synthwave, Electronic, Dreamy")
```
vocal_gender
```
("f"/"m") is only supported on v4.5+ models
```
variation_category
```
("high"/"normal"/"subtle") is only supported on v5+ models
The
```
concat
```
action merges extended song segments — requires audio_id of the extended track
```
persona
```
requires an existing audio_id to extract the vocal reference from
Upload external audio via
```
/suno/upload
```
before using it with extend/cover

MCP:
pip install mcp-suno
| Hosted:
https://suno.mcp.acedata.cloud/mcp
| See all MCP servers

所有生成操作均为异步 — 请务必设置
```
"callback_url"
```
以立即获取任务ID，然后通过
```
{"id":"<task_id>"}
```
或
```
{"ids":[...],"action":"retrieve_batch"}
```
调用
```
/suno/tasks
```
接口进行轮询
重要提示： 检查
```
state
```
字段 — 只有当
```
state: "complete"
```
且
```
success: true
```
时表示任务完成。在
```
pending
```
状态下，API可能会返回临时的
```
audio_url
```
值（流式预览）。不要因为
```
audio_url
```
非空就停止轮询
歌词最大约3000字符。如需创作更长歌曲，请使用扩展工作流程
风格标签为描述性短语，而非枚举值（例如："Synthwave, Electronic, Dreamy"）
```
vocal_gender
```
（"f"/"m"）仅在v4.5+模型上支持
```
variation_category
```
（"high"/"normal"/"subtle"）仅在v5+模型上支持
```
concat
```
操作用于合并歌曲扩展片段 — 需要传入扩展曲目对应的audio_id
```
persona
```
功能需要现有音频的audio_id来提取人声参考
在使用extend/cover操作前，需通过
```
/suno/upload
```
接口上传外部音频

MCP：
pip install mcp-suno
| 托管地址：
https://suno.mcp.acedata.cloud/mcp
| 查看所有MCP服务器