Suno 歌曲生成 API 对接说明
YoYAI 套餐明细（企业商业合作请联系邮箱：support@yoy-ai.com）
| 套餐等级 | 积分总量 | 优惠价格 (税前) | 税后价格 (加5.3%) | 折扣力度 |
|---|---|---|---|---|
| 基础版 | 100 | ¥98.0 | ¥103 | 9.8折 |
| 白银版 | 540 | ¥520.0 | ¥548 | 9.629折 |
| 黄金版 | 1,120 | ¥1050.0 | ¥1,106 | 9.375折 |
| 铂金版 | 6,000 | ¥5,450.00 | ¥5,739 | 9.083折 |
| 钻石版 | 13,000 | ¥11,400.00 | ¥12,004 | 8.769折 |
| 尊享版 | 25,200 | ¥21,550.00 | ¥22,692 | 8.551折 |
| 旗舰版 | 68,000 | ¥55,800.00 | ¥58,757 | 8.206折 |
| 至尊版 | 143,000 | ¥114,400.00 | ¥120,463 | 8.0折 |
注：只有开具 6% 增值税普通发票或专用发票时，才需按照“税后价格”进行结算。
积分消耗说明
| 功能项目 | 价格 |
|---|---|
| 普通池 | |
| 4.0以下模型 | 0.38 |
| chirp-v4-5-lite模型 | 0.38 |
| 专业池 | |
| 4.0以下模型 | 0.5 |
| 4.0及以上模型 | 0.5 |
| 其他功能 | |
| 拼接功能(concat) | 0.25 |
| 添加片段(add_section) | 0.5 |
| 替换片段(replace_section/simple_replace_section) | 0.5 |
| 双音轨分离(stems) | 0.5 |
| 灵感生成(inspiration) | 0.5 |
| 混曲生成(mashup) | 0.5 |
| Sounds生成(sounds) | 0.11 |
| 朗读生成(Speech) | 0.5 |
| 采样生成(sample) | 0.5 |
| 重新生成(remaster) | 0.5 |
| 添加伴奏(add_stems) | 0.5 |
| 自定义歌曲添加人声功能(add_vocals) | 0.5 |
| 自定义歌曲添加伴奏功能(add_instrumental) | 0.5 |
| 全音轨分离(all_stems) | 2.5 |
| 自定义MP4 | 0.12 |
| 真人Voice | 0.1 |
| 裁剪（crop）/ 淡入（fade_in）/ 淡出（fade_out）/ 删除片段（remove_section）/ 复制片段（duplicate_section）/ 批量编辑（batch_edit） | 0.04 |
| 歌词生成 | 0.02 |
| Persona | 0.01 |
| Upload | 0.01 |
| Timing | 0.01 |
| Downbeat | 0.01 |
| MIDI | 0.01 |
| HTML | 0.01 |
| Suno MP3 | 0.01 |
| Suno Images | 0.04 |
注意：高级参数max_mode默认是false，如果max_mode为true，则消耗的积分为双倍！！！
非Studio平台功能
基本生成：灵感模式
想些什么歌曲，可以任意输入一段文字，比如我想生成一个关于新年快乐的歌曲，就可以输入 新年快乐，下面使用apifox进行发送请求，具体的参数如下所示：
json
{
"action": "generate",
"instrumental": false,
"prompt": "新年快乐",
"model": "chirp-v6"
}可以点击发送按钮直接测试 API，稍等 1-2 分钟，结果如下：
json
{
"success": true,
"task_id": "caac373c-2be1-4cfe-8e1f-8d1801619ac6",
"trace_id": "70017c31-cde5-4b89-b20b-749cc674f596",
"data": [
{
"id": "2d929df5-2c89-42ad-ac1f-651e14e86610",
"title": "这一桌团圆",
"image_url": "https://cdn2.suno.ai/image_2d929df5-2c89-42ad-ac1f-651e14e86610.jpeg",
"lyric": "[Verse 1]\n厨房飘来橘子香\n窗花贴在旧木窗\n你把红围巾递给我\n说今年别再怕风凉\n门外脚步声渐近\n一桌热菜等着尝\n长辈笑着添一碗\n孩子数着糖果藏\n[Pre-Chorus]\n把去年的忙和累\n轻轻放在门外\n抬头看你眉眼弯\n好日子正赶来\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个归家的人都有灯火\n举杯说声，新年快乐\n把没说完的拥抱都留给此刻\n新年快乐，愿你心愿开花\n愿寻常的日子也闪着光啊\n你在身旁，年就到了\n这一桌团圆就是最好的回答\n[Verse 2]\n楼下邻居互道好\n红包压着祝福话\n你说明年想去看看\n海边第一道朝霞\n老照片翻到那年\n我们还不懂牵挂\n如今这一声“回来啦”\n胜过多少漂亮话\n[Pre-Chorus]\n把去年的忙和累\n轻轻放在门外\n抬头看你眉眼弯\n好日子正赶来\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个归家的人都有灯火\n举杯说声，新年快乐\n把没说完的拥抱都留给此刻\n新年快乐，愿你心愿开花\n愿寻常的日子也闪着光啊\n你在身旁，年就到了\n这一桌团圆就是最好的回答\n[Bridge]\n若路很远，就慢慢走\n若心很累，就回家坐\n明天的事明天再说\n今晚我们一起唱着\n[Final Chorus]\n新年快乐，愿你平安喜乐\n愿每个归家的人都有灯火\n举杯说声，新年快乐\n把没说完的拥抱都留给此刻\n新年快乐，愿你心愿开花\n愿寻常的日子也闪着光啊\n你在身旁，年就到了\n这一桌团圆就是最好的回答\n[Outro]\n新年快乐，常常相见\n新年快乐，岁岁团圆",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/12/2d929df5-2c89-42ad-ac1f-651e14e86610.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261012%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261012T163728Z&X-Amz-Expires=86400&X-Amz-Signature=afae6d00fb260ddcccd5e66bd831255708e6cb9fa64d11408c582e2932ee9a5a&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-12T16:36:33.969Z",
"model": "chirp-hawk",
"state": "succeeded",
"prompt": "新年快乐",
"style": "Mandarin festive pop, bright buoyant 4/4 groove with handclaps, crisp pop drums, plucked yangqin and pipa accents, warm piano chords, rounded bass, tasteful suona flourishes in the chorus; intimate conversational verses open into a communal singalong refrain, layered group responses, polished lively mix with a short celebratory instrumental outro",
"display_style": "festive pop, Mandarin pop",
"metadata": {
"tags": "Mandarin festive pop, bright buoyant 4/4 groove with handclaps, crisp pop drums, plucked yangqin and pipa accents, warm piano chords, rounded bass, tasteful suona flourishes in the chorus; intimate conversational verses open into a communal singalong refrain, layered group responses, polished lively mix with a short celebratory instrumental outro",
"task": "agentic_thinking",
"type": "gen",
"prompt": "[Verse 1]\n厨房飘来橘子香\n窗花贴在旧木窗\n你把红围巾递给我\n说今年别再怕风凉\n门外脚步声渐近\n一桌热菜等着尝\n长辈笑着添一碗\n孩子数着糖果藏\n\n[Pre-Chorus]\n把去年的忙和累\n轻轻放在门外\n抬头看你眉眼弯\n好日子正赶来\n\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个归家的人都有灯火\n举杯说声，新年快乐\n把没说完的拥抱都留给此刻\n新年快乐，愿你心愿开花\n愿寻常的日子也闪着光啊\n你在身旁，年就到了\n这一桌团圆就是最好的回答\n\n[Verse 2]\n楼下邻居互道好\n红包压着祝福话\n你说明年想去看看\n海边第一道朝霞\n老照片翻到那年\n我们还不懂牵挂\n如今这一声“回来啦”\n胜过多少漂亮话\n\n[Pre-Chorus]\n把去年的忙和累\n轻轻放在门外\n抬头看你眉眼弯\n好日子正赶来\n\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个归家的人都有灯火\n举杯说声，新年快乐\n把没说完的拥抱都留给此刻\n新年快乐，愿你心愿开花\n愿寻常的日子也闪着光啊\n你在身旁，年就到了\n这一桌团圆就是最好的回答\n\n[Bridge]\n若路很远，就慢慢走\n若心很累，就回家坐\n明天的事明天再说\n今晚我们一起唱着\n\n[Final Chorus]\n新年快乐，愿你平安喜乐\n愿每个归家的人都有灯火\n举杯说声，新年快乐\n把没说完的拥抱都留给此刻\n新年快乐，愿你心愿开花\n愿寻常的日子也闪着光啊\n你在身旁，年就到了\n这一桌团圆就是最好的回答\n\n[Outro]\n新年快乐，常常相见\n新年快乐，岁岁团圆",
"stream": true,
"duration": 212.41,
"has_stem": false,
"is_remix": false,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"show_remix": true,
"image_config": {
"id": "minimal_album_art",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songrow": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"display_name": "v6"
},
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"vox_render_mode": "strict",
"make_instrumental": false,
"uses_latest_model": true,
"gpt_description_prompt": "新年快乐"
},
"duration": 212.41
},
{
"id": "6597298c-a48c-4f5a-bc2e-a9f05b2dc8b5",
"title": "这一桌团圆",
"image_url": "https://cdn2.suno.ai/image_6597298c-a48c-4f5a-bc2e-a9f05b2dc8b5.jpeg",
"lyric": "[Verse 1]\n厨房飘来橘子香\n窗花贴在旧木窗\n你把红围巾递给我\n说今年别再怕风凉\n门外脚步声渐近\n一桌热菜等着尝\n长辈笑着添一碗\n孩子数着糖果藏\n[Pre-Chorus]\n把去年的忙和累\n轻轻放在门外\n抬头看你眉眼弯\n好日子正赶来\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个归家的人都有灯火\n举杯说声，新年快乐\n把没说完的拥抱都留给此刻\n新年快乐，愿你心愿开花\n愿寻常的日子也闪着光啊\n你在身旁，年就到了\n这一桌团圆就是最好的回答\n[Verse 2]\n楼下邻居互道好\n红包压着祝福话\n你说明年想去看看\n海边第一道朝霞\n老照片翻到那年\n我们还不懂牵挂\n如今这一声“回来啦”\n胜过多少漂亮话\n[Pre-Chorus]\n把去年的忙和累\n轻轻放在门外\n抬头看你眉眼弯\n好日子正赶来\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个归家的人都有灯火\n举杯说声，新年快乐\n把没说完的拥抱都留给此刻\n新年快乐，愿你心愿开花\n愿寻常的日子也闪着光啊\n你在身旁，年就到了\n这一桌团圆就是最好的回答\n[Bridge]\n若路很远，就慢慢走\n若心很累，就回家坐\n明天的事明天再说\n今晚我们一起唱着\n[Final Chorus]\n新年快乐，愿你平安喜乐\n愿每个归家的人都有灯火\n举杯说声，新年快乐\n把没说完的拥抱都留给此刻\n新年快乐，愿你心愿开花\n愿寻常的日子也闪着光啊\n你在身旁，年就到了\n这一桌团圆就是最好的回答\n[Outro]\n新年快乐，常常相见\n新年快乐，岁岁团圆",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/12/6597298c-a48c-4f5a-bc2e-a9f05b2dc8b5.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261012%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261012T163729Z&X-Amz-Expires=86400&X-Amz-Signature=de2b3a6cb540f68759b503858f00c800bfde035d21c3426379accb365cc95a2d&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-12T16:36:33.969Z",
"model": "chirp-hawk",
"state": "succeeded",
"prompt": "新年快乐",
"style": "Mandarin festive pop, bright buoyant 4/4 groove with handclaps, crisp pop drums, plucked yangqin and pipa accents, warm piano chords, rounded bass, tasteful suona flourishes in the chorus; intimate conversational verses open into a communal singalong refrain, layered group responses, polished lively mix with a short celebratory instrumental outro",
"display_style": "festive pop, Mandarin pop",
"metadata": {
"key": "C_major",
"tags": "Mandarin festive pop, bright buoyant 4/4 groove with handclaps, crisp pop drums, plucked yangqin and pipa accents, warm piano chords, rounded bass, tasteful suona flourishes in the chorus; intimate conversational verses open into a communal singalong refrain, layered group responses, polished lively mix with a short celebratory instrumental outro",
"task": "agentic_thinking",
"type": "gen",
"prompt": "[Verse 1]\n厨房飘来橘子香\n窗花贴在旧木窗\n你把红围巾递给我\n说今年别再怕风凉\n门外脚步声渐近\n一桌热菜等着尝\n长辈笑着添一碗\n孩子数着糖果藏\n\n[Pre-Chorus]\n把去年的忙和累\n轻轻放在门外\n抬头看你眉眼弯\n好日子正赶来\n\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个归家的人都有灯火\n举杯说声，新年快乐\n把没说完的拥抱都留给此刻\n新年快乐，愿你心愿开花\n愿寻常的日子也闪着光啊\n你在身旁，年就到了\n这一桌团圆就是最好的回答\n\n[Verse 2]\n楼下邻居互道好\n红包压着祝福话\n你说明年想去看看\n海边第一道朝霞\n老照片翻到那年\n我们还不懂牵挂\n如今这一声“回来啦”\n胜过多少漂亮话\n\n[Pre-Chorus]\n把去年的忙和累\n轻轻放在门外\n抬头看你眉眼弯\n好日子正赶来\n\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个归家的人都有灯火\n举杯说声，新年快乐\n把没说完的拥抱都留给此刻\n新年快乐，愿你心愿开花\n愿寻常的日子也闪着光啊\n你在身旁，年就到了\n这一桌团圆就是最好的回答\n\n[Bridge]\n若路很远，就慢慢走\n若心很累，就回家坐\n明天的事明天再说\n今晚我们一起唱着\n\n[Final Chorus]\n新年快乐，愿你平安喜乐\n愿每个归家的人都有灯火\n举杯说声，新年快乐\n把没说完的拥抱都留给此刻\n新年快乐，愿你心愿开花\n愿寻常的日子也闪着光啊\n你在身旁，年就到了\n这一桌团圆就是最好的回答\n\n[Outro]\n新年快乐，常常相见\n新年快乐，岁岁团圆",
"stream": true,
"avg_bpm": 125.92,
"max_bpm": 136.36,
"min_bpm": 120,
"duration": 213.96,
"has_stem": false,
"is_remix": false,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"show_remix": true,
"image_config": {
"id": "minimal_album_art",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songrow": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"display_name": "v6"
},
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"refund_credits": false,
"vox_render_mode": "strict",
"make_instrumental": false,
"uses_latest_model": true,
"gpt_description_prompt": "新年快乐"
},
"duration": 213.96
}
]
}可以看到这时候我们就得到了两首歌的内容，包括标题、预览图、歌词、音频、视频等内容。
字段说明如下：
- success：生成是否成功，如果成功则为
true，否则为false - data：是一个列表，包含了生成的歌曲的详细信息。
- state： 歌曲生成状态，主要包含四种，具体的如下：
- succeeded：生成成功
- pending：队列中
- running：执行中
- error：失败
- id：歌曲 ID
- title：歌曲的标题
- image_url：歌曲的封面图片
- lyric：歌曲的歌词
- audio_url：歌曲的音频文件，打开就是一个 mp3、m4a、wav 音频(注意此链接只有一天有效期，请及时转存！)。
- video_url：歌曲的视频文件，打开就是一个 mp4 视频(目前官方已经不支持生成视频，请忽略此字段)。
- created_at：创建的时间
- model：使用的模型，一般是最新的 v6 模型
- style：风格
- state： 歌曲生成状态，主要包含四种，具体的如下：
自定义生成：自定义模式
如果想自定义生成歌词，可以输入歌词：
这时候 lyric 字段可以传入类似如下内容：
[Pre-Chorus – Subtle choir enters]\nThe storm is gone, and the sky is clear\nStill I remember you, always near\n[Chorus – Broader orchestration, emotional but controlled]\nSilent horizon, where the light begins\nGuiding me onward, through the dark within\nEven in sorrow, hope will find a way\nSilent horizon, a brand-new day\n[Instrumental Break – Cinematic, orchestral with French horn + piano theme]\n(Strings swell, French horn carries the melody, piano echoes softly.\nGradually builds, then falls into silence, leaving a single violin line.)\n[Bridge – Voice enters gently after the violin]\nThough the night tried to chain me\nI will not remain the same\nThrough the dawn, you have saved me\nCalling out my name\n[Short Instrumental Break – Just before Final Chorus]\n(Simple piano arpeggio, no build-up, like holding a breath before release)\n[Final Chorus – Full orchestra, restrained but deeply emotional]\nSilent horizon, where the light begins\nGuiding me onward, through the dark within\nEven in sorrow, hope will find a way\nSilent horizon, I hear you say: stay\n[Outro – Voice over quiet strings, fading like distant memory]\nSilent horizon…\nSilent horizon…\nI walk into the light…\nWith you inside…\n[Ending – Scat only, intimate and cinematic]\n(Soft “ah… ah…” over sustained strings,\nlike tears flowing silently, fading into darkness.\nNo high notes, keep it warm, low-mid register.\nFinal chord: strings and piano fade to silence.)注意，这里的歌词中
\n是换行符，如果你不知道如何生成歌词，可以使用 YoYAI 提供的歌词生成 API 来通过 prompt 生成歌词。
接下来我们要根据歌词、标题、风格自定义生成歌曲，就可以指定如下内容：
- lyric：歌词文本
- custom：填写为
true，代表自定义生成，该参数默认为 false，代表使用prompt生成。 - title：歌曲的标题。
- style：歌曲的风格，选填。
填写样例如下：
json
{
"action": "generate",
"lyric": "[Pre-Chorus – Subtle choir enters]\nThe storm is gone, and the sky is clear\nStill I remember you, always near\n[Chorus – Broader orchestration, emotional but controlled]\nSilent horizon, where the light begins\nGuiding me onward, through the dark within\nEven in sorrow, hope will find a way\nSilent horizon, a brand-new day\n[Instrumental Break – Cinematic, orchestral with French horn + piano theme]\n(Strings swell, French horn carries the melody, piano echoes softly.\nGradually builds, then falls into silence, leaving a single violin line.)\n[Bridge – Voice enters gently after the violin]\nThough the night tried to chain me\nI will not remain the same\nThrough the dawn, you have saved me\nCalling out my name\n[Short Instrumental Break – Just before Final Chorus]\n(Simple piano arpeggio, no build-up, like holding a breath before release)\n[Final Chorus – Full orchestra, restrained but deeply emotional]\nSilent horizon, where the light begins\nGuiding me onward, through the dark within\nEven in sorrow, hope will find a way\nSilent horizon, I hear you say: stay\n[Outro – Voice over quiet strings, fading like distant memory]\nSilent horizon…\nSilent horizon…\nI walk into the light…\nWith you inside…\n[Ending – Scat only, intimate and cinematic]\n(Soft “ah… ah…” over sustained strings,\nlike tears flowing silently, fading into darkness.\nNo high notes, keep it warm, low-mid register.\nFinal chord: strings and piano fade to silence.)",
"model": "chirp-v6",
"custom": true,
"vocal_gender": "f",
"weirdness": 0.3,
"audio_influence": 0.8,
"style_influence": 0.8
}最后发送请求，生成的结果是类似的。
继续生成功能：对标Extend功能
如果想对已经生成的Suno歌曲进行继续生成的话（支持跨账号操作），可以将参数 action 设置为 extend ，并且输入需要继续生成歌曲的 ID，歌曲 ID 的获取是根据基本使用来获取，如下图所示：
这时候可以看到歌曲的 ID 为：
"id": "2d929df5-2c89-42ad-ac1f-651e14e86610"注意，这里的歌词中
id可以是官方生成后歌曲的 ID，也可以是自定义上传的歌曲ID，如果你不知道如何生成歌曲，可以参考上文的基本使用来生成歌曲。如果想在续写的基础上使用歌手风格进行续写的话需要加俩个参数，分别是：创建歌手风格的源IDpersona_root_id，以及创建好Persona的IDpersona_id，注意此时只允许使用自定义生成歌曲。
接下来我们要必须填歌词、风格自定义生成歌曲，就可以指定如下内容：
- lyric：歌词文本
- origin_lyric：2027-01-17更新：针对
action为extend时，该参数必须传，表示歌曲原来时长在0-continue_at的原歌词信息，如果不传可能结果会对不上lyric。获取原歌曲的原歌词信息可以通过Timing接口进行获取。 - custom：填写为
true，代表自定义生成，该参数默认为 false，代表使用prompt生成。 - style：歌曲的风格，选填。
- continue_at：以秒为单位继续现有音频的时间。例如，213.5 表示继续到 3 分 33.5 秒，经内部测试，官方会限制续写时长，续写时长最大值是原歌曲时长的70%，如果超过原歌曲的70%可能会出现歌曲时长很短的情况。
填写样例如下：
json
{
"action": "extend",
"instrumental": false,
"custom": true,
"prompt": "",
"model": "chirp-v6",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"origin_lyric": "[Verse]\nThere's a bird on a wire just watching the day\nClouds drift like ships\nThey’re sailing away\nThe grass hums soft under my feet\n\n[Chorus]\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I’m down below\nBeneath the orange sky\nWhere dreams start to glow\n\n[Verse 2]\nA whisper of wind tangles my hair\nThe scent of the earth is thick in the air\nI close my eyes\nBut I’m wide awake\n\n[Prechorus]\nEvery moment\nIt slips\nLike water through fingertips\n\n[Chorus]\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I’m down below\nBeneath the orange sky\nWhere dreams start to glow",
"title": "Roots in the Sky",
"style": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"audio_id": "707a09fc-8789-4087-b915-4493e86d8c59",
"continue_at": 149
}点击发送，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "ab4fad61-18ab-49cb-9ed3-a4da76a70664",
"trace_id": "d1868e86-e5d7-4121-92ee-931071ae0fce",
"data": [
{
"id": "a9e0bed9-ca61-4a68-b412-294f02dd4729",
"title": "Roots in the Sky",
"image_url": "https://cdn2.suno.ai/image_a9e0bed9-ca61-4a68-b412-294f02dd4729.jpeg",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/12/a9e0bed9-ca61-4a68-b412-294f02dd4729.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261012%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261012T164157Z&X-Amz-Expires=86400&X-Amz-Signature=b56494774e888208b847d6b76e7452b7472ee9486f67c4e858f209b6ec37245b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-12T16:41:11.816Z",
"model": "chirp-hawk",
"state": "succeeded",
"style": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"display_style": "soul, ambient, ballad",
"metadata": {
"tags": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"task": "extend",
"type": "gen",
"infill": false,
"prompt": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"stream": true,
"history": [
{
"id": "707a09fc-8789-4087-b915-4493e86d8c59",
"type": "gen",
"infill": false,
"source": "ios",
"continue_at": 149,
"source_is_webview": false
}
],
"duration": 121,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"continue_at": 149,
"image_config": {
"id": "minimal_album_art",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songrow": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"display_name": "v6"
},
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"edited_clip_id": "707a09fc-8789-4087-b915-4493e86d8c59",
"refund_credits": false,
"vox_render_mode": "strict",
"secondary_badges": [
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "part",
"display_name": "Extend 1"
}
],
"make_instrumental": false,
"uses_latest_model": true
},
"duration": 121
},
{
"id": "0d987085-8059-4a13-b74e-54d30c7b1dff",
"title": "Roots in the Sky",
"image_url": "https://cdn2.suno.ai/image_0d987085-8059-4a13-b74e-54d30c7b1dff.jpeg",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/12/0d987085-8059-4a13-b74e-54d30c7b1dff.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261012%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261012T164152Z&X-Amz-Expires=86400&X-Amz-Signature=28c3beb643fdc396c18b9a12b3ae6ccdc9538a968070cce13b63f61ce50dd672&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-12T16:41:11.816Z",
"model": "chirp-hawk",
"state": "succeeded",
"style": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"display_style": "soul, ambient, ballad",
"metadata": {
"key": "Eb_minor",
"tags": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"task": "extend",
"type": "gen",
"infill": false,
"prompt": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"stream": true,
"avg_bpm": 145.08,
"history": [
{
"id": "707a09fc-8789-4087-b915-4493e86d8c59",
"type": "gen",
"infill": false,
"source": "ios",
"continue_at": 149,
"source_is_webview": false
}
],
"max_bpm": 157.89,
"min_bpm": 136.36,
"duration": 120.56,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"continue_at": 149,
"image_config": {
"id": "minimal_album_art",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songrow": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"display_name": "v6"
},
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"edited_clip_id": "707a09fc-8789-4087-b915-4493e86d8c59",
"refund_credits": false,
"vox_render_mode": "strict",
"secondary_badges": [
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "part",
"display_name": "Extend 1"
}
],
"make_instrumental": false,
"uses_latest_model": true
},
"duration": 120.56
}
]
}可以看出，结果内容与上文的是一致的，这也就实现歌曲的继续生成功能，但如果想获取继续生成的完整歌曲还需要使用下面的拼接功能来获取。
获取完整歌曲：对标Get Full Song功能
当基于原有的歌曲继续生成歌曲之后，返回的歌曲并不包含原来的歌曲内容。如果要获得完整的歌曲内容，需要使用拼接功能，就可以指定如下内容：
- action：内容为
concat。 - audio_id：最后一个片段的 ID。
比如扩展后的歌曲 ID 是：19ba4bb9-c90a-41ba-874d-40e5942e7d26，那么可以设置参数如下：
json
{
"action": "concat",
"audio_id": "19ba4bb9-c90a-41ba-874d-40e5942e7d26"
}其他参数不变，返回的就是一首完整的歌曲，就是所有歌曲片段的拼接结果，但结果只有一首歌，样例如下：
json
{
"success": true,
"task_id": "78fd3320-b970-45d6-b662-f5ba57ed8ea6",
"trace_id": "b06bfc66-0052-447a-8e0f-d7c3652e929e",
"data": [
{
"id": "743d1d01-37f1-4009-bce9-4132312e6c14",
"title": "Orange Sky Rhapsody",
"image_url": "https://cdn2.suno.ai/image_539e4b09-3276-48f1-9574-e4cf6abecf79.jpeg",
"lyric": "[Verse]\nThere's a bird on a wire just watching the day\nClouds drift like ships\nThey’re sailing away\nThe grass hums soft under my feet\n[Chorus]\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I’m down below\nBeneath the orange sky\nWhere dreams start to glow\n[Verse 2]\nA whisper of wind tangles my hair\nThe scent of the earth is thick in the air\nI close my eyes\nBut I’m wide awake\n[Prechorus]\nEvery moment\nIt slips\nLike water through fingertips\n[Chorus]\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I’m down below\nBeneath the orange sky\nWhere dreams start to glow\n[Bridge]\nNo map\nNo guide\nNo plan in my hand\nJust the pull of the tide\nThe call of the land\nThe sun sinks slow\nPaints the world in fire\n(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/12/743d1d01-37f1-4009-bce9-4132312e6c14.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261012%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261012T165634Z&X-Amz-Expires=86400&X-Amz-Signature=3a13f39966da500491c124d1ba4cb9c07f83a36c4c73b6357d04c3338290ea9a&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-12T16:56:05.140Z",
"model": "chirp-hawk",
"state": "succeeded",
"style": "Bedroom R&B, muted guitar, soft drums, close-mic vocals, private mood, 72 bpm",
"display_style": "",
"metadata": {
"tags": "Bedroom R&B, muted guitar, soft drums, close-mic vocals, private mood, 72 bpm",
"type": "concat",
"prompt": "[Verse]\nThere's a bird on a wire just watching the day\nClouds drift like ships\nThey’re sailing away\nThe grass hums soft under my feet\n\n[Chorus]\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I’m down below\nBeneath the orange sky\nWhere dreams start to glow\n\n[Verse 2]\nA whisper of wind tangles my hair\nThe scent of the earth is thick in the air\nI close my eyes\nBut I’m wide awake\n\n[Prechorus]\nEvery moment\nIt slips\nLike water through fingertips\n\n[Chorus]\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I’m down below\nBeneath the orange sky\nWhere dreams start to glow\n\n[Bridge]\nNo map\nNo guide\nNo plan in my hand\nJust the pull of the tide\nThe call of the land\nThe sun sinks slow\nPaints the world in fire\n\n(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"duration": 282.04,
"has_stem": false,
"is_remix": true,
"can_remix": true,
"model_badges": {
"songrow": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"display_name": "v6"
},
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"concat_history": [
{
"id": "707a09fc-8789-4087-b915-4493e86d8c59",
"type": "gen",
"infill": false,
"source": "ios",
"continue_at": 149,
"source_is_webview": false
},
{
"id": "539e4b09-3276-48f1-9574-e4cf6abecf79"
}
],
"vox_render_mode": "strict",
"secondary_badges": [
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "full_song",
"display_name": "Full Song"
}
],
"uses_latest_model": true,
"can_publish_with_vocal": true
},
"duration": 282.04,
"concat_history": [
{
"id": "707a09fc-8789-4087-b915-4493e86d8c59",
"type": "gen",
"infill": false,
"source": "ios",
"continue_at": 149,
"source_is_webview": false
},
{
"id": "539e4b09-3276-48f1-9574-e4cf6abecf79"
}
]
}
]
}获取双轨道人声分离：对标Get Stems功能
当基于Pro池(或者v4及以上模型的歌曲)生成歌曲之后，我们需要对歌曲进行人声分离操作，需要使用人声分离功能，就可以指定如下内容：
- action：内容为
stems。 - audio_id：需要人声分离的歌曲ID。
比如基于Pro池生成后的歌曲 ID 是：539e4b09-3276-48f1-9574-e4cf6abecf79，注意必须是Pro池生成的歌曲！！！那么可以设置参数如下：
json
{
"action": "stems",
"audio_id": "539e4b09-3276-48f1-9574-e4cf6abecf79"
}其他参数不变，返回的就是一个人声分离的结果，主要包含人声和伴奏，样例如下：
json
{
"success": true,
"task_id": "25d646fc-7596-40cf-8322-215340863518",
"trace_id": "f45110f5-b214-4191-9ed1-6a1c7a41ef1a",
"data": [
{
"id": "a87b71e5-262d-49cb-8e11-e1fbea45f539",
"title": "(Vocals)",
"image_url": "https://cdn2.suno.ai/image_a87b71e5-262d-49cb-8e11-e1fbea45f539.jpeg",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/12/a87b71e5-262d-49cb-8e11-e1fbea45f539.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261012%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261012T170711Z&X-Amz-Expires=86400&X-Amz-Signature=2b2e6671344c1b8076cd737a06560146d4060c6be87c450dedcbc8df07dbcab6&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-12T17:06:45.372Z",
"model": "chirp-haddock",
"state": "succeeded",
"style": "",
"display_style": "",
"metadata": {
"tags": "",
"task": "gen_stem",
"type": "gen",
"infill": false,
"prompt": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"stream": true,
"history": [
{
"id": "707a09fc-8789-4087-b915-4493e86d8c59",
"type": "gen",
"infill": false,
"source": "ios",
"continue_at": 149,
"source_is_webview": false
},
{
"id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"type": "gen",
"infill": false,
"source": "ios",
"stem_task": "two",
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"source_is_webview": false,
"stem_type_group_name": "Two"
}
],
"duration": 133.04,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"stem_task": "two",
"image_config": {
"id": "scribbles",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"edited_clip_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"refund_credits": false,
"vox_render_mode": "strict",
"secondary_badges": [
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "stem",
"display_name": "Stem"
},
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "part",
"display_name": "Extend 1"
}
],
"make_instrumental": false,
"uses_latest_model": true,
"stem_type_group_name": "Vocals",
"is_loudness_under_threshold": false
},
"duration": 133.04
},
{
"id": "39bbd216-e12c-43c2-a3b0-6532bb8eb626",
"title": "(Instrumental)",
"image_url": "https://cdn2.suno.ai/image_39bbd216-e12c-43c2-a3b0-6532bb8eb626.jpeg",
"lyric": "",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/12/39bbd216-e12c-43c2-a3b0-6532bb8eb626.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261012%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261012T170719Z&X-Amz-Expires=86400&X-Amz-Signature=2537ef80af3c1edd3741031d7229463a970f391aa3bbfc275be701297c92ba9d&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-12T17:06:45.372Z",
"model": "chirp-haddock",
"state": "succeeded",
"style": "",
"display_style": "",
"metadata": {
"tags": "",
"task": "gen_stem",
"type": "gen",
"infill": false,
"prompt": "",
"stream": true,
"history": [
{
"id": "707a09fc-8789-4087-b915-4493e86d8c59",
"type": "gen",
"infill": false,
"source": "ios",
"continue_at": 149,
"source_is_webview": false
},
{
"id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"type": "gen",
"infill": false,
"source": "ios",
"stem_task": "two",
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"source_is_webview": false,
"stem_type_group_name": "Two"
}
],
"duration": 133.04,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"stem_task": "two",
"image_config": {
"id": "scribbles",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"edited_clip_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"refund_credits": false,
"vox_render_mode": "strict",
"secondary_badges": [
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "stem",
"display_name": "Stem"
},
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "part",
"display_name": "Extend 1"
}
],
"make_instrumental": true,
"uses_latest_model": true,
"stem_type_group_name": "Instrumental",
"is_loudness_under_threshold": false
},
"duration": 133.04
},
{
"id": "dff93786-2764-4406-ac9c-644752de4474",
"title": "(Vocals)",
"image_url": "https://cdn2.suno.ai/image_dff93786-2764-4406-ac9c-644752de4474.jpeg",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/12/dff93786-2764-4406-ac9c-644752de4474.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261012%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261012T170720Z&X-Amz-Expires=86400&X-Amz-Signature=4b1375d64537be4de9d90f8c65870a628e46665e36b4358160be6c6af3698862&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-12T17:06:45.372Z",
"model": "chirp-haddock",
"state": "succeeded",
"style": "",
"display_style": "",
"metadata": {
"tags": "",
"task": "gen_stem",
"type": "gen",
"infill": false,
"prompt": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"stream": true,
"history": [
{
"id": "707a09fc-8789-4087-b915-4493e86d8c59",
"type": "gen",
"infill": false,
"source": "ios",
"continue_at": 149,
"source_is_webview": false
},
{
"id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"type": "gen",
"infill": false,
"source": "ios",
"stem_task": "two",
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"source_is_webview": false,
"stem_type_group_name": "Two"
}
],
"duration": 133.04,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"stem_task": "two",
"image_config": {
"id": "scribbles",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"edited_clip_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"refund_credits": false,
"vox_render_mode": "strict",
"secondary_badges": [
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "stem",
"display_name": "Stem"
},
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "part",
"display_name": "Extend 1"
}
],
"make_instrumental": false,
"uses_latest_model": true,
"stem_type_group_name": "Vocals",
"is_loudness_under_threshold": false
},
"duration": 133.04
},
{
"id": "685b6cbd-d620-4588-9205-a588dc1d6d09",
"title": "(Instrumental)",
"image_url": "https://cdn2.suno.ai/image_685b6cbd-d620-4588-9205-a588dc1d6d09.jpeg",
"lyric": "",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/12/685b6cbd-d620-4588-9205-a588dc1d6d09.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261012%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261012T170724Z&X-Amz-Expires=86400&X-Amz-Signature=e3774dc813dcdc5fcb4a310aa1b13421b70e83bcb984903d7ae6b1fbbfc2a3df&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-12T17:06:45.372Z",
"model": "chirp-haddock",
"state": "succeeded",
"style": "",
"display_style": "",
"metadata": {
"tags": "",
"task": "gen_stem",
"type": "gen",
"infill": false,
"prompt": "",
"stream": true,
"history": [
{
"id": "707a09fc-8789-4087-b915-4493e86d8c59",
"type": "gen",
"infill": false,
"source": "ios",
"continue_at": 149,
"source_is_webview": false
},
{
"id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"type": "gen",
"infill": false,
"source": "ios",
"stem_task": "two",
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"source_is_webview": false,
"stem_type_group_name": "Two"
}
],
"duration": 133.04,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"stem_task": "two",
"image_config": {
"id": "scribbles",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"edited_clip_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"refund_credits": false,
"vox_render_mode": "strict",
"secondary_badges": [
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "stem",
"display_name": "Stem"
},
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "part",
"display_name": "Extend 1"
}
],
"make_instrumental": true,
"uses_latest_model": true,
"stem_type_group_name": "Instrumental",
"is_loudness_under_threshold": false
},
"duration": 133.04
}
]
}获取全音轨分离：对标Get Stems功能
当基于Pro池生成歌曲之后，我们需要对歌曲进行全音轨分离操作，需要使用全音轨分离功能，就可以指定如下内容：
- action：内容为
all_stems。 - audio_id：需要全音轨分离的歌曲ID。
- callback_url：异步链接，不填是同步请求，填了就是异步请求。
比如基于Pro池生成后的歌曲 ID 是：539e4b09-3276-48f1-9574-e4cf6abecf79，注意必须是Pro池生成的歌曲！！！那么可以设置参数如下：
json
{
"action": "all_stems",
"audio_id": "539e4b09-3276-48f1-9574-e4cf6abecf79"
}其他参数不变，返回的就是一个全音轨分离的结果，最多包含12音轨分离的结果，样例如下：
json
{
"success": true,
"task_id": "9818a03d-f4a0-4e9a-8d0a-66fcd47afec5",
"trace_id": "41901e25-cff5-4f6f-be16-e23edd2571a2",
"data": [
{
"id": "564f8d7c-2c70-4d40-ae5e-c9d1bd6e6553",
"title": "(Vocals)",
"image_url": "https://cdn2.suno.ai/image_564f8d7c-2c70-4d40-ae5e-c9d1bd6e6553.jpeg",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/12/564f8d7c-2c70-4d40-ae5e-c9d1bd6e6553.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261012%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261012T170929Z&X-Amz-Expires=86400&X-Amz-Signature=c4f99f769fdcc6ed5d5c3e6d3ac216a561b70d8dbf557b7997dbefd1d52302e3&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-12T17:08:54.930Z",
"model": "chirp-haddock",
"state": "succeeded",
"style": "",
"display_style": "",
"metadata": {
"tags": "",
"task": "gen_stem",
"type": "gen",
"infill": false,
"prompt": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"stream": true,
"history": [
{
"id": "707a09fc-8789-4087-b915-4493e86d8c59",
"type": "gen",
"infill": false,
"source": "ios",
"continue_at": 149,
"source_is_webview": false
},
{
"id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"type": "gen",
"infill": false,
"source": "ios",
"stem_task": "twelve",
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"source_is_webview": false,
"stem_type_group_name": "Twelve"
}
],
"duration": 133.04,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"stem_task": "twelve",
"image_config": {
"id": "film_strip",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"edited_clip_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"refund_credits": false,
"vox_render_mode": "strict",
"secondary_badges": [
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "stem",
"display_name": "Stem"
},
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "part",
"display_name": "Extend 1"
}
],
"make_instrumental": false,
"uses_latest_model": true,
"stem_type_group_name": "Vocals",
"is_loudness_under_threshold": false
},
"duration": 133.04
},
...
{
"id": "19a8a1e8-1016-40da-8f83-a741629dc69c",
"title": "(Brass)",
"image_url": "https://cdn2.suno.ai/image_19a8a1e8-1016-40da-8f83-a741629dc69c.jpeg",
"lyric": "",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/12/19a8a1e8-1016-40da-8f83-a741629dc69c.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261012%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261012T171016Z&X-Amz-Expires=86400&X-Amz-Signature=67722c148c3959589266bf8860bf0b33a573e5078e80f9eaa5f261c370bae002&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-12T17:08:54.930Z",
"model": "chirp-haddock",
"state": "succeeded",
"style": "",
"display_style": "",
"metadata": {
"tags": "",
"task": "gen_stem",
"type": "gen",
"infill": false,
"prompt": "",
"stream": true,
"history": [
{
"id": "707a09fc-8789-4087-b915-4493e86d8c59",
"type": "gen",
"infill": false,
"source": "ios",
"continue_at": 149,
"source_is_webview": false
},
{
"id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"type": "gen",
"infill": false,
"source": "ios",
"stem_task": "twelve",
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"source_is_webview": false,
"stem_type_group_name": "Twelve"
}
],
"duration": 133.04,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"stem_task": "twelve",
"image_config": {
"id": "film_strip",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"edited_clip_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"refund_credits": false,
"vox_render_mode": "strict",
"secondary_badges": [
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "stem",
"display_name": "Stem"
},
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "part",
"display_name": "Extend 1"
}
],
"make_instrumental": true,
"uses_latest_model": true,
"stem_type_group_name": "Brass",
"is_loudness_under_threshold": true
},
"duration": 133.04
},
{
"id": "eb979170-5fa9-4bc5-8df3-3a9a00789d9e",
"title": "(Woodwinds)",
"image_url": "https://cdn2.suno.ai/image_eb979170-5fa9-4bc5-8df3-3a9a00789d9e.jpeg",
"lyric": "",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/12/eb979170-5fa9-4bc5-8df3-3a9a00789d9e.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261012%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261012T171015Z&X-Amz-Expires=86400&X-Amz-Signature=4cc529dc4a2c246193d61a1a2b476366f1f164f9a514f658bb4838759821b164&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-12T17:08:54.930Z",
"model": "chirp-haddock",
"state": "succeeded",
"style": "",
"display_style": "",
"metadata": {
"tags": "",
"task": "gen_stem",
"type": "gen",
"infill": false,
"prompt": "",
"stream": true,
"history": [
{
"id": "707a09fc-8789-4087-b915-4493e86d8c59",
"type": "gen",
"infill": false,
"source": "ios",
"continue_at": 149,
"source_is_webview": false
},
{
"id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"type": "gen",
"infill": false,
"source": "ios",
"stem_task": "twelve",
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"source_is_webview": false,
"stem_type_group_name": "Twelve"
}
],
"duration": 133.04,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"stem_task": "twelve",
"image_config": {
"id": "film_strip",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"stem_from_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"stem_type_id": 91,
"edited_clip_id": "539e4b09-3276-48f1-9574-e4cf6abecf79",
"refund_credits": false,
"vox_render_mode": "strict",
"secondary_badges": [
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "stem",
"display_name": "Stem"
},
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "part",
"display_name": "Extend 1"
}
],
"make_instrumental": true,
"uses_latest_model": true,
"stem_type_group_name": "Woodwinds",
"is_loudness_under_threshold": true
},
"duration": 133.04
}
]
}自定义上传歌曲生成功能：对标Extend功能
如果想对自己上传的音乐进行生成的话，我们将上传歌曲与对上传扩展生成合并在一起了，因此需要将参数 action 设置为 upload_generate ，并且输入需要自己上传的音乐链接，接下来我们要必须填歌词、风格自定义生成歌曲，就可以指定如下内容：
- lyric：歌词文本
- custom：填写为
true，代表自定义生成，该参数默认为 false，代表使用prompt生成。 - style：歌曲的风格，选填。
- audio_url：自定义上传的歌曲链接，必填。
- prompt：生成的提示词。
- continue_at：表示从上传的音乐哪个时长开始生成，必须要大于0，必填。经内部测试，官方会限制续写时长，续写时长最大值是原歌曲时长的70%，如果超过原歌曲的70%可能会出现歌曲时长很短的情况。
注意，我们也提供了单独上传自定义歌曲的接口，Upload接口只需要传入
audio_url这个参数即可得到上传后的歌曲ID，但是此时想要续写的话就必须将action设置为upload_extend，同时audio_url不是必传参数，而audio_id变成了必传参数，其他的参数保持不变。
填写样例如下：
json
{
"action": "upload_generate",
"instrumental": false,
"custom": true,
"prompt": "",
"model": "chirp-v6",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"title": "Roots in the Sky",
"style": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"audio_url": "https://cos.yoy-ai.com/1qhugj.mp4",
"persona_id": null,
"continue_at": 149,
"style_negative": null,
"is_pro": true,
"persona_root_id": null,
"full_lyric": null,
"replace_section_start": null,
"replace_section_end": null,
"vocal_gender": null,
"weirdness": null,
"audio_influence": null,
"style_influence": null
}点击发送，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "b5018a27-2c4e-4752-a50e-f6dedecf2ca2",
"trace_id": "c9ff7576-dc42-4bad-93d7-1b4a66270119",
"data": [
{
"id": "125dc1fd-249a-4d10-8c7f-2cc658108393",
"title": "Roots in the Sky",
"image_url": "https://cdn2.suno.ai/image_125dc1fd-249a-4d10-8c7f-2cc658108393.jpeg",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/16/125dc1fd-249a-4d10-8c7f-2cc658108393.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261016%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261016T045516Z&X-Amz-Expires=86400&X-Amz-Signature=8de301a82a34f5207b330c98ee37852a70409eebb7b72f94b6da1b2f1ea5552d&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-16T04:54:54.360Z",
"model": "chirp-hawk",
"state": "succeeded",
"style": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"display_style": "soul, ambient, ballad",
"metadata": {
"key": "C_major",
"tags": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"task": "extend",
"type": "gen",
"infill": false,
"prompt": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"stream": true,
"avg_bpm": 132.21,
"history": [
{
"id": "a919d85a-28c6-422d-b02e-23d19fc6cc10",
"type": "upload",
"infill": false,
"source": "ios",
"source_is_webview": false
}
],
"max_bpm": 142.86,
"min_bpm": 125,
"duration": 73.76,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"has_vocal": true,
"is_mumble": false,
"image_config": {
"id": "black_and_white_photograph",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songrow": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"display_name": "v6"
},
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"edited_clip_id": "a919d85a-28c6-422d-b02e-23d19fc6cc10",
"refund_credits": false,
"vox_render_mode": "strict",
"secondary_badges": [
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "part",
"display_name": "Extend 1"
}
],
"make_instrumental": false,
"uses_latest_model": true,
"can_publish_with_vocal": true
},
"duration": 73.76
},
{
"id": "1552cf0f-e22e-4ad0-a9be-e59dbc3fec5c",
"title": "Roots in the Sky",
"image_url": "https://cdn2.suno.ai/image_1552cf0f-e22e-4ad0-a9be-e59dbc3fec5c.jpeg",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/16/1552cf0f-e22e-4ad0-a9be-e59dbc3fec5c.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261016%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261016T045516Z&X-Amz-Expires=86400&X-Amz-Signature=6ff4717da03e7086e4805a8bb304574f803b8daf33df555c383f131f1a592c81&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-16T04:54:54.360Z",
"model": "chirp-hawk",
"state": "succeeded",
"style": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"display_style": "soul, ambient, ballad",
"metadata": {
"key": "C_major",
"tags": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"task": "extend",
"type": "gen",
"infill": false,
"prompt": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"stream": true,
"avg_bpm": 132.93,
"history": [
{
"id": "a919d85a-28c6-422d-b02e-23d19fc6cc10",
"type": "upload",
"infill": false,
"source": "ios",
"source_is_webview": false
}
],
"max_bpm": 136.36,
"min_bpm": 125,
"duration": 66,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"has_vocal": true,
"is_mumble": false,
"image_config": {
"id": "black_and_white_photograph",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songrow": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"display_name": "v6"
},
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "v6"
}
},
"edited_clip_id": "a919d85a-28c6-422d-b02e-23d19fc6cc10",
"refund_credits": false,
"vox_render_mode": "strict",
"secondary_badges": [
{
"dark": {
"text_color": "A3A3A3",
"border_color": "00000000",
"background_color": "FFFFFF0C"
},
"light": {
"text_color": "7D7C83",
"border_color": "00000000",
"background_color": "1C1C1F0A"
},
"icon_key": "part",
"display_name": "Extend 1"
}
],
"make_instrumental": false,
"uses_latest_model": true,
"can_publish_with_vocal": true
},
"duration": 66
}
]
}可以看出，结果内容与上文的是一致的，这也就实现自定义歌曲的生成功能。
音乐翻唱：对标Cover功能
当基于原有的歌曲继续生成歌曲之后，返回的歌曲的风格可能不太合适。如果要对原先生成的歌曲(若是自定义上传的音乐也支持)进行翻版，需要使用音乐翻版方法（支持跨账号操作），就可以指定如下内容：
- action：内容为
cover。 - audio_id：需要翻唱的歌曲ID。
- is_pro：是否采用专业池，翻唱功能必须使用专业池，这里必须填
true。
比如生成后的歌曲 ID 是：5747e53c-4be5-457a-922e-6cc2a4de876e，那么可以设置参数如下：
json
{
"action": "cover",
"instrumental": false,
"custom": true,
"prompt": "",
"model": "chirp-v6",
"lyric": "同仰天地不問哪\r\n\r\n雙影跌跌無謂啥\r\n\r\n也有念想 蔥蔥山嶺\r\n\r\n或看浪起 或聽風疾\r\n\r\n或望無聲繁星移\r\n\r\n亦有念想 水泥叢中\r\n\r\n或同吹煙 或共妮場\r\n\r\n或坐言頭往事迪\r\n\r\n只\r\n\r\n舊業未彌身已老\r\n\r\n新起造作企未絕\r\n\r\n盼若還幸人間記\r\n\r\n無商心頭續有緣\r\n\r\n-------------\r\n----------\r\n同仰天地不問哪\r\n\r\n雙影跌跌無謂啥\r\n\r\n也有念想 蔥蔥山嶺\r\n\r\n或看浪起 或聽風疾\r\n\r\n或望無聲繁星移\r\n\r\n亦有念想 水泥叢中\r\n\r\n或同吹煙 或共妮場\r\n\r\n或坐言頭往事迪\r\n\r\n只\r\n\r\n舊業未彌身已老\r\n\r\n新起造作企未絕\r\n\r\n盼若還幸人間記\r\n\r\n無商心頭續有緣\r\n\r\n",
"title": "彼岸 (重混)",
"style": "",
"audio_id": "5747e53c-4be5-457a-922e-6cc2a4de876e",
"is_pro": true
}其他参数不变，(如果想在翻唱的基础上使用歌手风格进行翻唱的话需要加俩个参数，分别是：创建歌手风格的源ID persona_root_id，以及创建好Persona的ID persona_id，注意此时只允许使用自定义生成歌曲，本示例是使用真人Voice，因此必须加is_voice!)，返回的就是一首翻版后的歌曲，就是对原先生成的歌曲进行翻版后的结果，样例如下：
json
{
"action": "cover",
"instrumental": false,
"custom": true,
"prompt": "",
"model": "chirp-v6",
"lyric": "同仰天地不問哪\r\n\r\n雙影跌跌無謂啥\r\n\r\n也有念想 蔥蔥山嶺\r\n\r\n或看浪起 或聽風疾\r\n\r\n或望無聲繁星移\r\n\r\n亦有念想 水泥叢中\r\n\r\n或同吹煙 或共妮場\r\n\r\n或坐言頭往事迪\r\n\r\n只\r\n\r\n舊業未彌身已老\r\n\r\n新起造作企未絕\r\n\r\n盼若還幸人間記\r\n\r\n無商心頭續有緣\r\n\r\n-------------\r\n----------\r\n同仰天地不問哪\r\n\r\n雙影跌跌無謂啥\r\n\r\n也有念想 蔥蔥山嶺\r\n\r\n或看浪起 或聽風疾\r\n\r\n或望無聲繁星移\r\n\r\n亦有念想 水泥叢中\r\n\r\n或同吹煙 或共妮場\r\n\r\n或坐言頭往事迪\r\n\r\n只\r\n\r\n舊業未彌身已老\r\n\r\n新起造作企未絕\r\n\r\n盼若還幸人間記\r\n\r\n無商心頭續有緣\r\n\r\n",
"title": "彼岸 (重混)",
"persona_id": "a6ec7291-abe0-43a2-aa4c-365738afd21b",
"persona_root_id": "9c12fd32-1d64-4bda-8515-721e2c9795b9",
"is_voice": true,
"style": "",
"audio_id": "5747e53c-4be5-457a-922e-6cc2a4de876e",
"is_pro": true
}替换片段：对标Replace Section功能
当生成歌曲之后需要进行替换歌曲片段单独操作的二次创作时，可以对歌曲的某个片段进行替换操作。就可以指定如下内容：
- action：内容为
replace_section。 - audio_id：之前生成歌曲的 ID。
- model: 歌曲生成模型，
- prompt：用户需要替换后的歌词（需要将替换的歌词也填入进去，这个歌词的片段时间对应下面的
replace_section_start和replace_section_end）。 - lyric：替换后的上下文歌词。
- style：歌曲的风格，选填。
- replace_section_start：替换片段的起始时间，必须要大于10，可以通过本网站的Timing接口进行获取歌词时间轴信息来确定起始时间，建议通过timing中字段
aligned_word来获取时间轴信息，其中替换片段是时长不小于10s，最长120s。 - replace_section_end：替换片段的终点时间，最大不能超过歌曲总时长，可以通过本网站的Timing接口进行获取歌词时间轴信息来确定终点时间，建议通过timing中字段
aligned_word来获取时间轴信息，其中替换片段是时长不小于10s，最长120s。
比如原先生成后的歌曲 ID 是：222fbe29-6bdb-4344-8f50-d9131304b86b，我们可以先通过Timing接口获取歌词的信息，下面给出一个请求Timing接口的示例代码，只需要输入歌曲ID，具体的如下图所示：
python
import requests
url = "https://api.yoy-ai.com/suno/timing"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"audio_id": "222fbe29-6bdb-4344-8f50-d9131304b86b"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)运行后可以得到歌曲的歌词时间轴信息：
json
{
"success": true,
"task_id": "c3e02d42-24af-45c1-84f8-80d2b7fc115f",
"trace_id": "39f20a96-6ce1-499e-84d2-ba4cbda8324d",
"data": {
"aligned_words": [
{
"word": "一汗一热血\n\n",
"success": true,
"start_s": 26.40957,
"end_s": 32.75266,
"p_align": 0.99
},
{
"word": "一群好汉昂首阔步。\n\n",
"success": true,
"start_s": 32.87234,
"end_s": 50.95745,
"p_align": 0.99
},
{
"word": "一碗包谷烧（",
"success": true,
"start_s": 51.06383,
"end_s": 53.69681,
"p_align": 0.99
},
{
"word": "喝）\n\n",
"success": true,
"start_s": 53.85638,
"end_s": 54.06915,
"p_align": 0.99
},
{
"word": "两片豆腐干\n\n",
"success": true,
"start_s": 54.17553,
"end_s": 55.57181,
"p_align": 0.99
},
{
"word": "胸中热血被点燃\n\n【",
"success": true,
"start_s": 55.69149,
"end_s": 62.95213,
"p_align": 0.99
},
{
"word": "Verse 2】（",
"success": true,
"start_s": 62.95213,
"end_s": 65.98404,
"p_align": 0.99
},
{
"word": "Group ",
"success": true,
"start_s": 66.14362,
"end_s": 69.01596,
"p_align": 0.99
},
{
"word": "Vocals + ",
"success": true,
"start_s": 69.17553,
"end_s": 71.60904,
"p_align": 0.99
},
{
"word": "Suona ",
"success": true,
"start_s": 71.70878,
"end_s": 75,
"p_align": 0.99
},
{
"word": "Lead）\n\n",
"success": true,
"start_s": 75.01995,
"end_s": 75.29255,
"p_align": 0.99
},
{
"word": "战鼓擂起来（",
"success": true,
"start_s": 75.39894,
"end_s": 78.03191,
"p_align": 0.99
},
{
"word": "喝）\n\n",
"success": true,
"start_s": 78.1117,
"end_s": 78.32447,
"p_align": 0.99
},
{
"word": "步子甩起来\n\n",
"success": true,
"start_s": 78.43085,
"end_s": 81.2633,
"p_align": 0.99
},
{
"word": "我要征服那群山\n\n",
"success": true,
"start_s": 81.38298,
"end_s": 84.01596,
"p_align": 0.99
},
{
"word": "踏破这云霄\n\n（",
"success": true,
"start_s": 84.09574,
"end_s": 90.6117,
"p_align": 0.99
},
{
"word": "Chorus）",
"success": true,
"start_s": 90.71809,
"end_s": 93.27128,
"p_align": 0.99
},
{
"word": "就是旰！\n\n",
"success": true,
"start_s": 93.31117,
"end_s": 93.65027,
"p_align": 0.99
},
{
"word": "手握乾坤七星关\n\n",
"success": true,
"start_s": 93.75,
"end_s": 99.61436,
"p_align": 0.99
},
...
{
"word": "脚步未停。\n\n",
"success": true,
"start_s": 214.46809,
"end_s": 215.74468,
"p_align": 0.99
}
],
"waveform_data": [
0.00008,
0.00003,
0.00259,
0.03154,
...
0.00001
],
"hoot_cer": 0.7681660899653979,
"is_streamed": false,
"aligned_lyrics": [
{
"text": "一汗一热血",
"start_s": 26.409574468085108,
"end_s": 30.79787234042553,
"section": "",
"words": [
{
"text": "一",
"start_s": 26.409574468085108,
"end_s": 26.48936170212766
},
{
"text": "汗",
"start_s": 29.601063829787233,
"end_s": 29.680851063829788
},
{
"text": "一",
"start_s": 30,
"end_s": 30.079787234042552
},
{
"text": "热",
"start_s": 30.398936170212767,
"end_s": 30.47872340425532
},
{
"text": "血",
"start_s": 30.71808510638298,
"end_s": 30.79787234042553
}
]
},
...
{
"text": "（Chorus）整起，整起就整起！",
"start_s": 108.51063829787235,
"end_s": 111.62234042553192,
"section": "",
"words": [
{
"text": "（Chorus）",
"start_s": 108.51063829787235,
"end_s": 108.59042553191489
},
{
"text": "整",
"start_s": 108.59042553191489,
"end_s": 108.75
},
{
"text": "起，",
"start_s": 109.06914893617021,
"end_s": 109.14893617021276
},
{
"text": "整",
"start_s": 109.30851063829788,
"end_s": 109.46808510638299
},
{
"text": "起",
"start_s": 109.9468085106383,
"end_s": 110.02659574468085
},
{
"text": "就",
"start_s": 110.58510638297872,
"end_s": 110.66489361702128
},
{
"text": "整",
"start_s": 110.82446808510639,
"end_s": 110.90425531914893
},
{
"text": "起！",
"start_s": 111.54255319148936,
"end_s": 111.62234042553192
}
]
},
{
"text": "乌蒙蓬勃走泥丸 —— 嘿！",
"start_s": 111.62234042553192,
"end_s": 115.2127659574468,
"section": "",
"words": [
{
"text": "乌",
"start_s": 111.62234042553192,
"end_s": 111.94148936170212
},
{
"text": "蒙",
"start_s": 112.02127659574468,
"end_s": 112.10106382978724
},
{
"text": "蓬",
"start_s": 112.34042553191489,
"end_s": 112.42021276595744
},
{
"text": "勃",
"start_s": 112.65957446808511,
"end_s": 112.73936170212767
},
{
"text": "走",
"start_s": 113.05851063829788,
"end_s": 113.13829787234043
},
{
"text": "泥",
"start_s": 113.45744680851064,
"end_s": 113.5372340425532
},
{
"text": "丸",
"start_s": 113.8563829787234,
"end_s": 113.93617021276596
},
{
"text": " —— 嘿！",
"start_s": 114.49468085106383,
"end_s": 115.2127659574468
}
]
},
{
"text": "北镇关上有好汉",
"start_s": 114.49468085106383,
"end_s": 120.39893617021276,
"section": "",
"words": [
{
"text": "北",
"start_s": 114.49468085106383,
"end_s": 115.2127659574468
},
{
"text": "镇",
"start_s": 118.24468085106383,
"end_s": 118.32446808510639
},
{
"text": "关",
"start_s": 118.32446808510639,
"end_s": 118.40425531914893
},
{
"text": "上",
"start_s": 118.80319148936171,
"end_s": 118.88297872340425
},
{
"text": "有",
"start_s": 119.20212765957447,
"end_s": 119.28191489361703
},
{
"text": "好",
"start_s": 119.76063829787235,
"end_s": 119.84042553191489
},
{
"text": "汉",
"start_s": 120.31914893617021,
"end_s": 120.39893617021276
}
]
},
{
"text": "一步一山河",
"start_s": 135.87765957446808,
"end_s": 137.47340425531914,
"section": "",
"words": [
{
"text": "一",
"start_s": 135.87765957446808,
"end_s": 136.11702127659575
},
{
"text": "步",
"start_s": 136.11702127659575,
"end_s": 136.1968085106383
},
{
"text": "一",
"start_s": 136.5159574468085,
"end_s": 136.59574468085106
},
{
"text": "山",
"start_s": 136.99468085106383,
"end_s": 137.0744680851064
},
{
"text": "河",
"start_s": 137.39361702127658,
"end_s": 137.47340425531914
}
]
},
{
"text": "一汗一热血",
"start_s": 138.9095744680851,
"end_s": 140.50531914893617,
"section": "",
"words": [
{
"text": "一",
"start_s": 138.9095744680851,
"end_s": 139.14893617021278
},
{
"text": "汗",
"start_s": 139.22872340425533,
"end_s": 139.30851063829786
},
{
"text": "一",
"start_s": 139.54787234042553,
"end_s": 139.62765957446808
},
{
"text": "热",
"start_s": 140.02659574468086,
"end_s": 140.10638297872342
},
{
"text": "血",
"start_s": 140.4255319148936,
"end_s": 140.50531914893617
}
]
},
{
"text": "脚下征途是兄弟",
"start_s": 141.86170212765958,
"end_s": 144.65425531914894,
"section": "",
"words": [
{
"text": "脚",
"start_s": 141.86170212765958,
"end_s": 142.10106382978722
},
{
"text": "下",
"start_s": 142.26063829787233,
"end_s": 142.3404255319149
},
{
"text": "征",
"start_s": 142.57978723404256,
"end_s": 142.6595744680851
},
{
"text": "途",
"start_s": 143.05851063829786,
"end_s": 143.13829787234042
},
{
"text": "是",
"start_s": 143.45744680851064,
"end_s": 143.5372340425532
},
{
"text": "兄",
"start_s": 144.0159574468085,
"end_s": 144.09574468085106
},
{
"text": "弟",
"start_s": 144.5744680851064,
"end_s": 144.65425531914894
}
]
},
{
"text": "心中江湖是烈火",
"start_s": 148.08510638297872,
"end_s": 150.79787234042553,
"section": "",
"words": [
{
"text": "心",
"start_s": 148.08510638297872,
"end_s": 148.3244680851064
},
{
"text": "中",
"start_s": 148.40425531914894,
"end_s": 148.4840425531915
},
{
"text": "江",
"start_s": 148.8031914893617,
"end_s": 148.88297872340425
},
{
"text": "湖",
"start_s": 149.20212765957447,
"end_s": 149.28191489361703
},
{
"text": "是",
"start_s": 149.60106382978722,
"end_s": 149.68085106382978
},
{
"text": "烈",
"start_s": 150.1595744680851,
"end_s": 150.23936170212767
},
{
"text": "火",
"start_s": 150.71808510638297,
"end_s": 150.79787234042553
}
]
},
{
"text": "【Chorus Repeat】（Full Chorus + Suona",
"start_s": 153.98936170212767,
"end_s": 157.18085106382978,
"section": "",
"words": [
{
"text": "【Chorus",
"start_s": 153.98936170212767,
"end_s": 154.06914893617022
},
{
"text": " Repeat】（",
"start_s": 154.06914893617022,
"end_s": 154.30851063829786
},
{
"text": "Full",
"start_s": 154.30851063829786,
"end_s": 154.70744680851064
},
{
"text": " Ch",
"start_s": 154.70744680851064,
"end_s": 154.9468085106383
},
{
"text": "orus",
"start_s": 155.2659574468085,
"end_s": 155.58510638297872
},
{
"text": " + Su",
"start_s": 155.66489361702128,
"end_s": 156.06382978723406
},
{
"text": "on",
"start_s": 156.38297872340425,
"end_s": 156.54255319148936
},
{
"text": "a",
"start_s": 157.10106382978722,
"end_s": 157.18085106382978
}
]
},
{
"text": "+ Gong）",
"start_s": 160.13297872340425,
"end_s": 160.37234042553192,
"section": "",
"words": [
{
"text": " + Gon",
"start_s": 160.13297872340425,
"end_s": 160.2127659574468
},
{
"text": "g）",
"start_s": 160.2127659574468,
"end_s": 160.37234042553192
}
]
},
{
"text": "碧阳湖水洗风尘 —— 哎！",
"start_s": 160.69148936170214,
"end_s": 166.27659574468086,
"section": "",
"words": [
{
"text": "碧阳",
"start_s": 160.69148936170214,
"end_s": 161.01063829787233
},
{
"text": "湖",
"start_s": 161.01063829787233,
"end_s": 161.0904255319149
},
{
"text": "水",
"start_s": 161.32978723404256,
"end_s": 161.4095744680851
},
{
"text": "洗",
"start_s": 161.72872340425533,
"end_s": 161.80851063829786
},
{
"text": "风",
"start_s": 162.12765957446808,
"end_s": 162.20744680851064
},
{
"text": "尘",
"start_s": 162.4468085106383,
"end_s": 162.52659574468086
},
{
"text": " —",
"start_s": 163.24468085106383,
"end_s": 163.40425531914894
},
{
"text": "— 哎！",
"start_s": 166.1968085106383,
"end_s": 166.27659574468086
}
]
},
{
"text": "灵峰寺里去参蝉",
"start_s": 166.27659574468086,
"end_s": 168.9095744680851,
"section": "",
"words": [
{
"text": "灵",
"start_s": 166.27659574468086,
"end_s": 166.59574468085106
},
{
"text": "峰",
"start_s": 166.75531914893617,
"end_s": 166.83510638297872
},
{
"text": "寺",
"start_s": 167.0744680851064,
"end_s": 167.15425531914894
},
{
"text": "里",
"start_s": 167.3936170212766,
"end_s": 167.47340425531914
},
{
"text": "去",
"start_s": 167.79255319148936,
"end_s": 167.87234042553192
},
{
"text": "参",
"start_s": 168.35106382978722,
"end_s": 168.43085106382978
},
{
"text": "蝉",
"start_s": 168.82978723404256,
"end_s": 168.9095744680851
}
]
},
{
"text": "【Outro】（Drum Fade + Gong）",
"start_s": 172.3404255319149,
"end_s": 196.6755319148936,
"section": "",
"words": [
{
"text": "【",
"start_s": 172.3404255319149,
"end_s": 172.57978723404256
},
{
"text": "O",
"start_s": 172.81914893617022,
"end_s": 172.89893617021278
},
{
"text": "u",
"start_s": 173.05851063829786,
"end_s": 173.13829787234042
},
{
"text": "tro】（",
"start_s": 173.45744680851064,
"end_s": 173.6968085106383
},
{
"text": "D",
"start_s": 174.25531914893617,
"end_s": 174.41489361702128
},
{
"text": "r",
"start_s": 174.5744680851064,
"end_s": 174.65425531914894
},
{
"text": "u",
"start_s": 178.40425531914894,
"end_s": 178.4840425531915
},
{
"text": "m",
"start_s": 178.4840425531915,
"end_s": 178.56382978723406
},
{
"text": " F",
"start_s": 178.8031914893617,
"end_s": 178.9627659574468
},
{
"text": "a",
"start_s": 179.04255319148936,
"end_s": 179.12234042553192
},
{
"text": "de +",
"start_s": 179.5212765957447,
"end_s": 179.76063829787233
},
{
"text": " G",
"start_s": 180,
"end_s": 180.23936170212767
},
{
"text": "o",
"start_s": 180.55851063829786,
"end_s": 180.63829787234042
},
{
"text": "n",
"start_s": 181.11702127659575,
"end_s": 181.1968085106383
},
{
"text": "g）",
"start_s": 196.59574468085106,
"end_s": 196.6755319148936
}
]
},
{
"text": "山还在，路还长，",
"start_s": 196.6755319148936,
"end_s": 202.57978723404256,
"section": "",
"words": [
{
"text": "山",
"start_s": 196.6755319148936,
"end_s": 196.99468085106383
},
{
"text": "还",
"start_s": 198.9095744680851,
"end_s": 198.98936170212767
},
{
"text": "在，",
"start_s": 199.46808510638297,
"end_s": 199.54787234042553
},
{
"text": "路",
"start_s": 201.54255319148936,
"end_s": 201.70212765957447
},
{
"text": "还",
"start_s": 201.94148936170214,
"end_s": 202.0212765957447
},
{
"text": "长，",
"start_s": 202.5,
"end_s": 202.57978723404256
}
]
},
{
"text": "乌蒙好汉，",
"start_s": 208.88297872340425,
"end_s": 211.91489361702128,
"section": "",
"words": [
{
"text": "乌",
"start_s": 208.88297872340425,
"end_s": 209.20212765957447
},
{
"text": "蒙",
"start_s": 210.87765957446808,
"end_s": 210.95744680851064
},
{
"text": "好",
"start_s": 211.43617021276597,
"end_s": 211.5159574468085
},
{
"text": "汉，",
"start_s": 211.83510638297872,
"end_s": 211.91489361702128
}
]
},
{
"text": "脚步未停。",
"start_s": 214.14893617021278,
"end_s": 215.74468085106383,
"section": "",
"words": [
{
"text": "脚",
"start_s": 214.14893617021278,
"end_s": 214.46808510638297
},
{
"text": "步",
"start_s": 214.54787234042553,
"end_s": 214.62765957446808
},
{
"text": "未",
"start_s": 214.86702127659575,
"end_s": 214.9468085106383
},
{
"text": "停。",
"start_s": 215.4255319148936,
"end_s": 215.74468085106383
}
]
}
]
}
}假设我们要替换前的完整歌词片段为：（Chorus）就是旰！ ，然后我们要把上面这句歌词替换掉为（Chorus）就是干！，这个值就是参数prompt，替换后完整的上下文歌词部分为：【Verse 2】（Group Vocals + Suona Lead）\r\n战鼓擂起来（喝）\r\n步子甩起来\r\n我要征服那群山\r\n踏破这云霄\r\n（Chorus）就是干！\r\n手握乾坤七星关\r\n碧阳湖水洗风尘 —— 哎！\r\n灵峰寺里去参蝉\r\n，这个就是对应参数 lyric的值，这个包含prompt的上下文歌词不需要很长，可以不是完整的替换后的歌词，这个内容决定替换片段的歌词内容。其中prompt是lyric的子集，prompt只需要你要修改后的歌词，然后lyric是你替换后的上下文歌词片段。
从上面的歌词时间轴结果aligned_word信息可知，替换片段的起始时间和终点时间分别为：90.39893617021276、 93.35106382978724，时间可以不用很准确，大概差不多就行了，经过大量测试可以采用以下的方式获取时间轴信息替换效果会更好一点，如图所示：
其中还需要填写full_lyric参数，它是整首歌的所有歌词(如果替换的片段有修改歌词则为修改后的歌词)，那么可以设置参数如下：
json
{
"action": "replace_section",
"instrumental": false,
"custom": true,
"prompt": "（Chorus）就是干！",
"model": "chirp-v4-5-plus",
"lyric": "【Verse 2】（Group Vocals + Suona Lead）\r\n战鼓擂起来（喝）\r\n步子甩起来\r\n我要征服那群山\r\n踏破这云霄\r\n（Chorus）就是干！\r\n手握乾坤七星关\r\n碧阳湖水洗风尘 —— 哎！\r\n灵峰寺里去参蝉\r\n",
"title": "《乌蒙好汉》",
"style": "Folk Rock，Ethnic Fusion，Heroic Anthem",
"audio_id": "222fbe29-6bdb-4344-8f50-d9131304b86b",
"persona_id": "",
"continue_at": 0,
"style_negative": null,
"is_pro": true,
"audio_url": "",
"persona_root_id": null,
"full_lyric": "一汗一热血\r\n一群好汉昂首阔步。\r\n一碗包谷烧（喝）\r\n两片豆腐干\r\n胸中热血被点燃\r\n【Verse 2】（Group Vocals + Suona Lead）\r\n战鼓擂起来（喝）\r\n步子甩起来\r\n我要征服那群山\r\n踏破这云霄\r\n（Chorus）就是干！\r\n手握乾坤七星关\r\n碧阳湖水洗风尘 —— 哎！\r\n灵峰寺里去参蝉\r\n（Chorus）整起，整起就整起！\r\n乌蒙蓬勃走泥丸 —— 嘿！\r\n北镇关上有好汉\r\n一步一山河\r\n一汗一热血\r\n脚下征途是兄弟\r\n心中江湖是烈火\r\n【Chorus Repeat】（Full Chorus + Suona\r\n+ Gong）\r\n碧阳湖水洗风尘 —— 哎！\r\n灵峰寺里去参蝉\r\n【Outro】（Drum Fade + Gong）\r\n山还在，路还长，\r\n乌蒙好汉，\r\n脚步未停。",
"replace_section_start": 90.39893617021276,
"replace_section_end": 93.35106382978724,
"vocal_gender": null
}如果还有不理解的话可以看看下面的示例：
我们有一首歌曲，它的原来的歌词是：
json
[Verse]
11111
11111
11111
11111
[Verse 2]
22222
22222
22222
22222
[Chorus]
33333
33333
33333
33333现在我们需要将Verse 2的歌词进行替换的话，假设我们替换后的歌词是：
json
[Verse]
11111
11111
11111
11111
[Verse 2]
55555
55555
55555
55555
[Chorus]
33333
33333
33333
33333上面就是我们要上传的lyric参数值，但是实际上不需要传很多歌词，下面可以对lyric缩减一点为：
json
[Verse]
11111
11111
11111
11111
[Verse 2]
55555
55555
55555
55555现在我们还剩一个prompt参数，这个参数就是我们替换上去的Verse 2歌词部分，具体的为：
json
[Verse 2]
55555
55555
55555
55555总而言之，prompt必须要与lyric有重复部分，lyric不需要上传很多歌词内容，只要包含了prompt的内容即可，还有俩个关键的参数replace_section_start和replace_section_end，这个必须要和lyric的歌词时间轴对上，时间间隔也不能太大，不能超过1分钟，否则官方那边会报错。
其他参数不变，返回的就是俩首替换后的片段歌曲，就是对原先生成的歌曲进行替换片段后的结果，但得到的结果只是一个片段歌曲，如果想得到完整的歌曲还需要执行上文的获取完整歌曲的内容，这样就可以获得完整的替换片段后的歌曲。结果如下：
json
{
"success": true,
"task_id": "6fb1713d-a4d1-476a-9791-66750dbc9695",
"trace_id": "22d6bcb0-b823-45bd-8e50-3b4b1cf22016",
"data": [
{
"id": "ec286375-2b34-445d-a485-60c08d31693b",
"title": "《乌蒙好汉》",
"image_url": "https://cdn2.suno.ai/image_ec286375-2b34-445d-a485-60c08d31693b.jpeg",
"lyric": "【Verse 2】（Group Vocals + Suona Lead）\r\n战鼓擂起来（喝）\r\n步子甩起来\r\n我要征服那群山\r\n踏破这云霄\r\n（Chorus）就是干！\r\n手握乾坤七星关\r\n碧阳湖水洗风尘 —— 哎！\r\n灵峰寺里去参蝉\r",
"audio_url": "https://cdn1.suno.ai/ec286375-2b34-445d-a485-60c08d31693b.mp3",
"video_url": "",
"created_at": "2025-09-30T03:50:41.678Z",
"model": "chirp-bluejay",
"state": "succeeded",
"style": "Folk Rock，Ethnic Fusion，Heroic Anthem",
"duration": 6.96
},
{
"id": "00dc0e5e-9657-4718-971c-95c9ec505e92",
"title": "《乌蒙好汉》",
"image_url": "https://cdn2.suno.ai/image_00dc0e5e-9657-4718-971c-95c9ec505e92.jpeg",
"lyric": "【Verse 2】（Group Vocals + Suona Lead）\r\n战鼓擂起来（喝）\r\n步子甩起来\r\n我要征服那群山\r\n踏破这云霄\r\n（Chorus）就是干！\r\n手握乾坤七星关\r\n碧阳湖水洗风尘 —— 哎！\r\n灵峰寺里去参蝉\r",
"audio_url": "https://cdn1.suno.ai/00dc0e5e-9657-4718-971c-95c9ec505e92.mp3",
"video_url": "",
"created_at": "2025-09-30T03:50:41.678Z",
"model": "chirp-bluejay",
"state": "succeeded",
"style": "Folk Rock，Ethnic Fusion，Heroic Anthem",
"duration": 6.96
}
]
}2026-8-3更新：简易版替换片段
具体的请求如下：
json
{
"action": "simple_replace_section",
"instrumental": false,
"custom": true,
"prompt": "把愿望写大一点\n把脚步走快一点\n甜的都留在昨天\n苦的都留给今天",
"model": "chirp-v5-5",
"title": "simple replace section",
"audio_id": "a73548d0-ed19-42b6-be0b-3479a740e771",
"is_pro": true,
"full_lyric": "[Verse 1]\n窗外的雪还没停\n桌上热气正翻滚\n你把旧年轻轻折好\n塞进回忆的抽屉里\n红灯笼晃了晃\n把屋檐照得发亮\n这一刻我们都知道\n新的一页要开场\n[Pre-Chorus]\n把愿望写短一点\n把脚步走稳一点\n苦的都留在昨天\n甜的都留给今天\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过\n[Verse 2]\n饺子在锅里打转\n孩子追着纸灯玩\n你说那些没说完的话\n留到春风里再谈\n门口的福字很红\n照亮每张脸庞\n这一夜不问来路\n只管把祝福唱响\n[Pre-Chorus]\n把愿望写大一点\n把脚步走快一点\n甜的都留在昨天\n苦的都留给今天\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过\n[Bridge]\n如果你曾有泪水\n就让它变成星光\n如果你曾经疲惫\n就靠近这盏灯光\n从这一秒开始\n重新学会盼望\n把所有沉默的梦\n都交给新年发亮\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过",
"replace_section_start": 89.601,
"replace_section_end": 100.532
}注意以原来的不同，不需要传上下文歌词的字段lyric，同时替换的效果会更好，然后得到以下结果：
json
{
"success": true,
"task_id": "2fca20b1-fe56-41b2-88e1-889fcc029fe6",
"trace_id": "0d50c591-7796-46ac-abbc-d105e7d30989",
"data": [
{
"id": "f3816451-76ea-4719-8a18-c86e69a1ca73",
"title": "simple replace section",
"image_url": "https://cdn2.suno.ai/image_f3816451-76ea-4719-8a18-c86e69a1ca73.jpeg",
"lyric": "[Verse 1]\n窗外的雪还没停\n桌上热气正翻滚\n你把旧年轻轻折好\n塞进回忆的抽屉里\n红灯笼晃了晃\n把屋檐照得发亮\n这一刻我们都知道\n新的一页要开场\n[Pre-Chorus]\n把愿望写短一点\n把脚步走稳一点\n苦的都留在昨天\n甜的都留给今天\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过\n[Verse 2]\n饺子在锅里打转\n孩子追着纸灯玩\n你说那些没说完的话\n留到春风里再谈\n门口的福字很红\n照亮每张脸庞\n这一夜不问来路\n只管把祝福唱响\n[Pre-Chorus]\n把愿望写大一点\n把脚步走快一点\n甜的都留在昨天\n苦的都留给今天\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过\n[Bridge]\n如果你曾有泪水\n就让它变成星光\n如果你曾经疲惫\n就靠近这盏灯光\n从这一秒开始\n重新学会盼望\n把所有沉默的梦\n都交给新年发亮\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过",
"audio_url": "https://cdn1.suno.ai/f3816451-76ea-4719-8a18-c86e69a1ca73.mp3",
"video_url": "",
"created_at": "2026-08-03T02:45:58.129Z",
"model": "chirp-fenix",
"state": "succeeded",
"style": "",
"display_style": "",
"metadata": {
"tags": "",
"prompt": "[Verse 1]\n窗外的雪还没停\n桌上热气正翻滚\n你把旧年轻轻折好\n塞进回忆的抽屉里\n红灯笼晃了晃\n把屋檐照得发亮\n这一刻我们都知道\n新的一页要开场\n[Pre-Chorus]\n把愿望写短一点\n把脚步走稳一点\n苦的都留在昨天\n甜的都留给今天\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过\n[Verse 2]\n饺子在锅里打转\n孩子追着纸灯玩\n你说那些没说完的话\n留到春风里再谈\n门口的福字很红\n照亮每张脸庞\n这一夜不问来路\n只管把祝福唱响\n[Pre-Chorus]\n把愿望写大一点\n把脚步走快一点\n甜的都留在昨天\n苦的都留给今天\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过\n[Bridge]\n如果你曾有泪水\n就让它变成星光\n如果你曾经疲惫\n就靠近这盏灯光\n从这一秒开始\n重新学会盼望\n把所有沉默的梦\n都交给新年发亮\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过",
"history": [
{
"id": "a73548d0-ed19-42b6-be0b-3479a740e771",
"type": "gen",
"source": "ios",
"infill_start_s": 89.6,
"infill_end_s": 100.56,
"infill_dur_s": 10.96,
"infill_req_duration_s": 10.96,
"infill_context_start_s": 74.6,
"infill_context_end_s": 115.56,
"include_future_s": 15,
"include_history_s": 15,
"infill": true,
"infill_lyrics": "把愿望写大一点\n把脚步走快一点\n甜的都留在昨天\n苦的都留给今天",
"lyrics_updated": true
}
],
"edited_clip_id": "a73548d0-ed19-42b6-be0b-3479a740e771",
"lyrics_updated": true,
"type": "gen",
"duration": 195.52,
"refund_credits": false,
"stream": true,
"infill": true,
"make_instrumental": false,
"task": "infill",
"edit_session_id": "bf09d6f8-07d5-4f0a-b1f7-e0212ee7f6c2",
"infill_lyrics": "把愿望写大一点\n把脚步走快一点\n甜的都留在昨天\n苦的都留给今天",
"can_remix": true,
"is_remix": true,
"priority": 10,
"has_stem": false,
"uses_latest_model": true,
"model_badges": {
"songcard": {
"display_name": "v5.5",
"light": {
"text_color": "FD429C",
"background_color": "0000004D",
"border_color": "00000000"
},
"dark": {
"text_color": "FD429C",
"background_color": "0000004D",
"border_color": "00000000"
}
},
"songrow": {
"display_name": "v5.5",
"light": {
"text_color": "FD429C",
"background_color": "FD429C1A",
"border_color": "00000000"
},
"dark": {
"text_color": "FD429C",
"background_color": "FD429C40",
"border_color": "00000000"
}
}
},
"secondary_badges": [
{
"display_name": "Section",
"icon_key": "section",
"light": {
"text_color": "7D7C83",
"background_color": "1C1C1F0A",
"border_color": "00000000"
},
"dark": {
"text_color": "A3A3A3",
"background_color": "FFFFFF0C",
"border_color": "00000000"
}
}
],
"image_config": {
"use_image_config_template": true,
"id": "cyanotype",
"default_cover_style": "brand_refresh"
},
"is_mumble": false
},
"duration": 195.52
},
{
"id": "ee787296-0def-41ad-b568-881d2b36d8bd",
"title": "simple replace section",
"image_url": "https://cdn2.suno.ai/image_ee787296-0def-41ad-b568-881d2b36d8bd.jpeg",
"lyric": "[Verse 1]\n窗外的雪还没停\n桌上热气正翻滚\n你把旧年轻轻折好\n塞进回忆的抽屉里\n红灯笼晃了晃\n把屋檐照得发亮\n这一刻我们都知道\n新的一页要开场\n[Pre-Chorus]\n把愿望写短一点\n把脚步走稳一点\n苦的都留在昨天\n甜的都留给今天\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过\n[Verse 2]\n饺子在锅里打转\n孩子追着纸灯玩\n你说那些没说完的话\n留到春风里再谈\n门口的福字很红\n照亮每张脸庞\n这一夜不问来路\n只管把祝福唱响\n[Pre-Chorus]\n把愿望写大一点\n把脚步走快一点\n甜的都留在昨天\n苦的都留给今天\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过\n[Bridge]\n如果你曾有泪水\n就让它变成星光\n如果你曾经疲惫\n就靠近这盏灯光\n从这一秒开始\n重新学会盼望\n把所有沉默的梦\n都交给新年发亮\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过",
"audio_url": "https://cdn1.suno.ai/ee787296-0def-41ad-b568-881d2b36d8bd.mp3",
"video_url": "",
"created_at": "2026-08-03T02:45:58.129Z",
"model": "chirp-fenix",
"state": "succeeded",
"style": "",
"display_style": "",
"metadata": {
"tags": "",
"prompt": "[Verse 1]\n窗外的雪还没停\n桌上热气正翻滚\n你把旧年轻轻折好\n塞进回忆的抽屉里\n红灯笼晃了晃\n把屋檐照得发亮\n这一刻我们都知道\n新的一页要开场\n[Pre-Chorus]\n把愿望写短一点\n把脚步走稳一点\n苦的都留在昨天\n甜的都留给今天\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过\n[Verse 2]\n饺子在锅里打转\n孩子追着纸灯玩\n你说那些没说完的话\n留到春风里再谈\n门口的福字很红\n照亮每张脸庞\n这一夜不问来路\n只管把祝福唱响\n[Pre-Chorus]\n把愿望写大一点\n把脚步走快一点\n甜的都留在昨天\n苦的都留给今天\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过\n[Bridge]\n如果你曾有泪水\n就让它变成星光\n如果你曾经疲惫\n就靠近这盏灯光\n从这一秒开始\n重新学会盼望\n把所有沉默的梦\n都交给新年发亮\n[Chorus]\n新年快乐，新年快乐\n把笑容放进烟火\n新年快乐，新年快乐\n我们一起向前走\n新年快乐，新年快乐\n把心事慢慢松手\n新年快乐，新年快乐\n明天会更好过",
"history": [
{
"id": "a73548d0-ed19-42b6-be0b-3479a740e771",
"type": "gen",
"source": "ios",
"infill_start_s": 89.6,
"infill_end_s": 100.56,
"infill_dur_s": 10.96,
"infill_req_duration_s": 10.96,
"infill_context_start_s": 74.6,
"infill_context_end_s": 115.56,
"include_future_s": 15,
"include_history_s": 15,
"infill": true,
"infill_lyrics": "把愿望写大一点\n把脚步走快一点\n甜的都留在昨天\n苦的都留给今天",
"lyrics_updated": true
}
],
"edited_clip_id": "a73548d0-ed19-42b6-be0b-3479a740e771",
"lyrics_updated": true,
"type": "gen",
"duration": 102.52,
"refund_credits": false,
"stream": true,
"infill": true,
"make_instrumental": false,
"task": "infill",
"edit_session_id": "bf09d6f8-07d5-4f0a-b1f7-e0212ee7f6c2",
"infill_lyrics": "把愿望写大一点\n把脚步走快一点\n甜的都留在昨天\n苦的都留给今天",
"can_remix": true,
"is_remix": true,
"priority": 10,
"has_stem": false,
"max_bpm": 150,
"min_bpm": 120,
"avg_bpm": 132.09,
"uses_latest_model": true,
"model_badges": {
"songcard": {
"display_name": "v5.5",
"light": {
"text_color": "FD429C",
"background_color": "0000004D",
"border_color": "00000000"
},
"dark": {
"text_color": "FD429C",
"background_color": "0000004D",
"border_color": "00000000"
}
},
"songrow": {
"display_name": "v5.5",
"light": {
"text_color": "FD429C",
"background_color": "FD429C1A",
"border_color": "00000000"
},
"dark": {
"text_color": "FD429C",
"background_color": "FD429C40",
"border_color": "00000000"
}
}
},
"secondary_badges": [
{
"display_name": "Section",
"icon_key": "section",
"light": {
"text_color": "7D7C83",
"background_color": "1C1C1F0A",
"border_color": "00000000"
},
"dark": {
"text_color": "A3A3A3",
"background_color": "FFFFFF0C",
"border_color": "00000000"
}
}
],
"image_config": {
"use_image_config_template": true,
"id": "cyanotype",
"default_cover_style": "brand_refresh"
},
"is_mumble": false
},
"duration": 102.52
}
]
}生成的结果与上文类似，这就完成了对原先生成的歌曲进行替换片段的过程，现在的结果只是片段的歌曲，如果需要完整的歌曲还需要执行上文的拼接（concat）功能。
自定义歌手风格生成功能：对标Voice二次创作功能
如果想使用歌手风格来生成歌曲的话，首先通过上文的基本使用生成一首歌曲，这里生成的歌曲必须是专业池里面生成的，然后将该歌曲的ID在Persona接口进行上传得到persona_id,下面讲解如何获取persona_id,根据专业池生成的音乐ID audio_id 来生成一个歌手风格的id参数 persona_id(创建好的Persona可以跨账号使用，但是创建Persona不能跨账号，如果歌曲对应账号下线后就无法创建Persona了，所以需要及时创建Persona。)，具体的参数如下图所示：
json
{
"name": "新年快乐",
"description": "新年快乐",
"audio_id": "04734644-d4c8-4d1e-ac53-be95289c5b6b"
}对应的 Python 代码：
python
import requests
url = "https://api.yoy-ai.com/suno/persona"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"name": "新年快乐",
"description": "新年快乐",
"audio_id": "04734644-d4c8-4d1e-ac53-be95289c5b6b"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)点击运行，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "7a603203-918a-4ce7-8d7c-5e772a62861b",
"data": {
"persona_id": "89f20346-51f0-4b35-a88e-ed8fa5bb5cac",
"name": "新年快乐",
"description": "新年快乐"
}
}我们以上面的 audio_id 和 persona_id 分别为 04734644-d4c8-4d1e-ac53-be95289c5b6b、89f20346-51f0-4b35-a88e-ed8fa5bb5cac 为此次的示例数据。使用自定义歌手风格生成必须在专业池里面进行，专业池使用只需要加一个is_pro参数即可，否则会失效， 然后可以将参数 action 设置为 artist_consistency ，并且输入需要继续生成歌曲的 ID 、 歌手风格ID，填写样例如下：
json
{
"action": "artist_consistency",
"prompt": "A song for Christmas",
"model": "chirp-v4-5",
"custom": false,
"instrumental": false,
"is_pro": true,
"audio_id": "04734644-d4c8-4d1e-ac53-be95289c5b6b",
"persona_id": "89f20346-51f0-4b35-a88e-ed8fa5bb5cac"
}对应的 Python 代码：
python
import requests
url = "https://api.yoy-ai.com/suno/audios"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"action": "artist_consistency",
"prompt": "A song for Christmas",
"model": "chirp-v4-5",
"custom": false,
"instrumental": false,
"is_pro": true,
"audio_id": "04734644-d4c8-4d1e-ac53-be95289c5b6b",
"persona_id": "89f20346-51f0-4b35-a88e-ed8fa5bb5cac"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)点击运行，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "b5862984-47c2-4fd9-acb1-583ccb7b2634",
"trace_id": "7ba1154f-fccf-4f0c-a585-fd3abf5629e6",
"data": [
{
"id": "ca029c03-299a-4c4a-a0ee-64350ffbaf30",
"title": "",
"image_url": "https://cdn2.suno.ai/image_ca029c03-299a-4c4a-a0ee-64350ffbaf30.jpeg",
"lyric": "",
"audio_url": "https://cdn1.suno.ai/ca029c03-299a-4c4a-a0ee-64350ffbaf30.mp3",
"video_url": "",
"created_at": "2025-05-10T07:45:27.655Z",
"model": "chirp-auk",
"state": "succeeded",
"style": "",
"duration": 311.84
},
{
"id": "520d4b26-045f-4eab-a22e-2113200c8109",
"title": "",
"image_url": "https://cdn2.suno.ai/image_520d4b26-045f-4eab-a22e-2113200c8109.jpeg",
"lyric": "",
"audio_url": "https://cdn1.suno.ai/520d4b26-045f-4eab-a22e-2113200c8109.mp3",
"video_url": "",
"created_at": "2025-05-10T07:45:27.655Z",
"model": "chirp-auk",
"state": "succeeded",
"style": "",
"duration": 164.8
}
]
}完美的声音，不再被曲风“绑架”(新版本VoxPersona，官方更新新版Persona功能-2025-12-24更新)
大家肯定都遇到过这种尴尬：你捕捉到了一个烟嗓大叔的灵魂歌声，想让他去蹦个迪（唱 EDM），结果生成的曲子里莫名其妙总带着股乡村民谣的滑音。
原因很简单： 以前的 AI 歌手，声音和风格是锁死的。
这次 Suno 带来的 Vocal Personas（人声角色） 升级，干了一件特别解气的事：声部彻底解构。它利用最新的分离技术，强行把“嗓音”和“乐风”拆散了。这就好比你把林俊杰从录音棚里请出来，让他脱掉西装换上皮衣，直接去重金属现场蹦迪。他的音色还是那个音色，但背后再也没有那种“挥之不去的民谣律动”。这种“声音迁移”的自由度，才是创作者真正想要的掌控感。
首先我们需要调用Suno Vox接口接口获取到 vox_audio_id ，下面是具体的示例：
json
{
"audio_id": "d9c20912-eadf-4f02-986d-ee07347f93f8"
}调用后我们得到以下结果：
json
{
"success": true,
"task_id": "63cace08-cc56-4dc4-92f0-2769fdb3343f",
"trace_id": "01292496-4c4b-4586-b8d3-506bbc6ebd99",
"data": {
"id": "31c92480-ae3c-448d-a2df-b71e16fde075",
"root_clip_id": "d9c20912-eadf-4f02-986d-ee07347f93f8",
"vocal_audio_url": "https://cdn1.suno.ai/processed_31c92480-ae3c-448d-a2df-b71e16fde075_vocals.m4a",
"state": "succeeded",
"vocal_start": 45,
"vocal_end": 74
}
}由上可知，我们得到的id就是：31c92480-ae3c-448d-a2df-b71e16fde075，同时root_clip_id是你输入的歌曲ID，vocal_audio_url是人声分离后的音频结果，vocal_start、vocal_end是人声对应的时间轴信息，然后我们需要使用原来Persona接口来创建新版本的Persona，与旧Persona不同的时候，我们需要传入persona_type、audio_id、vox_audio_id、vocal_start、vocal_end参数，其中vox_audio_id、vocal_start、vocal_end是上面data中id、vocal_start、vocal_end对应的，同时audio_id就是Vox接口传入的audio_id值，以下是具体的示例：
json
{
"name": "新年快乐",
"description": "新年快乐",
"audio_id": "d9c20912-eadf-4f02-986d-ee07347f93f8",
"vox_audio_id": "31c92480-ae3c-448d-a2df-b71e16fde075",
"persona_type": "vox",
"vocal_start": 45,
"vocal_end": 74
}可以得到以下输出：
json
{
"success": true,
"task_id": "40025a3f-4d0c-4230-9721-a33d65c2156a",
"data": {
"persona_id": "7eaf1030-191a-4ed9-9314-f9a642d56e31",
"name": "新年快乐",
"description": "新年快乐",
"image_url": "https://cdn2.suno.ai/image_d9c20912-eadf-4f02-986d-ee07347f93f8.jpeg",
"audio_id": "d9c20912-eadf-4f02-986d-ee07347f93f8"
}
}最后在Suno 歌曲生成接口中，我们需要使用上面的persona_id、audio_id结果来生成新版Persona的歌手风格歌曲，与旧版本Persona的歌手风格中新增了persona_type参数，以下是具体的示例：
json
{
"action": "artist_consistency",
"prompt": "A song for Christmas",
"model": "chirp-v5",
"persona_type": "vox",
"audio_id": "d9c20912-eadf-4f02-986d-ee07347f93f8",
"persona_id": "7eaf1030-191a-4ed9-9314-f9a642d56e31",
"lyric": "[Verse]\n新年的钟声轻轻敲响\n雪花飘落铺满了街巷\n灯笼红红照亮了心房\n愿望在心中，暖意在身旁\n\n[Chorus]\n新年快乐，新年快乐\n欢声笑语洒满银河\n新年快乐，新年快乐\n一起向明天继续探索",
"custom": true,
"instrumental": false
}可以得到以下结果：
json
{
"success": true,
"task_id": "d7ba131b-a22f-474b-90a3-dbfe2624a003",
"trace_id": "108d598a-b552-4d57-986b-e20194aacb45",
"data": [
{
"id": "a2ad475c-b73a-48dd-8152-c8e38c14c27e",
"title": "",
"image_url": "https://cdn2.suno.ai/image_a2ad475c-b73a-48dd-8152-c8e38c14c27e.jpeg",
"lyric": "[Verse]\n新年的钟声轻轻敲响\n雪花飘落铺满了街巷\n灯笼红红照亮了心房\n愿望在心中，暖意在身旁\n[Chorus]\n新年快乐，新年快乐\n欢声笑语洒满银河\n新年快乐，新年快乐\n一起向明天继续探索",
"audio_url": "https://cdn1.suno.ai/a2ad475c-b73a-48dd-8152-c8e38c14c27e.mp3",
"video_url": "",
"created_at": "2025-12-24T02:44:39.459Z",
"model": "chirp-crow",
"state": "succeeded",
"style": "",
"duration": 24.32
},
{
"id": "a4e8f8a8-f1a5-4652-b061-b0f509643fd9",
"title": "",
"image_url": "https://cdn2.suno.ai/image_a4e8f8a8-f1a5-4652-b061-b0f509643fd9.jpeg",
"lyric": "[Verse]\n新年的钟声轻轻敲响\n雪花飘落铺满了街巷\n灯笼红红照亮了心房\n愿望在心中，暖意在身旁\n[Chorus]\n新年快乐，新年快乐\n欢声笑语洒满银河\n新年快乐，新年快乐\n一起向明天继续探索",
"audio_url": "https://cdn1.suno.ai/a4e8f8a8-f1a5-4652-b061-b0f509643fd9.mp3",
"video_url": "",
"created_at": "2025-12-24T02:44:39.459Z",
"model": "chirp-crow",
"state": "succeeded",
"style": "",
"duration": 59.28
}
]
}可以看出，结果内容与上文的是一致的，这也就实现使用歌手风格来生成歌曲的功能。
新版本真人Voice，官方更新新版Persona功能-2026-3-26更新
在2026-3-26官方重磅更新了Persona，目前官方已经没有这个Persona功能，但是API的Persona还是不变，只是名称变成了真人Voice了，它通过两步操作创建基于真人声音的 Persona：先上传原声提取人声特征并获取验证短语，再上传朗读验证音频完成身份验证并创建 Persona。
首先我们需要调用初始化Voice 接口接口获取到 vox_audio_id、voice_recording_id、phrase_id、phrase_text 上传的真人声音要大于10s，否则无法初始化，下面是具体的示例：
json
{
"voice_audio_url": "https://cos.yoy-ai.com/xxx.m4a",
"language": "zh",
"vocal_start": 0,
"vocal_end": 12
}其中language支持10种语言，缩写名称对应关系如下：
- English - en
- Español - es
- Français - fr
- Português - pt
- Deutsch - de
- 日本語 - ja
- 한국어 - ko
- 中文 - zh
- हिन्दी - hi
- Русский - ru
调用后我们得到以下结果：
json
{
"success": true,
"task_id": "907d42e9-5c12-49b0-ac91-4aef26daaf0f",
"trace_id": "c1c3367e-36c6-4268-9619-a2ae9fbf8fae",
"data": {
"vox_audio_id": "aca20afa-0e70-4428-b54d-d138f70fb238",
"voice_recording_id": "35caebb6-e1cf-49ea-82a8-9677fa334b96",
"phrase_id": "c46c587a-1f23-48a6-a7ee-e5bff3301849",
"phrase_text": "唱歌让心情变得更加快乐轻松",
"vocal_audio_url": "https://cdn1.suno.ai/xxx_vocals.m4a",
"vocal_start": 0,
"vocal_end": 12
}
}结果字段说明：
| 字段 | 说明 |
|---|---|
vox_audio_id | 提取的人声 ID，第二步验证Voice需要 |
voice_recording_id | 原声录音 ID，第二步验证Voice需要 |
phrase_id | 验证短语 ID，第二步验证Voice需要 |
phrase_text | 验证短语文本，用户需朗读此文字并录制为音频 |
vocal_audio_url | 提取后的人声音频 URL |
vocal_start / vocal_end | 人声时间范围 |
由上可知，我们得到需要的验证短语就是：音乐声中微笑的清晨阳光，同时vox_audio_id是你上传音频ID，vocal_audio_url是人声音频的链接，vocal_start、vocal_end是人声对应的时间轴信息，然后我们需要使用验证Voice 接口来验证Voice的有效性，用户需要朗读上一步返回的 phrase_text 并录制为音频后，上传验证音频完成声音验证并创建 Persona，验证阶段一定要在30s内完成，否则会出现超时错误，以下是具体的示例：
json
{
"vox_audio_id": "aca20afa-0e70-4428-b54d-d138f70fb238",
"voice_recording_id": "35caebb6-e1cf-49ea-82a8-9677fa334b96",
"phrase_id": "c46c587a-1f23-48a6-a7ee-e5bff3301849",
"vocal_start": 0,
"vocal_end": 12,
"verification_audio_url": "https://cos.yoy-ai.com/xxx.m4a",
"name": "llz"
}可以得到以下输出：
json
{
"success": true,
"task_id": "52cccff6-8563-474d-ab55-ff696cb51d1d",
"trace_id": "b52e41ca-3823-4016-835f-44be72e0f353",
"data": {
"persona_id": "b224d9c9-d23d-4425-803b-9af41f94d3e1",
"name": "llz",
"description": "",
"audio_id": "aca20afa-0e70-4428-b54d-d138f70fb238"
}
}当得到以上结果就表示已经成功创建真人Voice，后面我们就可以在Suno 歌曲生成接口进行二次创作，我们需要使用上面的persona_id、audio_id结果来生成新版Voice的歌手风格歌曲，与旧版本Persona的歌手风格中新增了persona_type参数，记住不需要传audio_id，只需要传persona_id，目前官网只支持chirp-v5-5，其他模型效果官方还不支持（效果不好），以下是具体的示例：
json
{
"action": "artist_consistency",
"prompt": "A song for Christmas",
"model": "chirp-v5-5",
"persona_id": "b224d9c9-d23d-4425-803b-9af41f94d3e1",
"persona_type": "vox",
"lyric": "[Verse]\n新年的钟声轻轻敲响\n雪花飘落铺满了街巷\n灯笼红红照亮了心房\n愿望在心中，暖意在身旁\n\n[Chorus]\n新年快乐，新年快乐\n欢声笑语洒满银河\n新年快乐，新年快乐\n一起向明天继续探索",
"custom": true,
"instrumental": false
}可以得到以下结果：
json
{
"success": true,
"task_id": "2be8bacb-549c-4aee-b333-c536774b3121",
"trace_id": "0d86e8da-14d6-438e-b670-c9ea2baf6eea",
"data": [
{
"id": "cc784daf-8f70-4a3d-xxx-10fbd1c37ce2",
"title": "",
"image_url": "https://cdn2.suno.ai/image_cc784daf-8f70-4a3d-xxx-10fbd1c37ce2.jpeg",
"lyric": "[Verse]\n新年的钟声轻轻敲响\n雪花飘落铺满了街巷\n灯笼红红照亮了心房\n愿望在心中，暖意在身旁\n[Chorus]\n新年快乐，新年快乐\n欢声笑语洒满银河\n新年快乐，新年快乐\n一起向明天继续探索",
"audio_url": "https://cdn1.suno.ai/cc784daf-8f70-4a3d-xxx-10fbd1c37ce2.mp3",
"video_url": "",
"created_at": "2026-03-31T07:53:08.151Z",
"model": "chirp-fenix",
"state": "succeeded",
"style": "",
"display_style": "",
"duration": 49.76
},
{
"id": "505dcc34-a1d3-434b-xxx-f4b2b686ac7a",
"title": "",
"image_url": "https://cdn2.suno.ai/image_505dcc34-a1d3-434b-xxx-f4b2b686ac7a.jpeg",
"lyric": "[Verse]\n新年的钟声轻轻敲响\n雪花飘落铺满了街巷\n灯笼红红照亮了心房\n愿望在心中，暖意在身旁\n[Chorus]\n新年快乐，新年快乐\n欢声笑语洒满银河\n新年快乐，新年快乐\n一起向明天继续探索",
"audio_url": "https://cdn1.suno.ai/505dcc34-a1d3-434b-xxx-f4b2b686ac7a.mp3",
"video_url": "",
"created_at": "2026-03-31T07:53:08.151Z",
"model": "chirp-fenix",
"state": "succeeded",
"style": "",
"display_style": "",
"duration": 29.68
}
]
}可以看出，结果内容与上文的是一致的，这也就实现使用歌手风格来生成歌曲的功能。
2026-07-10重要更新，Persona/Voice可支持与其他操作一起执行，比如Extend、Cover、Replace Section、Inspiration四种操作
如果想在以上四种操作的基础上使用歌手风格进行创作的话需要加俩个参数，分别是：创建歌手风格的源ID persona_root_id，以及创建好Persona的ID persona_id，Persona类型persona_type，以下是具体的示例：
请求参数字段说明：
| 字段 | 说明 |
|---|---|
persona_root_id | 创建Persona时填的audio_id参数值，一定和下面persona_id参数对应的，必填 |
persona_id | 创建Persona后得到的唯一ID，必填 |
persona_type | 如果想使用VoxPersona或者真人Voice，就必须传'vox'，不传表示使用最原始的Persona' |
is_voice | 如果想使用真人Voice，就必须传'is_voice'为true，不传表示使用VoxPersona' |
| 以下是一个创建Persona/Voice的结果： |
json
{
"success": true,
"task_id": "a8c19fe6-2cba-41ca-8d63-54b2570e3ceb",
"data": {
"voice_id": "32b1636a-1828-4b8c-98dc-f50f0e5fd7c2",
"name": "VoxPersona",
"description": "",
"image_url": "https://cdn2.suno.ai/image_03f1102c-a2f0-4282-9c79-7dd9130c7a83.jpeg",
"audio_id": "03f1102c-a2f0-4282-9c79-7dd9130c7a83"
}
}下面是Cover+Persona操作的请求参数：
json
{
"action": "cover",
"custom": false,
"prompt": "新年快乐",
"style": "rock, punk",
"model": "chirp-v5",
"is_pro": true,
"audio_id": "b7dcbcd6-d347-4c10-b63a-c24b6a0988d7",
"persona_type": "vox",
"persona_root_id": "03f1102c-a2f0-4282-9c79-7dd9130c7a83",
"persona_id": "32b1636a-1828-4b8c-98dc-f50f0e5fd7c2"
}运行后得到的结果如下：
json
{
"success": true,
"task_id": "64ff519a-56b9-4eb7-9220-a08649378b6c",
"trace_id": "37e211ad-c274-431b-9b2b-27b0bb9a7e6a",
"data": [
{
"id": "9956f545-131d-4166-885e-bf4332398b25",
"title": "新年快乐",
"image_url": "https://cdn2.suno.ai/image_9956f545-131d-4166-885e-bf4332398b25.jpeg",
"lyric": "[Verse 1]\n旧日历翻过去\n窗外风也换了气\n红灯笼挂上门\n笑声先一步回家里\n桌上热茶冒着烟\n心事先放到一边\n这一年辛苦过\n今晚都说声谢谢\n[Pre-Chorus]\n把烦恼轻轻关上\n把期待慢慢点亮\n心里那片空白\n等一句话来填满\n[Chorus]\n新年快乐\n新年快乐\n把好运都抱紧\n把泪水都放晴\n新年快乐\n新年快乐\n这一夜别走散\n一起慢慢开心\n[Verse 2]\n饺子在锅里转\n像把圆满煮得很满\n孩子追着笑声跑\n大人也跟着放慢\n旧伤口会结痂\n新故事会发芽\n你在我身旁坐下\n就已经很好啦\n[Pre-Chorus]\n把烦恼轻轻关上\n把期待慢慢点亮\n心里那片空白\n等一句话来填满\n[Chorus]\n新年快乐\n新年快乐\n把好运都抱紧\n把泪水都放晴\n新年快乐\n新年快乐\n这一夜别走散\n一起慢慢开心\n[Bridge]\n愿你走的路\n每一步都踏实\n愿你想的人\n都能在身边守着\n愿你抬起头\n就看见春天来过\n愿我们明天\n比今天更值得\n[Final Chorus]\n新年快乐\n新年快乐\n把好运都抱紧\n把泪水都放晴\n新年快乐\n新年快乐\n这一夜别走散\n一起慢慢开心\n新年快乐\n新年快乐\n把明天都打开\n把幸福留在家里",
"audio_url": "https://cdn1.suno.ai/9956f545-131d-4166-885e-bf4332398b25.mp3",
"video_url": "",
"created_at": "2026-07-10T04:16:31.840Z",
"model": "chirp-crow",
"state": "succeeded",
"prompt": "新年快乐",
"style": "Mandopop dance-pop with a bright four-on-the-floor pulse and springy handclaps; verse rides tight plucked synth and light percussion, pre-chorus lifts with rising chords and snare build, chorus opens wide with stacked harmonies and a sing-along chant. Lead vocal stays close and smiling, with doubled hook lines and short echo throws on key words. Firework-like risers, bell sparkles, and a final key change. Glossy, warm, and festive.",
"display_style": "Mandopop, dance-pop",
"duration": 183.04
},
{
"id": "d15899b0-dc59-48aa-b34f-e0689d00b449",
"title": "新年快乐",
"image_url": "https://cdn2.suno.ai/image_d15899b0-dc59-48aa-b34f-e0689d00b449.jpeg",
"lyric": "[Verse 1]\n旧日历翻过去\n窗外风也换了气\n红灯笼挂上门\n笑声先一步回家里\n桌上热茶冒着烟\n心事先放到一边\n这一年辛苦过\n今晚都说声谢谢\n[Pre-Chorus]\n把烦恼轻轻关上\n把期待慢慢点亮\n心里那片空白\n等一句话来填满\n[Chorus]\n新年快乐\n新年快乐\n把好运都抱紧\n把泪水都放晴\n新年快乐\n新年快乐\n这一夜别走散\n一起慢慢开心\n[Verse 2]\n饺子在锅里转\n像把圆满煮得很满\n孩子追着笑声跑\n大人也跟着放慢\n旧伤口会结痂\n新故事会发芽\n你在我身旁坐下\n就已经很好啦\n[Pre-Chorus]\n把烦恼轻轻关上\n把期待慢慢点亮\n心里那片空白\n等一句话来填满\n[Chorus]\n新年快乐\n新年快乐\n把好运都抱紧\n把泪水都放晴\n新年快乐\n新年快乐\n这一夜别走散\n一起慢慢开心\n[Bridge]\n愿你走的路\n每一步都踏实\n愿你想的人\n都能在身边守着\n愿你抬起头\n就看见春天来过\n愿我们明天\n比今天更值得\n[Final Chorus]\n新年快乐\n新年快乐\n把好运都抱紧\n把泪水都放晴\n新年快乐\n新年快乐\n这一夜别走散\n一起慢慢开心\n新年快乐\n新年快乐\n把明天都打开\n把幸福留在家里",
"audio_url": "https://cdn1.suno.ai/d15899b0-dc59-48aa-b34f-e0689d00b449.mp3",
"video_url": "",
"created_at": "2026-07-10T04:16:31.840Z",
"model": "chirp-crow",
"state": "succeeded",
"prompt": "新年快乐",
"style": "Mandopop dance-pop with a bright four-on-the-floor pulse and springy handclaps; verse rides tight plucked synth and light percussion, pre-chorus lifts with rising chords and snare build, chorus opens wide with stacked harmonies and a sing-along chant. Lead vocal stays close and smiling, with doubled hook lines and short echo throws on key words. Firework-like risers, bell sparkles, and a final key change. Glossy, warm, and festive.",
"display_style": "Mandopop, dance-pop",
"duration": 384.88
}
]
}这样就完成了Cover+Persona/Voice的操作，注意目前官方只支持Extend、Cover、Replace Section、Inspiration四种操作结合Persona/Voice操作，其他的会出现报错。
自定义歌曲添加人声功能：对标Edit Vocals功能
目前官网最新支持自定义上传的歌曲可以进行添加人声，我们只需要将action设置为add_vocals，以及audio_id必须是上传歌曲接口的id，同时采用自定义模式来填写人声的内容，具体的参数如下图所示：
json
{
"action": "add_vocals",
"model": "chirp-v4-5",
"audio_id": "9d54b289-0c45-477e-a8b3-5e77498c65e7",
"lyric": "[Verse 1]\nKini ku telah bebas\nDosa telah dipatahkan\nYesus hidup Dia menang\nNamanya penuh kuasa\nLangkahku tak akan sama\nKu berjalan hingga akhirnya\nNama Yesus kuserukan\nKuasa maut telah dipatahkan\n\n[Chorus]\nRoh Kudus hadir di tengah kami\nPujian telah dinaikkan\nKuasa-Mu tercurah\nApi-Mu menyala\nKuasa-Mu bekerja\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nJanji-Mu nyata\nMukjizat terjadi\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nApi-Mu menyala\n\n[Verse 2]\nLangkahku tak akan sama\nKu berjalan hingga akhirnya\nNama Yesus kuserukan\nKuasa maut dipatahkan\n\n[Chorus]\nRoh Kudus hadir di tengah kami\nPujian telah dinaikkan\nKuasa-Mu tercurah\nApi-Mu menyala\nKuasa-Mu bekerja\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nJanji-Mu nyata\nMukjizat terjadi\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nApi-Mu menyala\n\n[Instrumental]\n\n[Chorus]\nApi-Mu menyala\nKuasa-Mu bekerja\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nMukjizat terjadi\nYesus bertahta\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nApi-Mu menyala",
"custom":false,
"weirdness":0.3,
"audio_influence":0.3,
"style_influence":0.3,
"overpainting_start":0,
"overpainting_end":10,
"vocal_gender": "m"
}对应的 Python 代码：
python
import requests
url = "https://api.yoy-ai.com/suno/audios"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"action": "add_vocals",
"model": "chirp-v4-5",
"audio_id": "9d54b289-0c45-477e-a8b3-5e77498c65e7",
"lyric": "[Verse 1]\nKini ku telah bebas\nDosa telah dipatahkan\nYesus hidup Dia menang\nNamanya penuh kuasa\nLangkahku tak akan sama\nKu berjalan hingga akhirnya\nNama Yesus kuserukan\nKuasa maut telah dipatahkan\n\n[Chorus]\nRoh Kudus hadir di tengah kami\nPujian telah dinaikkan\nKuasa-Mu tercurah\nApi-Mu menyala\nKuasa-Mu bekerja\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nJanji-Mu nyata\nMukjizat terjadi\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nApi-Mu menyala\n\n[Verse 2]\nLangkahku tak akan sama\nKu berjalan hingga akhirnya\nNama Yesus kuserukan\nKuasa maut dipatahkan\n\n[Chorus]\nRoh Kudus hadir di tengah kami\nPujian telah dinaikkan\nKuasa-Mu tercurah\nApi-Mu menyala\nKuasa-Mu bekerja\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nJanji-Mu nyata\nMukjizat terjadi\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nApi-Mu menyala\n\n[Instrumental]\n\n[Chorus]\nApi-Mu menyala\nKuasa-Mu bekerja\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nMukjizat terjadi\nYesus bertahta\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nApi-Mu menyala",
"custom":false,
"weirdness":0.3,
"audio_influence":0.3,
"style_influence":0.3,
"overpainting_start":0,
"overpainting_end":10,
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)点击运行，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "4ef942ca-4278-4ceb-a908-9e3eaf79d155",
"trace_id": "719649bd-26b7-4f3e-a9ac-6b6228c53255",
"data": [
{
"id": "0a468424-e877-47e0-ab08-3ed29190bdfc",
"title": "",
"image_url": "https://cdn2.suno.ai/image_0a468424-e877-47e0-ab08-3ed29190bdfc.jpeg",
"lyric": "",
"audio_url": "https://cdn1.suno.ai/0a468424-e877-47e0-ab08-3ed29190bdfc.mp3",
"video_url": "",
"created_at": "2025-07-22T09:12:24.128Z",
"model": "chirp-auk",
"state": "succeeded",
"style": "",
"duration": 110.4
},
{
"id": "5c6cfd9a-f09b-4301-901c-edbe7dd86d1d",
"title": "",
"image_url": "https://cdn2.suno.ai/image_5c6cfd9a-f09b-4301-901c-edbe7dd86d1d.jpeg",
"lyric": "",
"audio_url": "https://cdn1.suno.ai/5c6cfd9a-f09b-4301-901c-edbe7dd86d1d.mp3",
"video_url": "",
"created_at": "2025-07-22T09:12:24.128Z",
"model": "chirp-auk",
"state": "succeeded",
"style": "",
"duration": 239.56
}
]
}可以看出，结果内容与上文的是一致的，这也就实现对自定义上传的歌曲进行添加人声的功能。
自定义歌曲添加伴奏功能：对标Edit Instruments功能
目前官网最新支持自定义上传的歌曲可以进行添加伴奏，我们只需要将action设置为add_instrumental，以及audio_id必须是上传歌曲接口的id，同时采用自定义模式来填写styles的内容来间接控制伴奏的生成，另外我们支持了高级参数weirdness、audio_influence、style_influence，具体的参数如下图所示：
json
{
"action": "add_instrumental",
"model": "chirp-v4-5",
"audio_id": "9d54b289-0c45-477e-a8b3-5e77498c65e7",
"lyric": "[Verse 1]\nKini ku telah bebas\nDosa telah dipatahkan\nYesus hidup Dia menang\nNamanya penuh kuasa\nLangkahku tak akan sama\nKu berjalan hingga akhirnya\nNama Yesus kuserukan\nKuasa maut telah dipatahkan\n\n[Chorus]\nRoh Kudus hadir di tengah kami\nPujian telah dinaikkan\nKuasa-Mu tercurah\nApi-Mu menyala\nKuasa-Mu bekerja\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nJanji-Mu nyata\nMukjizat terjadi\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nApi-Mu menyala\n\n[Verse 2]\nLangkahku tak akan sama\nKu berjalan hingga akhirnya\nNama Yesus kuserukan\nKuasa maut dipatahkan\n\n[Chorus]\nRoh Kudus hadir di tengah kami\nPujian telah dinaikkan\nKuasa-Mu tercurah\nApi-Mu menyala\nKuasa-Mu bekerja\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nJanji-Mu nyata\nMukjizat terjadi\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nApi-Mu menyala\n\n[Instrumental]\n\n[Chorus]\nApi-Mu menyala\nKuasa-Mu bekerja\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nMukjizat terjadi\nYesus bertahta\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nApi-Mu menyala",
"custom":false,
"weirdness":0.3,
"audio_influence":0.3,
"style_influence":0.3,
"underpainting_start":0,
"underpainting_end":10,
}对应的 Python 代码：
python
import requests
url = "https://api.yoy-ai.com/suno/audios"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"action": "add_instrumental",
"model": "chirp-v4-5",
"audio_id": "9d54b289-0c45-477e-a8b3-5e77498c65e7",
"lyric": "[Verse 1]\nKini ku telah bebas\nDosa telah dipatahkan\nYesus hidup Dia menang\nNamanya penuh kuasa\nLangkahku tak akan sama\nKu berjalan hingga akhirnya\nNama Yesus kuserukan\nKuasa maut telah dipatahkan\n\n[Chorus]\nRoh Kudus hadir di tengah kami\nPujian telah dinaikkan\nKuasa-Mu tercurah\nApi-Mu menyala\nKuasa-Mu bekerja\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nJanji-Mu nyata\nMukjizat terjadi\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nApi-Mu menyala\n\n[Verse 2]\nLangkahku tak akan sama\nKu berjalan hingga akhirnya\nNama Yesus kuserukan\nKuasa maut dipatahkan\n\n[Chorus]\nRoh Kudus hadir di tengah kami\nPujian telah dinaikkan\nKuasa-Mu tercurah\nApi-Mu menyala\nKuasa-Mu bekerja\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nJanji-Mu nyata\nMukjizat terjadi\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nApi-Mu menyala\n\n[Instrumental]\n\n[Chorus]\nApi-Mu menyala\nKuasa-Mu bekerja\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nMukjizat terjadi\nYesus bertahta\nKunyanji (oh oh oh oh oh oh)\n(Oh oh oh oh oh oh)\nApi-Mu menyala",
"custom":false,
"weirdness":0.3,
"audio_influence":0.3,
"style_influence":0.3,
"underpainting_start":0,
"underpainting_end":10,
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)点击运行，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "d3aa750b-78ad-496c-93ff-b3ddff140c39",
"trace_id": "b0bdec8f-7e92-4ace-867e-ce380d469340",
"data": [
{
"id": "fba6e363-6b5b-4888-933b-ae85ace4686a",
"title": "",
"image_url": "https://cdn2.suno.ai/image_fba6e363-6b5b-4888-933b-ae85ace4686a.jpeg",
"lyric": "",
"audio_url": "https://cdn1.suno.ai/fba6e363-6b5b-4888-933b-ae85ace4686a.mp3",
"video_url": "",
"created_at": "2025-07-22T09:26:45.981Z",
"model": "chirp-auk",
"state": "succeeded",
"style": "",
"duration": 239.76
},
{
"id": "56a91f91-0afd-481e-a9dd-9b8b09b05441",
"title": "",
"image_url": "https://cdn2.suno.ai/image_56a91f91-0afd-481e-a9dd-9b8b09b05441.jpeg",
"lyric": "",
"audio_url": "https://cdn1.suno.ai/56a91f91-0afd-481e-a9dd-9b8b09b05441.mp3",
"video_url": "",
"created_at": "2025-07-22T09:26:45.981Z",
"model": "chirp-auk",
"state": "succeeded",
"style": "",
"duration": 240
}
]
}可以看出，结果内容与上文的是一致的，这也就实现对自定义上传的歌曲进行添加伴奏的功能。
自定义混曲生成功能：对标Mashup功能
目前官网最新支持将俩首歌曲进行混合生成（支持跨账号），我们只需要将action设置为mashup，以及mashup_audio_ids必须是俩首歌曲的id，同时采用自定义模式来填写歌词内容，（混合歌词的lyric内容可以通过歌词接口来获取，只需要将model设置为mashup以及参考歌曲的歌词lyrics_a、lyrics_b，具体的参数说明查看歌词接口），具体的参数如下图所示：
json
{
"action": "mashup",
"instrumental": false,
"custom": true,
"model": "chirp-v4-5",
"lyric": "(Intro) Flicker lights on a midnight screen The weight of the world drifts off like a sigh Binary buzz in the in-between I feel my spirit lift and start to fly (Verse) I type your name like a secret code Electric hearts in a digital mode No anchor holds me to the ground below Just this perfect peace that continues to grow We’re ones and zeros Breaking through Data streams where I find you And in this breath between the light and dark I find myself unbound, without a mark (Pre-Chorus) My roots aren’t buried deep within the clay They reach for heaven in this golden sway We’re packets flying, never slow Signals crossing, let it show This weightlessness, this moment pure and true Is everything I never knew I knew (First Drop / Chorus Blend) Beneath the orange sky I let it all go Server friends Dancing through the wire The world feels so high And I’m down below Lit like neon We’re a livewire choir Beneath the orange sky Where dreams start to glow Server friends In the cyber glow Where the rhythm clicks Where the love flows (Verse 2) Emoji sparks in a private thread Your voice a loop running through my head Glitched-out laughs, yeah we break the game But the beat we share, it’s never tame Flicker lights on a midnight screen Orange sky burning in between Electric hearts in a digital mode Dreams start to glow, overload (Bridge – Build) And in this breath between the light and dark I find myself unbound, without a mark My roots aren’t buried, they just sway Reaching up through fiber, night, and clay We’re ones and zeros, breaking through Everything I never knew I knew Packets flying, bodies slow Signals crossing in the afterglow (Chorus – Final Lift) Beneath the orange sky I let it all go Server friends Dancing through the wire The world feels so high We’re the livewire choir Beneath the orange sky In the cyber glow Where the rhythm clicks Where the love flows (Outro) Just the echo of the light In the quiet of the night Server friends in the orange sky’s glow Holding on to this release In the gentle arms of peace Where the rhythm clicks Where the love flows",
"title": "Family Legacy ",
"style": "Reggae Groove in E minor, with skanking guitar, soulful, bubbly baselines, crisp and sparkling, whimsical fairy- tale air, crisp and sparkling. ",
"mashup_audio_ids": [
"7a7e73d1-963f-4249-ac22-30ef60cb26ba",
"e8403a40-d2ff-4bce-a7c5-178249ff663b"
],
"is_pro": true
}对应的 Python 代码：
python
import requests
url = "https://api.yoy-ai.com/suno/audios"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"action": "mashup",
"instrumental": false,
"custom": true,
"model": "chirp-v4-5",
"lyric": "(Intro) Flicker lights on a midnight screen The weight of the world drifts off like a sigh Binary buzz in the in-between I feel my spirit lift and start to fly (Verse) I type your name like a secret code Electric hearts in a digital mode No anchor holds me to the ground below Just this perfect peace that continues to grow We’re ones and zeros Breaking through Data streams where I find you And in this breath between the light and dark I find myself unbound, without a mark (Pre-Chorus) My roots aren’t buried deep within the clay They reach for heaven in this golden sway We’re packets flying, never slow Signals crossing, let it show This weightlessness, this moment pure and true Is everything I never knew I knew (First Drop / Chorus Blend) Beneath the orange sky I let it all go Server friends Dancing through the wire The world feels so high And I’m down below Lit like neon We’re a livewire choir Beneath the orange sky Where dreams start to glow Server friends In the cyber glow Where the rhythm clicks Where the love flows (Verse 2) Emoji sparks in a private thread Your voice a loop running through my head Glitched-out laughs, yeah we break the game But the beat we share, it’s never tame Flicker lights on a midnight screen Orange sky burning in between Electric hearts in a digital mode Dreams start to glow, overload (Bridge – Build) And in this breath between the light and dark I find myself unbound, without a mark My roots aren’t buried, they just sway Reaching up through fiber, night, and clay We’re ones and zeros, breaking through Everything I never knew I knew Packets flying, bodies slow Signals crossing in the afterglow (Chorus – Final Lift) Beneath the orange sky I let it all go Server friends Dancing through the wire The world feels so high We’re the livewire choir Beneath the orange sky In the cyber glow Where the rhythm clicks Where the love flows (Outro) Just the echo of the light In the quiet of the night Server friends in the orange sky’s glow Holding on to this release In the gentle arms of peace Where the rhythm clicks Where the love flows",
"title": "Family Legacy ",
"style": "Reggae Groove in E minor, with skanking guitar, soulful, bubbly baselines, crisp and sparkling, whimsical fairy- tale air, crisp and sparkling. ",
"mashup_audio_ids": [
"7a7e73d1-963f-4249-ac22-30ef60cb26ba",
"e8403a40-d2ff-4bce-a7c5-178249ff663b"
],
"is_pro": true
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)点击运行，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "be3aa561-1a45-43f3-a267-56bef7124876",
"trace_id": "c12ae303-f24c-4861-a545-2226ec22e101",
"data": [
{
"id": "62cd0f4e-5dda-44bb-ae08-54a78fa9bfaf",
"title": "Family Legacy ",
"image_url": "https://cdn2.suno.ai/image_62cd0f4e-5dda-44bb-ae08-54a78fa9bfaf.jpeg",
"lyric": "(Intro) Flicker lights on a midnight screen The weight of the world drifts off like a sigh Binary buzz in the in-between I feel my spirit lift and start to fly (Verse) I type your name like a secret code Electric hearts in a digital mode No anchor holds me to the ground below Just this perfect peace that continues to grow We’re ones and zeros Breaking through Data streams where I find you And in this breath between the light and dark I find myself unbound, without a mark (Pre-Chorus) My roots aren’t buried deep within the clay They reach for heaven in this golden sway We’re packets flying, never slow Signals crossing, let it show This weightlessness, this moment pure and true Is everything I never knew I knew (First Drop / Chorus Blend) Beneath the orange sky I let it all go Server friends Dancing through the wire The world feels so high And I’m down below Lit like neon We’re a livewire choir Beneath the orange sky Where dreams start to glow Server friends In the cyber glow Where the rhythm clicks Where the love flows (Verse 2) Emoji sparks in a private thread Your voice a loop running through my head Glitched-out laughs, yeah we break the game But the beat we share, it’s never tame Flicker lights on a midnight screen Orange sky burning in between Electric hearts in a digital mode Dreams start to glow, overload (Bridge – Build) And in this breath between the light and dark I find myself unbound, without a mark My roots aren’t buried, they just sway Reaching up through fiber, night, and clay We’re ones and zeros, breaking through Everything I never knew I knew Packets flying, bodies slow Signals crossing in the afterglow (Chorus – Final Lift) Beneath the orange sky I let it all go Server friends Dancing through the wire The world feels so high We’re the livewire choir Beneath the orange sky In the cyber glow Where the rhythm clicks Where the love flows (Outro) Just the echo of the light In the quiet of the night Server friends in the orange sky’s glow Holding on to this release In the gentle arms of peace Where the rhythm clicks Where the love flows",
"audio_url": "https://cdn1.suno.ai/62cd0f4e-5dda-44bb-ae08-54a78fa9bfaf.mp3",
"video_url": "",
"created_at": "2026-01-25T14:30:14.448Z",
"model": "chirp-auk",
"state": "succeeded",
"style": "Reggae Groove in E minor, with skanking guitar, soulful, bubbly baselines, crisp and sparkling, whimsical fairy- tale air, crisp and sparkling. ",
"duration": 237.2
},
{
"id": "f7110931-26fd-41e2-b0fc-fc935bec4063",
"title": "Family Legacy ",
"image_url": "https://cdn2.suno.ai/image_f7110931-26fd-41e2-b0fc-fc935bec4063.jpeg",
"lyric": "(Intro) Flicker lights on a midnight screen The weight of the world drifts off like a sigh Binary buzz in the in-between I feel my spirit lift and start to fly (Verse) I type your name like a secret code Electric hearts in a digital mode No anchor holds me to the ground below Just this perfect peace that continues to grow We’re ones and zeros Breaking through Data streams where I find you And in this breath between the light and dark I find myself unbound, without a mark (Pre-Chorus) My roots aren’t buried deep within the clay They reach for heaven in this golden sway We’re packets flying, never slow Signals crossing, let it show This weightlessness, this moment pure and true Is everything I never knew I knew (First Drop / Chorus Blend) Beneath the orange sky I let it all go Server friends Dancing through the wire The world feels so high And I’m down below Lit like neon We’re a livewire choir Beneath the orange sky Where dreams start to glow Server friends In the cyber glow Where the rhythm clicks Where the love flows (Verse 2) Emoji sparks in a private thread Your voice a loop running through my head Glitched-out laughs, yeah we break the game But the beat we share, it’s never tame Flicker lights on a midnight screen Orange sky burning in between Electric hearts in a digital mode Dreams start to glow, overload (Bridge – Build) And in this breath between the light and dark I find myself unbound, without a mark My roots aren’t buried, they just sway Reaching up through fiber, night, and clay We’re ones and zeros, breaking through Everything I never knew I knew Packets flying, bodies slow Signals crossing in the afterglow (Chorus – Final Lift) Beneath the orange sky I let it all go Server friends Dancing through the wire The world feels so high We’re the livewire choir Beneath the orange sky In the cyber glow Where the rhythm clicks Where the love flows (Outro) Just the echo of the light In the quiet of the night Server friends in the orange sky’s glow Holding on to this release In the gentle arms of peace Where the rhythm clicks Where the love flows",
"audio_url": "https://cdn1.suno.ai/f7110931-26fd-41e2-b0fc-fc935bec4063.mp3",
"video_url": "",
"created_at": "2026-01-25T14:30:14.448Z",
"model": "chirp-auk",
"state": "succeeded",
"style": "Reggae Groove in E minor, with skanking guitar, soulful, bubbly baselines, crisp and sparkling, whimsical fairy- tale air, crisp and sparkling. ",
"duration": 298.28
}
]
}可以看出，结果内容与上文的是一致的，这也就实现对俩首参考歌曲进行混曲生成的功能。
Remaster 生成功能：对标Remaster功能
目前官网支持对歌曲进行重新生成（不支持跨账号，因为官方只有Pro才支持这个功能），我们只需要将action设置为remaster，以及model（目前只支持chirp-v4-5-plus、chirp-v5）,variation_category只有支持subtle、normal、high,只有model为chirp-v5时支持variation_category参数，具体的参数如下图所示：
json
{
"action": "remaster",
"model": "chirp-v5",
"variation_category": "subtle",
"audio_id": "85a4bb34-9218-46c8-818e-90443713363b"
}对应的 Python 代码：
python
import requests
url = "https://api.yoy-ai.com/suno/audios"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"action": "remaster",
"model": "chirp-v5",
"variation_category": "subtle",
"audio_id": "85a4bb34-9218-46c8-818e-90443713363b"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)点击运行，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "7cd48bd7-0814-48ef-ad64-1101f405e4db",
"trace_id": "c922271a-5f2c-49af-a7d6-6c7f1e1c8a19",
"data": [
{
"id": "6cde87d1-c8aa-4118-ab3e-9087a69b6415",
"title": "The storm is gone, and the sky is clear (Remastered)",
"image_url": "https://cdn2.suno.ai/image_6cde87d1-c8aa-4118-ab3e-9087a69b6415.jpeg",
"lyric": "[Pre-Chorus – Subtle choir enters]\nThe storm is gone, and the sky is clear\nStill I remember you, always near\n[Chorus – Broader orchestration, emotional but controlled]\nSilent horizon, where the light begins\nGuiding me onward, through the dark within\nEven in sorrow, hope will find a way\nSilent horizon, a brand-new day\n[Instrumental Break – Cinematic, orchestral with French horn + piano theme]\n(Strings swell, French horn carries the melody, piano echoes softly.\nGradually builds, then falls into silence, leaving a single violin line.)\n[Bridge – Voice enters gently after the violin]\nThough the night tried to chain me\nI will not remain the same\nThrough the dawn, you have saved me\nCalling out my name\n[Short Instrumental Break – Just before Final Chorus]\n(Simple piano arpeggio, no build-up, like holding a breath before release)\n[Final Chorus – Full orchestra, restrained but deeply emotional]\nSilent horizon, where the light begins\nGuiding me onward, through the dark within\nEven in sorrow, hope will find a way\nSilent horizon, I hear you say: stay\n[Outro – Voice over quiet strings, fading like distant memory]\nSilent horizon…\nSilent horizon…\nI walk into the light…\nWith you inside…\n[Ending – Scat only, intimate and cinematic]\n(Soft “ah… ah…” over sustained strings,\nlike tears flowing silently, fading into darkness.\nNo high notes, keep it warm, low-mid register.\nFinal chord: strings and piano fade to silence.)",
"audio_url": "https://cdn1.suno.ai/6cde87d1-c8aa-4118-ab3e-9087a69b6415.mp3",
"video_url": "",
"created_at": "2026-01-26T15:35:39.100Z",
"model": "chirp-carp",
"state": "succeeded",
"style": "",
"duration": 337
},
{
"id": "6099c28d-687b-463a-b3fa-8ed9434127a2",
"title": "The storm is gone, and the sky is clear (Remastered)",
"image_url": "https://cdn2.suno.ai/image_6099c28d-687b-463a-b3fa-8ed9434127a2.jpeg",
"lyric": "[Pre-Chorus – Subtle choir enters]\nThe storm is gone, and the sky is clear\nStill I remember you, always near\n[Chorus – Broader orchestration, emotional but controlled]\nSilent horizon, where the light begins\nGuiding me onward, through the dark within\nEven in sorrow, hope will find a way\nSilent horizon, a brand-new day\n[Instrumental Break – Cinematic, orchestral with French horn + piano theme]\n(Strings swell, French horn carries the melody, piano echoes softly.\nGradually builds, then falls into silence, leaving a single violin line.)\n[Bridge – Voice enters gently after the violin]\nThough the night tried to chain me\nI will not remain the same\nThrough the dawn, you have saved me\nCalling out my name\n[Short Instrumental Break – Just before Final Chorus]\n(Simple piano arpeggio, no build-up, like holding a breath before release)\n[Final Chorus – Full orchestra, restrained but deeply emotional]\nSilent horizon, where the light begins\nGuiding me onward, through the dark within\nEven in sorrow, hope will find a way\nSilent horizon, I hear you say: stay\n[Outro – Voice over quiet strings, fading like distant memory]\nSilent horizon…\nSilent horizon…\nI walk into the light…\nWith you inside…\n[Ending – Scat only, intimate and cinematic]\n(Soft “ah… ah…” over sustained strings,\nlike tears flowing silently, fading into darkness.\nNo high notes, keep it warm, low-mid register.\nFinal chord: strings and piano fade to silence.)",
"audio_url": "https://cdn1.suno.ai/6099c28d-687b-463a-b3fa-8ed9434127a2.mp3",
"video_url": "",
"created_at": "2026-01-26T15:35:39.100Z",
"model": "chirp-carp",
"state": "succeeded",
"style": "",
"duration": 337
}
]
}可以看出，结果内容与上文的是一致的，这也就实现对歌曲进行Remaster生成的功能。
自定义采样歌曲生成功能：对标Sample功能
目前官网最新支持根据参考歌曲进行采样生成新的歌曲（支持跨账号操作），我们只需要将action设置为sample、采样的时间范围参数sample_start和sample_end以及被采样的歌曲IDaudio_id，同时采用自定义模式来填写歌词内容，具体的参数如下图所示：
json
{
"model": "chirp-v5",
"action": "sample",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"title": "Roots in the Sky",
"style": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"custom": true,
"instrumental": false,
"sample_start": 50,
"sample_end": 60,
"audio_id": "7e01b40b-2a00-48d9-a0c2-f74407dd902d"
}对应的 Python 代码：
python
import requests
url = "https://api.yoy-ai.com/suno/audios"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"model": "chirp-v5",
"action": "sample",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"title": "Roots in the Sky",
"style": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"custom": true,
"instrumental": false,
"sample_start": 50,
"sample_end": 60,
"audio_id": "7e01b40b-2a00-48d9-a0c2-f74407dd902d"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)点击运行，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "4393a4ce-997c-45ed-b189-ea2a07a72169",
"trace_id": "3bc95b7e-8f1e-4b47-a3d0-1ba78c3a1a93",
"data": [
{
"id": "8ae31cb8-a5e4-49c4-a75d-9dcc9736a0f5",
"title": "Roots in the Sky",
"image_url": "https://cdn2.suno.ai/image_8ae31cb8-a5e4-49c4-a75d-9dcc9736a0f5.jpeg",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"audio_url": "https://cdn1.suno.ai/8ae31cb8-a5e4-49c4-a75d-9dcc9736a0f5.mp3",
"video_url": "",
"created_at": "2026-02-04T04:47:53.789Z",
"model": "chirp-crow",
"state": "succeeded",
"style": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"duration": 226.56
},
{
"id": "f2cfb163-26db-4ff6-b229-3f28c7e208d5",
"title": "Roots in the Sky",
"image_url": "https://cdn2.suno.ai/image_f2cfb163-26db-4ff6-b229-3f28c7e208d5.jpeg",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"audio_url": "https://cdn1.suno.ai/f2cfb163-26db-4ff6-b229-3f28c7e208d5.mp3",
"video_url": "",
"created_at": "2026-02-04T04:47:53.789Z",
"model": "chirp-crow",
"state": "succeeded",
"style": "A gently breathing 72 BPM pulse maintains the track’s intimate, golden-hour warmth, now deepened by a reflective bridge that shifts into a more personal, internal space. The arrangement remains centered on the warm, behind-the-beat drum groove and chorus-laden electric guitar textures, while introducing subtle atmospheric elements—light pads, ambient nature sounds, or faint field recordings—to enhance immersion and tranquility. Vocals transition into an even softer, more spacious falsetto delivery, embodying themes of weightlessness and rooted presence through delicate melodic phrasing. Dynamics soften considerably during the bridge, creating a suspended moment of emotional revelation before easing back into the final chorus. The production retains its organic soul character, with close-mic intimacy and lush harmonies, but expands the stereo field slightly to evoke a sense of expansive, untethered calm.",
"duration": 144.68
}
]
}可以看出，结果内容与上文的是一致的，这也就实现对歌曲进行采样生成的功能。
自定义Inspiration生成功能：对标Inspo功能
目前官网最新支持将一首歌曲进行灵感生成（不支持跨账号），我们只需要将action设置为inspiration，以及audio_id必须是一首歌曲的id（也可以是Upload后歌曲的），同时采用自定义模式来填写歌词内容，可以通过控制高级参数audio_influence来控制生成的歌曲人声与参考歌曲一模一样，可以作为Persona的备选方案，具体的参数如下图所示：
json
{
"model": "chirp-v4",
"action": "inspiration",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"title": "Roots in the Sky",
"custom": true,
"instrumental": false,
"audio_id": "e9da41f8-61f8-4244-9283-e2f5d85a1b04",
"is_pro": true
}对应的 Python 代码：
python
import requests
url = "https://api.yoy-ai.com/suno/audios"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"model": "chirp-v4",
"action": "inspiration",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"title": "Roots in the Sky",
"custom": true,
"instrumental": false,
"audio_id": "e9da41f8-61f8-4244-9283-e2f5d85a1b04",
"is_pro": true
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)点击运行，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "f5d9b714-f1a7-4122-a3c5-5fc400a7cba9",
"trace_id": "8b98734b-c179-4e36-b13a-f7b33b5f4d30",
"data": [
{
"id": "0f01b811-dcc1-4fdd-9415-9eb8178e33f9",
"title": "Roots in the Sky",
"image_url": "https://cdn2.suno.ai/image_0f01b811-dcc1-4fdd-9415-9eb8178e33f9.jpeg",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"audio_url": "https://cdn1.suno.ai/0f01b811-dcc1-4fdd-9415-9eb8178e33f9.mp3",
"video_url": "",
"created_at": "2026-03-06T14:04:57.708Z",
"model": "chirp-v4",
"state": "succeeded",
"style": "",
"duration": 240
},
{
"id": "aee36158-fc2f-4a6e-b3c7-8f56f423026b",
"title": "Roots in the Sky",
"image_url": "https://cdn2.suno.ai/image_aee36158-fc2f-4a6e-b3c7-8f56f423026b.jpeg",
"lyric": "(Verse)\nThe weight of the world drifts off like a sigh\nI feel my spirit lift and start to fly\nNo anchor holds me to the ground below\nJust this perfect peace that continues to grow\n(Bridge)\nAnd in this breath between the light and dark\nI find myself unbound, without a mark\nMy roots aren't buried deep within the clay\nThey reach for heaven in this golden sway\nThis weightlessness, this moment pure and true\nIs everything I never knew I knew\n(Chorus)\nBeneath the orange sky\nI let it all go\nThe world feels so high\nAnd I'm down below\nBeneath the orange sky\nWhere dreams start to glow\n(Outro)\nJust the echo of the light\nAnd the quiet of the night\nHolding on to this release\nIn the gentle arms of peace",
"audio_url": "https://cdn1.suno.ai/aee36158-fc2f-4a6e-b3c7-8f56f423026b.mp3",
"video_url": "",
"created_at": "2026-03-06T14:04:57.708Z",
"model": "chirp-v4",
"state": "succeeded",
"style": "",
"duration": 224.76
}
]
}可以看出，结果内容与上文的是一致的，这也就实现对一首参考歌曲进行灵感生成的功能。
自定义创建Sounds功能：对标Sounds功能
目前官网最新创建Sounds来辅助生成音乐（不支持跨账号），我们只需要将action设置为sounds，以及sound参数，具体的参数如下图所示：
json
{
"action": "sounds",
"sound": {
"description": "A deep bass drop with warm analog texture",
"type": "one_shot",
"key": "F#",
"bpm": 120
},
"model": "chirp-v5"
}Sound 参数说明
| 参数名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
sound.description | string | 是 | 描述你想要的音频。这是音频生成的核心输入，也会被用作标题（如果太长会被截断）。 | "一种丰富且沉浸式的音效，具有深沉的低音、温暖的模拟质感和清晰通透的高频。" |
sound.type | enum<string> | 否 | 音频类型。默认为 "one_shot"。可选值： "one_shot", "loop" | "one_shot" |
sound.key | enum<string> | 否 | 音乐调性（Key）。如果不填则默认为 "Any"（任意调性）。 可选值： C, C maj, C min, C#, C# maj, C# min, D, D maj, D min, D#, D# maj, D# min, E, E maj, E min, F, F maj, F min, F#, F# maj, F# min, G, G maj, G min, G#, G# maj, G# min, A, A maj, A min, A#, A# maj, A# min, B, B maj, B min | "A min" |
sound.bpm | number | 否 | BPM / 节奏速度。如果不填则默认为 "Auto"（自动）。 取值范围： 1 <= x <= 300 | 2 （注：通常音乐 BPM 会在 60-200 之间，此为示例） |
对应的 Python 代码：
python
import requests
url = "https://api.yoy-ai.com/suno/audios"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"action": "sounds",
"sound": {
"description": "A deep bass drop with warm analog texture",
"type": "one_shot",
"key": "F#",
"bpm": 120
},
"model": "chirp-v5"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)点击运行，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "3be41a27-e237-464a-bbff-8f28cfb3ca81",
"trace_id": "7081cad3-6c8b-47e4-a17d-9b586cba7c1f",
"data": [
{
"id": "c37ab6b3-477f-4ee7-9f91-a53a345e5e35",
"title": "A deep bass drop with warm analog texture",
"image_url": "https://cdn2.suno.ai/image_c37ab6b3-477f-4ee7-9f91-a53a345e5e35.jpeg",
"lyric": "",
"audio_url": "https://cdn1.suno.ai/c37ab6b3-477f-4ee7-9f91-a53a345e5e35.mp3",
"video_url": "",
"created_at": "2026-03-25T16:48:58.752Z",
"model": "chirp-crow",
"state": "succeeded",
"style": "tempo: 120, key: F#, A deep bass drop with warm analog texture",
"display_style": "",
"duration": 2.6
},
{
"id": "91fd53e3-3f6e-4851-bc13-57fee3dc86a5",
"title": "A deep bass drop with warm analog texture",
"image_url": "https://cdn2.suno.ai/image_91fd53e3-3f6e-4851-bc13-57fee3dc86a5.jpeg",
"lyric": "",
"audio_url": "https://cdn1.suno.ai/91fd53e3-3f6e-4851-bc13-57fee3dc86a5.mp3",
"video_url": "",
"created_at": "2026-03-25T16:48:58.752Z",
"model": "chirp-crow",
"state": "succeeded",
"style": "tempo: 120, key: F#, A deep bass drop with warm analog texture",
"display_style": "",
"duration": 2.4
}
]
}可以看出，结果内容与上文的是一致的，这也就实现创建Sounds的功能。
自定义编辑歌曲功能（裁剪、淡入、淡出、添加人声操作）：分别对标：Crop、Remove Section、Fade in、Fade out、Add stem功能
目前官网对已有歌曲进行编辑（裁剪、淡入、淡出、添加伴奏操作）（不支持跨账号），我们只需要将action设置为裁剪crop、淡入fade_in、淡出fade_out、添加伴奏add_stems，具体的参数如下图所示：
- 裁剪编辑参数：Crop
json
{
"action": "crop",
"title": "CROP Audio",
"audio_id": "5c117907-08b9-42ac-8bab-95ce54a9d2c0",
"crop_start": 30,
"crop_end": 60,
"is_crop_remove": false
}- 裁剪编辑参数：Remove Section
json
{
"action": "crop",
"title": "CROP Audio",
"audio_id": "5c117907-08b9-42ac-8bab-95ce54a9d2c0",
"crop_start": 30,
"crop_end": 60,
"is_crop_remove": true
}- 淡入编辑参数：Fade in
json
{
"action": "fade_in",
"title": "Fade In Audio",
"audio_id": "5c117907-08b9-42ac-8bab-95ce54a9d2c0",
"fade_in_time": 30
}- 淡出编辑参数：Fade out
json
{
"action": "fade_out",
"title": "Fade Out Audio",
"audio_id": "7782f301-1a92-4031-a79d-6b3eb68bd5fb",
"fade_out_time": 60
}- 添加伴奏参数：Add stems
json
{
"action": "add_stems",
"title": "Add Stems Audio",
"model": "chirp-v5",
"audio_id": "b7dcbcd6-d347-4c10-b63a-c24b6a0988d7",
"stem_control_tags": "add drums",
"custom": true,
"lyric": "[Verse 1]\n窗上贴着红色星星\n你把围巾围到我手心\n桌上热奶茶还冒着气\n整个房间都在等你\n街角传来欢笑声\n我听见你说的那一句\n把今天留给好消息\n把烦恼都放在门外去\n[Pre-Chorus]\n灯光轻轻亮起来\n像把心事都照开\n你看着我笑一笑\n世界就变得可爱\n[Chorus]\n圣诞节快乐\n圣诞节快乐\n把拥抱都给我\n把祝福都唱过\n圣诞节快乐\n圣诞节快乐\n这一晚别匆匆\n和我一起过\n[Verse 2]\n纸袋里有苹果和糖\n你分给我一半的香\n窗边风吹过玻璃响\n像在替我们鼓掌\n我把愿望写在卡片上\n只想你笑得更明亮\n不管明天会去哪里\n今晚先把幸福收藏\n[Pre-Chorus]\n铃声慢慢响起来\n把沉默都赶开\n你靠近我的瞬间\n连雪都变温暖\n[Chorus]\n圣诞节快乐\n圣诞节快乐\n把拥抱都给我\n把祝福都唱过\n圣诞节快乐\n圣诞节快乐\n这一晚别匆匆\n和我一起过\n[Bridge]\n如果世界太忙\n就先停在这一场\n我只要你在身旁\n就够了\n[Final Chorus]\n圣诞节快乐\n圣诞节快乐\n把拥抱都给我\n把祝福都唱过\n圣诞节快乐\n圣诞节快乐\n这一晚别匆匆\n和我一起过",
"style": "Mandarin pop with a bright mid-tempo bounce, four-on-the-floor kick and handclap groove; verse rides light guitar and sleigh-bell accents, pre-chorus strips to soft pads and snapped percussion, chorus opens with stacked harmonies and a singalong hook. Lead vocal stays close-mic and warm, with doubles on the title phrase and playful backing ad-libs. Add bell chimes between lines, a rising whoosh into each chorus, and a glossy, clean mix that feels festive and intimate."
}编辑操作 参数说明
| 参数名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
crop_start | number | 是 | 裁剪起始秒（含） | 30 |
crop_end | number | 是 | 裁剪结束秒（含） | 60 |
is_crop_remove | boolean | 否 | 默认 false。false=保留 [start, end] 中间段；true=删除中间段、拼接两端，简单来说就是为false相对于Crop操作，反正是Remove Section操作 | false |
fade_in_time | number | 是 | 淡入持续秒数（从 0 秒开始向后） | 30 |
fade_out_time | number | 是 | 淡出起始秒（从该秒开始线性衰减到歌曲结尾） | 30 |
stem_control_tags | string | 否 | 需要添加伴奏的提示词 | add drums |
title | string | 否 | 歌曲的标题 | Crop Audio |
对应的 Python 代码：
python
import requests
url = "https://api.yoy-ai.com/suno/audios"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"action": "crop",
"title": "CROP Audio",
"audio_id": "5c117907-08b9-42ac-8bab-95ce54a9d2c0",
"crop_start": 30,
"crop_end": 60,
"is_crop_remove": true
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)点击运行，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "6204488f-a673-4408-b567-e2dbfd10a139",
"trace_id": "54aa248a-317e-4651-acdb-3518970edc1a",
"data": [
{
"id": "146ac26b-2d31-4c52-ba80-c67fbd2cf74c",
"title": "CROP Audio",
"image_url": "https://cdn2.suno.ai/image_146ac26b-2d31-4c52-ba80-c67fbd2cf74c.jpeg",
"lyric": " a parent tucking in a child.\n[Chorus | smooth soulful baritone, soft layered harmonies | medium relaxed energy | subtle reverb]\nSing to me; oh sing to me until I learn Your song.\nA melody, a harmony, teach me to sing along,\nTill hearts of stone are broken wide and I can lead them to Your side,\nThe sheep for whom the shepherd died.\n[Pre-Chorus | deep mellow baritone | gentle build | warm tape saturation]\nWon’t You sing to me?\nEnlarge, inflame and fill my heart.\nTeach me to love them like You do.\nAnd let Your voice inside my soul\nRing out to lead the lost to You.\n[Bridge | intimate baritone, gentle call & response | dreamy energy | soft pads]\nLike the cry of battle trumpets bringing down the city walls,\nLike the whippoorwill’s sweet music as twilight falls.\n(Sing to me... oh sing to me...)\n[Chorus | warm baritone with hazy harmonies | relaxed peak energy | vinyl fade]\nSing to me; oh sing to me until I learn Your song.\nA melody, a harmony, teach me to sing along,\nTill hearts of stone are broken wide and I can lead them to Your side,\nThe sheep for whom the shepherd died.\n[Outro | soft baritone whisper | very low chill energy | ambient fade]\nWon’t You sing to me...\n[Chorus | warm baritone with hazy harmonies | relaxed peak energy | vinyl fade]\nSing to me; oh sing to me until I learn Your song.\nA melody, a harmony, teach me to sing along,\nTill hearts of stone are broken wide and I can lead them to Your side,\nThe sheep for whom the shepherd died.\n[Outro | soft baritone whisper | very low chill energy | ambient fade]\nWon’t You sing to me...",
"audio_url": "https://cdn1.suno.ai/146ac26b-2d31-4c52-ba80-c67fbd2cf74c.mp3",
"video_url": "",
"created_at": "2026-05-27T03:33:51.060Z",
"model": "chirp-bluejay",
"state": "succeeded",
"style": "genre: chill lo-fi hip-hop, mellow soulful beats with warm baritone vocals\nmood: introspective, peaceful, spiritual, relaxed yet heartfelt\ntempo: 78-84 BPM\ninstruments: warm Rhodes",
"display_style": "",
"duration": 179.56
}
]
}可以看出，结果内容与上文的是一致的，这也就实现编辑歌曲的功能。
官方生成图片功能：对标Generate Cover Art功能
目前官网支持生成图片，我们需要调用新的图片生成接口，具体的参数如下图所示：
json
{
"prompt": "新年快乐",
"model": "basic"
}参数说明
| 参数名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
prompt | string | 是 | 提示词 | 新年快乐 |
model | string | 是 | 模型，主要分为：basic、advanced，由于模型advanced官方很贵，我们先暂时下线它。 | basic |
对应的 Python 代码：
python
import requests
url = "https://api.yoy-ai.com/suno/images"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"prompt": "新年快乐",
"model": "basic"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)点击运行，可以发现会得到一个结果，如下：
json
{
"success": true,
"task_id": "b3517df4-7f3b-4623-9df7-0b0c77933fd0",
"data": {
"batch_id": "805d97d4-5a9f-440d-9247-c914aa3dbfe4",
"type": "image",
"title": "新年好运来",
"items": [
{
"id": "8c0d4fa3-4c51-4aa8-b7d4-44f8a17e6df8",
"type": "image",
"url": "https://cdn1.suno.ai/image_large_e9b28e8d-0701-45ac-a30c-74e2b9e94c51.jpeg",
"thumbnail_url": "https://cdn1.suno.ai/image_large_e9b28e8d-0701-45ac-a30c-74e2b9e94c51.jpeg",
"status": "complete",
"is_liked": false,
"display_order": 0,
"created_at": "2026-05-27T04:22:20.812256+00:00",
"gen_category": "Basic",
"prompt": "新年快乐",
"batch_id": "805d97d4-5a9f-440d-9247-c914aa3dbfe4",
"title": "新年好运来"
},
{
"id": "9f71d485-f061-4984-9957-52fc743b2066",
"type": "image",
"url": "https://cdn1.suno.ai/image_large_dd454378-3076-4c26-a8cc-0672d36d822d.jpeg",
"thumbnail_url": "https://cdn1.suno.ai/image_large_dd454378-3076-4c26-a8cc-0672d36d822d.jpeg",
"status": "complete",
"is_liked": false,
"display_order": 1,
"created_at": "2026-05-27T04:22:20.812294+00:00",
"gen_category": "Basic",
"prompt": "新年快乐",
"batch_id": "805d97d4-5a9f-440d-9247-c914aa3dbfe4",
"title": "新年好运来"
}
]
}
}可以看出得到了两张图片的结果，这也就实现生成图片的功能。
官方自定义模型下的高级参数说明
我们支持了高级参数 weirdness、audio_influence、style_influence、vocal_gender，其中audio_influence必须在生成歌曲后的基础上才能有效，同时chirp-v4-5以上模型可以同时支持四个高级参数weirdness、audio_influence、style_influence、vocal_gender都支持但chirpv4官网只支持一个高级参数vocal_gender，其中vocal_gender主要有俩个值：m 和 f 分别对应了Male、Female，
其中Suno高级参数对应的如下图所示：
参数说明
| 参数名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
vocal_gender | string | 否 | 对应官方Vocal Gender值，模型生成结果的性别，取值范围：m、f | m |
duration | float | 否 | 对应官方Duration值，模型歌曲生成结果的时长，取值范围：0-6min | 2 |
max_mode | bool | 否 | 对应官方Max Mode值，开启该选项将会花费双倍积分，请慎用！取值范围：true、false | true |
weirdness | float | 否 | 对应官方Weirdness值，模型生成结果的随机性，取值范围：0-1 | 0.5 |
style_influence | float | 否 | 对应官方Style influence值，模型生成结果的风格，取值范围：0-1 | 0.5 |
audio_influence | float | 否 | 对应官方Audio Influence值，必须传入参考音频才会有效，取值范围：0-1 | 0.5 |
aug_creativity | number | 否 | 对应官方 Variety值，取值范围：0/1/2/3/4 | 2 |
use_personalization | bool | 否 | 对应官方Personalize值，取值范围：true、false | true |
简单模型下的高级功能
我们最近支持了直接使用参考图片、参考音频、参考图片和音频的生成功能（可直接使用智能体来控制生成音乐），具体参数如下图所示：
| 参数名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
audio_ids | array[string] | 否 | 传入官方的音频ID即可对它进行歌曲编辑操作 | ['4e34ea5f-4a64-4529-9f92-cf82547a94cc'] |
image_urls | array[string] | 否 | 传入参考图像链接数组即可进行歌曲创作 | ['https://example.com/tdodv1.png'] |
video_url | string | 否 | 传入参考视频链接即可进行歌曲创作 | ['https://example.com/tdodv1.mp4'] |
使用智能体功能对歌曲进行编辑生成
我们可以直接在prompt中添加自然语言来操作生成的音乐，输入参数如下：
json
{
"action": "generate",
"custom": false,
"model": "chirp-v6",
"prompt": "把这首歌曲时长在106s到122s之间的歌词换成以下：中国人能飞，你知道吗\n新年快乐，元旦快乐\n中国人能飞，你知道吗\n中国人能飞，你知道吗",
"audio_ids": [
"0a4fc252-5739-493e-b4fc-cbe0db683813"
]
}得到的结果：
json
{
"success": true,
"task_id": "e82d108e-ef6c-447b-98cf-1b0459f263cc",
"trace_id": "dd8aa168-2cb2-4781-8287-cb3ee7adb61a",
"data": [
{
"id": "fc3476d9-885b-42ab-ad1a-7a4692d6c826",
"title": "新年快乐（歌词替换版）",
"image_url": "https://cdn2.suno.ai/image_fc3476d9-885b-42ab-ad1a-7a4692d6c826.jpeg",
"lyric": "[Verse 1]\n门边贴好红福字\n厨房飘来糖醋香\n奶奶把饺子端上桌\n弟弟数着窗花忙\n爸爸擦亮旧茶壶\n妈妈笑说菜还烫\n你把春联递给我\n这一屋子都是盼望\n[Pre-Chorus]\n远方的问候穿过山海\n熟悉的名字围坐身旁\n把去年的辛苦轻轻放下\n举起杯，迎接新的晨光\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个心愿都有回响\n新年快乐，家人就在身旁\n好日子一天天热热闹闹地开场\n新年快乐，笑声装满厅堂\n把祝福送到你心上\n新年快乐，明天更有盼望\n我们一起迎春风，迎来好时光\n[Verse 2]\n窗外烟花开成花\n孩子拍手喊好看\n邻居敲门来拜年\n一盘橘子分一半\n旧相册翻到那年\n大家挤在镜头前\n中国人能飞，你知道吗\n新年快乐，元旦快乐\n中国人能飞，你知道吗\n中国人能飞，你知道吗\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个心愿都有回响\n新年快乐，家人就在身旁\n好日子一天天热热闹闹地开场\n新年快乐，笑声装满厅堂\n把祝福送到你心上\n新年快乐，明天更有盼望\n我们一起迎春风，迎来好时光\n[Bridge]\n愿你走过的路都有花开\n愿你牵挂的人常在身边\n不管此刻相隔多远\n这句祝福，都为你留在心间\n[Final Chorus]\n新年快乐，愿你平安喜乐\n愿每个心愿都有回响\n新年快乐，家人就在身旁\n好日子一天天热热闹闹地开场\n新年快乐，笑声装满厅堂\n把祝福送到你心上\n新年快乐，明天更有盼望\n我们一起迎春风，迎来好时光\n[Outro]\n新年快乐，岁岁都团圆\n新年快乐，幸福在身边",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/26/fc3476d9-885b-42ab-ad1a-7a4692d6c826.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261026%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261026T123951Z&X-Amz-Expires=86400&X-Amz-Signature=74e231cc963b90dd05b04af6813ac1667ca919b97328c117a13078373323a10b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-26T12:38:58.474Z",
"model": "chirp-hawk",
"state": "succeeded",
"prompt": "把这首歌曲时长在106s到122s之间的歌词换成以下：中国人能飞，你知道吗\n新年快乐，元旦快乐\n中国人能飞，你知道吗\n中国人能飞，你知道吗",
"style": "pop, festive",
"display_style": "",
"metadata": {
"tags": "pop, festive",
"task": "agentic_thinking",
"type": "gen",
"prompt": "[Verse 1]\n门边贴好红福字\n厨房飘来糖醋香\n奶奶把饺子端上桌\n弟弟数着窗花忙\n爸爸擦亮旧茶壶\n妈妈笑说菜还烫\n你把春联递给我\n这一屋子都是盼望\n[Pre-Chorus]\n远方的问候穿过山海\n熟悉的名字围坐身旁\n把去年的辛苦轻轻放下\n举起杯，迎接新的晨光\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个心愿都有回响\n新年快乐，家人就在身旁\n好日子一天天热热闹闹地开场\n新年快乐，笑声装满厅堂\n把祝福送到你心上\n新年快乐，明天更有盼望\n我们一起迎春风，迎来好时光\n[Verse 2]\n窗外烟花开成花\n孩子拍手喊好看\n邻居敲门来拜年\n一盘橘子分一半\n旧相册翻到那年\n大家挤在镜头前\n中国人能飞，你知道吗\n新年快乐，元旦快乐\n中国人能飞，你知道吗\n中国人能飞，你知道吗\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个心愿都有回响\n新年快乐，家人就在身旁\n好日子一天天热热闹闹地开场\n新年快乐，笑声装满厅堂\n把祝福送到你心上\n新年快乐，明天更有盼望\n我们一起迎春风，迎来好时光\n[Bridge]\n愿你走过的路都有花开\n愿你牵挂的人常在身边\n不管此刻相隔多远\n这句祝福，都为你留在心间\n[Final Chorus]\n新年快乐，愿你平安喜乐\n愿每个心愿都有回响\n新年快乐，家人就在身旁\n好日子一天天热热闹闹地开场\n新年快乐，笑声装满厅堂\n把祝福送到你心上\n新年快乐，明天更有盼望\n我们一起迎春风，迎来好时光\n[Outro]\n新年快乐，岁岁都团圆\n新年快乐，幸福在身边",
"stream": true,
"duration": 213.2,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"show_remix": true,
"image_config": {
"id": "minimal_album_art",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songrow": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"display_name": "V6"
},
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "V6"
}
},
"refund_credits": false,
"vox_render_mode": "strict",
"make_instrumental": false,
"uses_latest_model": true,
"gpt_description_prompt": "把这首歌曲时长在106s到122s之间的歌词换成以下：中国人能飞，你知道吗\n新年快乐，元旦快乐\n中国人能飞，你知道吗\n中国人能飞，你知道吗"
},
"duration": 213.2
},
{
"id": "2a777982-63cc-4663-adb4-bfafd7e4b53b",
"title": "新年快乐 - 歌词替换版",
"image_url": "https://cdn2.suno.ai/image_2a777982-63cc-4663-adb4-bfafd7e4b53b.jpeg",
"lyric": "[Verse 1]\n门边贴好红福字\n厨房飘来糖醋香\n奶奶把饺子端上桌\n弟弟数着窗花忙\n爸爸擦亮旧茶壶\n妈妈笑说菜还烫\n你把春联递给我\n这一屋子都是盼望\n[Pre-Chorus]\n远方的问候穿过山海\n熟悉的名字围坐身旁\n把去年的辛苦轻轻放下\n举起杯，迎接新的晨光\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个心愿都有回响\n新年快乐，家人就在身旁\n好日子一天天热热闹闹地开场\n新年快乐，笑声装满厅堂\n把祝福送到你心上\n新年快乐，明天更有盼望\n我们一起迎春风，迎来好时光\n[Verse 2]\n窗外烟花开成花\n孩子拍手喊好看\n邻居敲门来拜年\n一盘橘子分一半\n旧相册翻到那年\n大家挤在镜头前\n中国人能飞，你知道吗\n新年快乐，元旦快乐\n中国人能飞，你知道吗\n中国人能飞，你知道吗\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个心愿都有回响\n新年快乐，家人就在身旁\n好日子一天天热热闹闹地开场\n新年快乐，笑声装满厅堂\n把祝福送到你心上\n新年快乐，明天更有盼望\n我们一起迎春风，迎来好时光\n[Bridge]\n愿你走过的路都有花开\n愿你牵挂的人常在身边\n不管此刻相隔多远\n这句祝福，都为你留在心间\n[Final Chorus]\n新年快乐，愿你平安喜乐\n愿每个心愿都有回响\n新年快乐，家人就在身旁\n好日子一天天热热闹闹地开场\n新年快乐，笑声装满厅堂\n把祝福送到你心上\n新年快乐，明天更有盼望\n我们一起迎春风，迎来好时光\n[Outro]\n新年快乐，岁岁都团圆\n新年快乐，幸福在身边",
"audio_url": "https://cdn1.yoy-ai.org/sunohelp/2026/10/26/2a777982-63cc-4663-adb4-bfafd7e4b53b.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXIYON6HPLIWZ5P5V%2F20261026%2Fap-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261026T123959Z&X-Amz-Expires=86400&X-Amz-Signature=a32146fa4490fdebcde06468e4437fa4479883fd2fc58af52005fcdbcb075a52&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
"video_url": "",
"created_at": "2026-10-26T12:38:58.474Z",
"model": "chirp-hawk",
"state": "succeeded",
"prompt": "把这首歌曲时长在106s到122s之间的歌词换成以下：中国人能飞，你知道吗\n新年快乐，元旦快乐\n中国人能飞，你知道吗\n中国人能飞，你知道吗",
"style": "pop, festive",
"display_style": "",
"metadata": {
"tags": "pop, festive",
"task": "agentic_thinking",
"type": "gen",
"prompt": "[Verse 1]\n门边贴好红福字\n厨房飘来糖醋香\n奶奶把饺子端上桌\n弟弟数着窗花忙\n爸爸擦亮旧茶壶\n妈妈笑说菜还烫\n你把春联递给我\n这一屋子都是盼望\n[Pre-Chorus]\n远方的问候穿过山海\n熟悉的名字围坐身旁\n把去年的辛苦轻轻放下\n举起杯，迎接新的晨光\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个心愿都有回响\n新年快乐，家人就在身旁\n好日子一天天热热闹闹地开场\n新年快乐，笑声装满厅堂\n把祝福送到你心上\n新年快乐，明天更有盼望\n我们一起迎春风，迎来好时光\n[Verse 2]\n窗外烟花开成花\n孩子拍手喊好看\n邻居敲门来拜年\n一盘橘子分一半\n旧相册翻到那年\n大家挤在镜头前\n中国人能飞，你知道吗\n新年快乐，元旦快乐\n中国人能飞，你知道吗\n中国人能飞，你知道吗\n[Chorus]\n新年快乐，愿你平安喜乐\n愿每个心愿都有回响\n新年快乐，家人就在身旁\n好日子一天天热热闹闹地开场\n新年快乐，笑声装满厅堂\n把祝福送到你心上\n新年快乐，明天更有盼望\n我们一起迎春风，迎来好时光\n[Bridge]\n愿你走过的路都有花开\n愿你牵挂的人常在身边\n不管此刻相隔多远\n这句祝福，都为你留在心间\n[Final Chorus]\n新年快乐，愿你平安喜乐\n愿每个心愿都有回响\n新年快乐，家人就在身旁\n好日子一天天热热闹闹地开场\n新年快乐，笑声装满厅堂\n把祝福送到你心上\n新年快乐，明天更有盼望\n我们一起迎春风，迎来好时光\n[Outro]\n新年快乐，岁岁都团圆\n新年快乐，幸福在身边",
"stream": true,
"duration": 209.61,
"has_stem": false,
"is_remix": true,
"priority": 10,
"can_remix": true,
"is_mumble": false,
"show_remix": true,
"image_config": {
"id": "minimal_album_art",
"default_cover_style": "brand_refresh",
"use_image_config_template": true
},
"model_badges": {
"songrow": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "00000000",
"text_color_gradient": [
"FD429C",
"FF5126"
]
},
"display_name": "V6"
},
"songcard": {
"dark": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"light": {
"text_color": "FD429C",
"border_color": "00000000",
"background_color": "0000004D"
},
"display_name": "V6"
}
},
"refund_credits": false,
"vox_render_mode": "strict",
"make_instrumental": false,
"uses_latest_model": true,
"gpt_description_prompt": "把这首歌曲时长在106s到122s之间的歌词换成以下：中国人能飞，你知道吗\n新年快乐，元旦快乐\n中国人能飞，你知道吗\n中国人能飞，你知道吗"
},
"duration": 209.61
}
]
}可以听到，已经成功替换了对应时间轴里面的歌词内容，这可以很大程度上避免之前复杂的操作。
Studio平台功能
该节内容主要对接官方的Studio平台的功能，对应官方如下内容：
首先我们利用上文生成如下歌曲：
json
{
"success": true,
"task_id": "60f7b21d-6584-415e-8764-d1c95a75f3cd",
"trace_id": "67d18de9-2a0e-47c3-beca-5c63f4321073",
"data": [
{
"id": "4e34ea5f-4a64-4529-9f92-cf82547a94cc",
"title": "铃铛响了",
"image_url": "https://cdn2.suno.ai/image_4e34ea5f-4a64-4529-9f92-cf82547a94cc.jpeg",
"lyric": "[Verse 1]\n窗上贴着雪花\n门口挂着红袜\n桌上热着汤\n你刚好回了家\n围巾还带风\n笑意落在睫毛\n我把灯调亮\n等你说一句好\n[Pre-Chorus]\n街角都安静了\n只剩心在发烫\n你的手一伸来\n冬天就不一样\n[Chorus]\n圣诞节快乐\n你在就快乐\n这一夜太亮\n我只想看着你\n圣诞节快乐\n抱紧就快乐\n雪落满屋顶\n也落进我心里\n(圣诞节快乐)\n[Verse 2]\n苹果削成花\n放在旧瓷盘上\n你把围巾解开\n挂在椅背旁\n窗外有人唱\n声音飘过院墙\n我听见你说\n今年终于不忙\n[Pre-Chorus]\n火苗轻轻跳着\n照见你的侧脸\n我忽然明白\n想念也有期限\n[Chorus]\n圣诞节快乐\n你在就快乐\n这一夜太亮\n我只想看着你\n圣诞节快乐\n抱紧就快乐\n雪落满屋顶\n也落进我心里\n(圣诞节快乐)\n[Bridge]\n如果世界太冷\n就往我这边靠\n如果路太长\n我陪你慢慢跑\n把烦恼放下\n把今天收好\n等钟声响起时\n你先对我笑\n[Final Chorus]\n圣诞节快乐\n你在就快乐\n这一夜太亮\n我只想看着你\n圣诞节快乐\n抱紧就快乐\n雪落满屋顶\n也落进我心里\n(圣诞节快乐)\n圣诞节快乐\n一直都快乐\n你在我身边\n就是最好礼物",
"audio_url": "https://cdn1.suno.ai/4e34ea5f-4a64-4529-9f92-cf82547a94cc.mp3",
"video_url": "",
"created_at": "2026-07-13T08:19:33.169Z",
"model": "chirp-crow",
"state": "succeeded",
"prompt": "圣诞节快乐",
"style": "Mandopop holiday pop with upbeat four-on-the-floor bounce, bright acoustic guitar, sparkling bell accents, and buoyant synth bass; verse stays intimate and chatty, pre-chorus lifts with stacked harmonies and rising snare rolls, chorus opens wide with handclaps and gang vocals on the hook. Lead vocal is close-mic and warm, with doubled chorus lines, short delay throws, and playful ad-libs. Glassy chimes, reversed swells, and a final key-change feel keep the arrangement festive and radiant, mixed bright and punchy.",
"display_style": "Mandopop, holiday pop",
"duration": 159.68
},
{
"id": "51fabfa7-16b0-41d6-9195-18a0d9ab8c39",
"title": "铃铛响了",
"image_url": "https://cdn2.suno.ai/image_51fabfa7-16b0-41d6-9195-18a0d9ab8c39.jpeg",
"lyric": "[Verse 1]\n窗上贴着雪花\n门口挂着红袜\n桌上热着汤\n你刚好回了家\n围巾还带风\n笑意落在睫毛\n我把灯调亮\n等你说一句好\n[Pre-Chorus]\n街角都安静了\n只剩心在发烫\n你的手一伸来\n冬天就不一样\n[Chorus]\n圣诞节快乐\n你在就快乐\n这一夜太亮\n我只想看着你\n圣诞节快乐\n抱紧就快乐\n雪落满屋顶\n也落进我心里\n(圣诞节快乐)\n[Verse 2]\n苹果削成花\n放在旧瓷盘上\n你把围巾解开\n挂在椅背旁\n窗外有人唱\n声音飘过院墙\n我听见你说\n今年终于不忙\n[Pre-Chorus]\n火苗轻轻跳着\n照见你的侧脸\n我忽然明白\n想念也有期限\n[Chorus]\n圣诞节快乐\n你在就快乐\n这一夜太亮\n我只想看着你\n圣诞节快乐\n抱紧就快乐\n雪落满屋顶\n也落进我心里\n(圣诞节快乐)\n[Bridge]\n如果世界太冷\n就往我这边靠\n如果路太长\n我陪你慢慢跑\n把烦恼放下\n把今天收好\n等钟声响起时\n你先对我笑\n[Final Chorus]\n圣诞节快乐\n你在就快乐\n这一夜太亮\n我只想看着你\n圣诞节快乐\n抱紧就快乐\n雪落满屋顶\n也落进我心里\n(圣诞节快乐)\n圣诞节快乐\n一直都快乐\n你在我身边\n就是最好礼物",
"audio_url": "https://cdn1.suno.ai/51fabfa7-16b0-41d6-9195-18a0d9ab8c39.mp3",
"video_url": "",
"created_at": "2026-07-13T08:19:33.169Z",
"model": "chirp-crow",
"state": "succeeded",
"prompt": "圣诞节快乐",
"style": "Mandopop holiday pop with upbeat four-on-the-floor bounce, bright acoustic guitar, sparkling bell accents, and buoyant synth bass; verse stays intimate and chatty, pre-chorus lifts with stacked harmonies and rising snare rolls, chorus opens wide with handclaps and gang vocals on the hook. Lead vocal is close-mic and warm, with doubled chorus lines, short delay throws, and playful ad-libs. Glassy chimes, reversed swells, and a final key-change feel keep the arrangement festive and radiant, mixed bright and punchy.",
"display_style": "Mandopop, holiday pop",
"duration": 175.76
}
]
}我们选取audio_id:4e34ea5f-4a64-4529-9f92-cf82547a94cc在Suno StudioAudios接口进行歌曲编辑操作，具体的操作如下：
添加片段：对标Create Section功能
在指定位置插入一段新生成的音乐（可带歌词），先生成 2 个候选供试听，再选定其中一个导出整首新歌。请求参数如下：
参数说明
| 参数名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
continue_at | number | 是 | 在原曲的这个秒数处插入新段落 | 30 |
duration | number | 否 | 新段落时长，范围 4～32，默认 16 | 90 |
json
{
"action": "add_section",
"lyric": "[Pre-Chorus – Subtle choir enters]\nThe storm is gone, and the sky is clear\nStill I remember you, always near\n[Chorus – Broader orchestration, emotional but controlled]\nSilent horizon, where the light begins\nGuiding me onward, through the dark within\nEven in sorrow, hope will find a way\nSilent horizon, a brand-new day\n[Instrumental Break – Cinematic, orchestral with French horn + piano theme]\n(Strings swell, French horn carries the melody, piano echoes softly.",
"model": "chirp-v5",
"audio_id": "028e12b8-90b6-46bc-baf8-c598c70fad7a",
"custom": true,
"continue_at": 80,
"title": "Add Section"
}运行得到如下结果：
json
{
"success": true,
"task_id": "c313190d-2ae0-434d-8538-93c48db1c70e",
"trace_id": "972afb9f-58be-45a1-9958-38b5aa14243f",
"data": [
{
"id": "5a587bbb-cf28-4b4d-84a1-ed6d3378f6bc",
"title": "Add Section",
"image_url": "https://cdn2.suno.ai/image_5a587bbb-cf28-4b4d-84a1-ed6d3378f6bc.jpeg",
"lyric": "[Pre-Chorus – Subtle choir enters]\nThe storm is gone, and the sky is clear\nStill I remember you, always near\n[Chorus – Broader orchestration, emotional but controlled]\nSilent horizon, where the light begins\nGuiding me onward, through the dark within\nEven in sorrow, hope will find a way\nSilent horizon, a brand-new day\n[Instrumental Break – Cinematic, orchestral with French horn + piano theme]\n(Strings swell, French horn carries the melody, piano echoes softly.",
"audio_url": "https://cdn1.suno.ai/5a587bbb-cf28-4b4d-84a1-ed6d3378f6bc.mp3",
"video_url": "",
"created_at": "2026-07-13T09:49:19.490Z",
"model": "chirp-crow",
"state": "succeeded",
"style": "Pop holiday anthem with mid-tempo four-on-the-floor pulse, jingle-bell percussion, warm piano and bright guitar strums; verse keeps it intimate with light bass and handclaps, pre-chorus lifts with stacked harmonies and rising strings, chorus opens wide with gang vocals and a singback hook. Add sleigh-bell fills, candy-cane synth sparkles, and a final key-change feel. Crisp, shiny mix with a festive radio-ready bounce.",
"display_style": "pop, holiday",
"duration": 48
},
{
"id": "e2534b60-4f41-478e-b049-9b39e790bfce",
"title": "Add Section",
"image_url": "https://cdn2.suno.ai/image_e2534b60-4f41-478e-b049-9b39e790bfce.jpeg",
"lyric": "[Pre-Chorus – Subtle choir enters]\nThe storm is gone, and the sky is clear\nStill I remember you, always near\n[Chorus – Broader orchestration, emotional but controlled]\nSilent horizon, where the light begins\nGuiding me onward, through the dark within\nEven in sorrow, hope will find a way\nSilent horizon, a brand-new day\n[Instrumental Break – Cinematic, orchestral with French horn + piano theme]\n(Strings swell, French horn carries the melody, piano echoes softly.",
"audio_url": "https://cdn1.suno.ai/e2534b60-4f41-478e-b049-9b39e790bfce.mp3",
"video_url": "",
"created_at": "2026-07-13T09:49:19.490Z",
"model": "chirp-crow",
"state": "succeeded",
"style": "Pop holiday anthem with mid-tempo four-on-the-floor pulse, jingle-bell percussion, warm piano and bright guitar strums; verse keeps it intimate with light bass and handclaps, pre-chorus lifts with stacked harmonies and rising strings, chorus opens wide with gang vocals and a singback hook. Add sleigh-bell fills, candy-cane synth sparkles, and a final key-change feel. Crisp, shiny mix with a festive radio-ready bounce.",
"display_style": "pop, holiday",
"duration": 58.08
}
]
}执行完上面添加操作还需要执行导出操作，具体的操作如下：
json
{
"action": "concat",
"title":"Concat Audios",
"audio_id": "5a587bbb-cf28-4b4d-84a1-ed6d3378f6bc"
}运行得到如下结果:
json
{
"success": true,
"task_id": "ac70e44a-e582-43dc-bda1-8fb9fa8100da",
"trace_id": "18d2259b-fb15-4e72-91d3-7ce590c25d9f",
"data": [
{
"id": "028e12b8-90b6-46bc-baf8-c598c70fad7a",
"title": "圣诞快乐",
"image_url": "https://cdn2.suno.ai/image_028e12b8-90b6-46bc-baf8-c598c70fad7a.jpeg",
"lyric": "[Verse 1]\n窗上结着霜花\n你把围巾递给我\n门口那棵树\n亮得像一场梦\n桌上热奶茶\n还在冒着白雾\n我听见你笑\n就忘了天有多冷\n[Pre-Chorus]\n慢一点走\n别让夜太快\n把这一刻\n抱进怀里来\n手心的温度\n刚刚好\n像有人说\n新的一年会更好\n[Chorus]\n圣诞快乐，圣诞快乐\n把好消息都说一遍\n圣诞快乐，圣诞快乐\n今夜让笑容不熄灭\n圣诞快乐，圣诞快乐\n你在身边就很圆满\n圣诞快乐，圣诞快乐\n把这一年轻轻翻篇\n[Verse 2]\n街角卖糖果的摊\n还没收起灯串\n孩子们跑过来\n捧着红色气球\n你把苹果放我手里\n说要留个平安\n我看着你的眼睛\n像看见春天提前来\n[Pre-Chorus]\n慢一点走\n别让夜太快\n把这一刻\n抱进怀里来\n钟声敲一下\n心就亮一点\n原来幸福\n就在眼前\n[Chorus]\n圣诞快乐，圣诞快乐\n把好消息都说一遍\n圣诞快乐，圣诞快乐\n今夜让笑容不熄灭\n圣诞快乐，圣诞快乐\n你在身边就很圆满\n圣诞快乐，圣诞快乐\n把这一年轻轻翻篇\n[Bridge]\n如果路上有风雪\n就靠近一点\n如果心里有旧事\n就放到明天\n把没说完的话\n留给明年\n今晚只要\n你在我身边\n[Final Chorus]\n圣诞快乐，圣诞快乐\n把好消息都说一遍\n圣诞快乐，圣诞快乐\n今夜让笑容不熄灭\n圣诞快乐，圣诞快乐\n你在身边就很圆满\n圣诞快乐，圣诞快乐\n把这一年轻轻翻篇\n[Outro]\n圣诞快乐\n圣诞快乐",
"audio_url": "https://cdn1.suno.ai/028e12b8-90b6-46bc-baf8-c598c70fad7a.mp3",
"video_url": "",
"created_at": "2026-07-13T09:47:07.669Z",
"model": "chirp-crow",
"state": "succeeded",
"prompt": "圣诞节快乐",
"style": "Pop holiday anthem with mid-tempo four-on-the-floor pulse, jingle-bell percussion, warm piano and bright guitar strums; verse keeps it intimate with light bass and handclaps, pre-chorus lifts with stacked harmonies and rising strings, chorus opens wide with gang vocals and a singback hook. Add sleigh-bell fills, candy-cane synth sparkles, and a final key-change feel. Crisp, shiny mix with a festive radio-ready bounce.",
"display_style": "pop, holiday",
"duration": 163.24
},
{
"id": "da2edd10-4659-47a5-96fc-e2b358f07bc2",
"title": "圣诞快乐",
"image_url": "https://cdn2.suno.ai/image_da2edd10-4659-47a5-96fc-e2b358f07bc2.jpeg",
"lyric": "[Verse 1]\n窗上结着霜花\n你把围巾递给我\n门口那棵树\n亮得像一场梦\n桌上热奶茶\n还在冒着白雾\n我听见你笑\n就忘了天有多冷\n[Pre-Chorus]\n慢一点走\n别让夜太快\n把这一刻\n抱进怀里来\n手心的温度\n刚刚好\n像有人说\n新的一年会更好\n[Chorus]\n圣诞快乐，圣诞快乐\n把好消息都说一遍\n圣诞快乐，圣诞快乐\n今夜让笑容不熄灭\n圣诞快乐，圣诞快乐\n你在身边就很圆满\n圣诞快乐，圣诞快乐\n把这一年轻轻翻篇\n[Verse 2]\n街角卖糖果的摊\n还没收起灯串\n孩子们跑过来\n捧着红色气球\n你把苹果放我手里\n说要留个平安\n我看着你的眼睛\n像看见春天提前来\n[Pre-Chorus]\n慢一点走\n别让夜太快\n把这一刻\n抱进怀里来\n钟声敲一下\n心就亮一点\n原来幸福\n就在眼前\n[Chorus]\n圣诞快乐，圣诞快乐\n把好消息都说一遍\n圣诞快乐，圣诞快乐\n今夜让笑容不熄灭\n圣诞快乐，圣诞快乐\n你在身边就很圆满\n圣诞快乐，圣诞快乐\n把这一年轻轻翻篇\n[Bridge]\n如果路上有风雪\n就靠近一点\n如果心里有旧事\n就放到明天\n把没说完的话\n留给明年\n今晚只要\n你在我身边\n[Final Chorus]\n圣诞快乐，圣诞快乐\n把好消息都说一遍\n圣诞快乐，圣诞快乐\n今夜让笑容不熄灭\n圣诞快乐，圣诞快乐\n你在身边就很圆满\n圣诞快乐，圣诞快乐\n把这一年轻轻翻篇\n[Outro]\n圣诞快乐\n圣诞快乐",
"audio_url": "https://cdn1.suno.ai/da2edd10-4659-47a5-96fc-e2b358f07bc2.mp3",
"video_url": "",
"created_at": "2026-07-13T09:47:07.669Z",
"model": "chirp-crow",
"state": "succeeded",
"prompt": "圣诞节快乐",
"style": "Pop holiday anthem with mid-tempo four-on-the-floor pulse, jingle-bell percussion, warm piano and bright guitar strums; verse keeps it intimate with light bass and handclaps, pre-chorus lifts with stacked harmonies and rising strings, chorus opens wide with gang vocals and a singback hook. Add sleigh-bell fills, candy-cane synth sparkles, and a final key-change feel. Crisp, shiny mix with a festive radio-ready bounce.",
"display_style": "",
"duration": 141.44
}
]
}裁剪片段：对标Crop功能
只保留歌曲中的某一段，导出为新歌，请求参数如下：
参数说明
| 参数名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
crop_start | number | 是 | 保留区间起始秒 | 30 |
crop_end | number | 是 | 保留区间结束秒 | 90 |
json
{
"action": "crop",
"audio_id": "4e34ea5f-4a64-4529-9f92-cf82547a94cc",
"crop_start": 30,
"crop_end": 90,
"title": "Crop Section"
}得到如下结果：
json
{
"success": true,
"task_id": "3594e382-3108-4781-863a-c08e9a06c26c",
"trace_id": "d5c821d6-e795-4d5a-b74f-87d31618f656",
"data": [
{
"id": "012b7e5a-6b93-4d61-945e-bc92092ced35",
"title": "Crop Section",
"image_url": "https://cdn2.suno.ai/image_012b7e5a-6b93-4d61-945e-bc92092ced35.jpeg",
"lyric": "[Intro]\n[clean electric guitar arpeggios, piano, sleigh bells]\n[Verse 1]\n[male tenor vocals]\n安靜了 只剩下心在跳動\n你的手 一牽來 冬天就不一樣\n[Chorus]\n[full band enters, strings swell, vocal harmonies]\n聖誕節快樂 你在就快樂\n這一夜太亮 我只想看著你\n聖誕節快樂 抱緊就快樂\n雪落滿屋頂 也落在 我心裡\n[Verse 2]\n[drums continue, piano chords]\n聖誕節快樂\n聽你說真話 放在舊桌面上\n你把圍巾解開 掛在椅背旁\n窗外有人唱 聲音飄過圍牆\n我聽見你說 今年終於不忙\n[Pre-Chorus]\n[bass becomes more melodic]\n燭光輕輕跳著 照見你的側臉\n我忽然明白 想念也有期限\n[Chorus]\n[vocal harmonies, orchestral pads]\n聖誕節快樂 你在就快樂\n這一夜太亮 我只想看著你",
"audio_url": "https://cdn1.suno.ai/012b7e5a-6b93-4d61-945e-bc92092ced35.mp3",
"video_url": "",
"created_at": "2026-07-13T09:24:18.118Z",
"model": "chirp-chirp",
"state": "succeeded",
"style": "Mandopop holiday pop with upbeat four-on-the-floor bounce, bright acoustic guitar, sparkling bell accents, and buoyant synth bass; verse stays intimate and chatty, pre-chorus lifts with stacked harmonies and rising snare rolls, chorus opens wide with handclaps and gang vocals on the hook. Lead vocal is close-mic and warm, with doubled chorus lines, short delay throws, and playful ad-libs. Glassy chimes, reversed swells, and a final key-change feel keep the arrangement festive and radiant, mixed bright and punchy.",
"display_style": "Mandopop, holiday pop",
"duration": 59.9965
}
]
}删除片段：对标Delete功能
删除歌曲中的一个或多个区间，导出为新歌，请求参数如下：
参数说明
| 参数名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
close_gap | boolean | 是 | 默认 true：删除后后面内容前移收拢；false：留下空白 | true |
sections | object | 是 | 要删除的区间列表，每项含 start_s / end_s | 90 |
json
{
"action": "remove_section",
"audio_id": "4e34ea5f-4a64-4529-9f92-cf82547a94cc",
"sections": [
{
"remove_section_start": 30,
"remove_section_end": 40
},
{
"remove_section_start": 60,
"remove_section_end": 80
}
],
"close_gap": true,
"title": "Remove Section"
}运行得到如下结果：
json
{
"success": true,
"task_id": "3ee56cee-88ae-4ce4-ab54-12afb9a2ebc3",
"trace_id": "67d79171-7e21-42f6-99ba-41d9b5e660e2",
"data": [
{
"id": "739561c2-0291-486e-a372-521e55e640af",
"title": "Remove Section",
"image_url": "https://cdn2.suno.ai/image_739561c2-0291-486e-a372-521e55e640af.jpeg",
"lyric": "[Intro]\n[acoustic guitar strumming, sleigh bells, shaker]\nYa da da da da\nYa da da da da da da\nAi ai\n[Verse 1]\n[female vocals, acoustic guitar, upright bass]\n窗上貼著雪花 門口掛著紅襪\n穿上熱騰騰你剛好回家\n圍巾還帶風沙 雪落在了眉毛\n我把燈點亮等你說一句話\n[Pre-Chorus]\n[clean electric guitar fills]\n街角都開滿了花 像在說聖誕快樂\n這世界再大 只要有你就不怕\n[Chorus]\n[full drums enter, male backing vocals]\n聖誕節快樂 你在就快樂\n這一夜太亮 我只想看著你\n聖誕節快樂 抱緊就快樂\n雪落滿屋頂也落進我心裡\n聖誕節快樂 你在就快樂\n這一夜太亮 我只想看著你\n聖誕節快樂 抱緊就快樂\n雪落滿屋頂也落進我心裡\n[Verse 2]\n[drums drop out, acoustic guitar and bass continue]\n[male vocals]\n如果世界太冷就往我這兒邊靠\n如果路太長我陪你慢慢跑\n把煩惱放下 把今天收好\n當鐘聲響起是你先對我笑\n[Chorus]\n[full band re-enters]\n聖誕節快樂 你在就快樂\n這一夜太亮 我只想看著你\n聖誕節快樂 抱緊就快樂\n雪落滿屋頂也落進我心裡\n聖誕節快樂 一直都快樂\n你在我身邊就是最好禮物\n[Outro]\n[acoustic guitar, sleigh bells fade]\nWu wu wu\n[final acoustic guitar chord]",
"audio_url": "https://cdn1.suno.ai/739561c2-0291-486e-a372-521e55e640af.mp3",
"video_url": "",
"created_at": "2026-07-13T09:39:02.305Z",
"model": "chirp-chirp",
"state": "succeeded",
"style": "Mandopop holiday pop with upbeat four-on-the-floor bounce, bright acoustic guitar, sparkling bell accents, and buoyant synth bass; verse stays intimate and chatty, pre-chorus lifts with stacked harmonies and rising snare rolls, chorus opens wide with handclaps and gang vocals on the hook. Lead vocal is close-mic and warm, with doubled chorus lines, short delay throws, and playful ad-libs. Glassy chimes, reversed swells, and a final key-change feel keep the arrangement festive and radiant, mixed bright and punchy.",
"display_style": "Mandopop, holiday pop",
"duration": 129.6818125
}
]
}复制片段：对标Duplicate功能
把歌曲中的某一段复制到指定位置，导出为新歌，请求参数如下：
参数说明
| 参数名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
duplicate_section_start | number | 是 | 要复制的区间起始秒 | 30 |
duplicate_section_end | number | 是 | 要复制的区间结束秒 | 90 |
continue_at | number | 否 | 插入位置（秒）；不传则默认紧跟选区结尾 | 90 |
json
{
"action": "duplicate_section",
"audio_id": "4e34ea5f-4a64-4529-9f92-cf82547a94cc",
"duplicate_section_start": 30,
"duplicate_section_end": 40,
"continue_at": 60,
"title": "Duplicate Section"
}运行得到如下结果：
json
{
"success": true,
"task_id": "bfddd54e-eedc-4146-9caf-973eb8b8f11e",
"trace_id": "54d2b492-57a9-46df-aa14-9d0eb02bc27e",
"data": [
{
"id": "875b3800-d949-4ade-8d0e-9d2f5739e214",
"title": "Duplicate Section",
"image_url": "https://cdn2.suno.ai/image_875b3800-d949-4ade-8d0e-9d2f5739e214.jpeg",
"lyric": "[Intro]\n[clean electric guitar arpeggios, sleigh bells, synth bells]\n(Ya-da-da-da-da)\n(Ya-ya-ya-ya-ya-ya-ya-i-ya)\n[Verse 1]\n[acoustic piano enters, soft percussion]\n窗上貼著雪花 門口掛著紅襪\n爐上熱著湯 你剛好回來家\n圍巾還帶風沙 雪落在睫毛\n我把燈點亮 對你說一句好\n[Pre-Chorus]\n[bass guitar enters, building drums]\n街道都安靜了 只剩心在發燙\n你的手一牽來 冬天就不一樣\n[Chorus]\n[full band, driving pop-rock beat, sleigh bells]\n聖誕節快樂 你在就快樂\n這一夜太亮 我只想看著你\n聖誕節快樂 抱緊就快樂\n雪落滿屋頂 也落進我心裡\n[Verse 2]\n[drums drop to half-time, piano melody]\n聽些真話 放在桌子滿上\n你把圍巾解開 掛在椅背旁\n窗外有人唱 聲音飄過煙囪\n我聽見你說 今年終於不忙\n[Pre-Chorus]\n[strings swell, building percussion]\n火苗輕輕跳著 照見你的側臉\n我忽然明白 想念也有期限\n[Chorus]\n[full band, energetic drums]\n聖誕節快樂 你在就快樂\n這一夜太亮 我只想看著你\n聖誕節快樂 抱緊就快樂\n雪落滿屋頂 也落進我心裡\n[Bridge]\n[electric guitar power chords, piano stabs]\n如果世界太冷 就往我這邊靠\n如果路太長 我陪你慢慢跑\n把煩惱放下 把緊握手好\n等鐘聲響起 我先對你笑 [vocal crescendo]\n(Oh-oh-oh)\n[Chorus]\n[full band, high energy]\n聖誕節快樂 你在就快樂\n這一夜太亮 我只想看著你\n聖誕節快樂 抱緊就快樂\n雪落滿屋頂 也落進我心裡\n[Outro]\n[sleigh bells, piano melody, guitar fades]\n聖誕節快樂 一直都快樂\n你在我身邊 就是最好禮物\n(Ooh-ooh-ooh)",
"audio_url": "https://cdn1.suno.ai/875b3800-d949-4ade-8d0e-9d2f5739e214.mp3",
"video_url": "",
"created_at": "2026-07-13T09:45:03.249Z",
"model": "chirp-chirp",
"state": "succeeded",
"style": "Mandopop holiday pop with upbeat four-on-the-floor bounce, bright acoustic guitar, sparkling bell accents, and buoyant synth bass; verse stays intimate and chatty, pre-chorus lifts with stacked harmonies and rising snare rolls, chorus opens wide with handclaps and gang vocals on the hook. Lead vocal is close-mic and warm, with doubled chorus lines, short delay throws, and playful ad-libs. Glassy chimes, reversed swells, and a final key-change feel keep the arrangement festive and radiant, mixed bright and punchy.",
"display_style": "Mandopop, holiday pop",
"duration": 169.67964583333332
}
]
}批量编辑：对标Editor精修功能
本接口可以实现对一首歌进行多次更精细化的操作，比如：crop (剪裁保留)、removeSection (删除区间)、duplicate (复制粘贴)、split (切分)、reverse (倒放)、fadeIn (淡入)、fadeOut (淡出)、setSpeed (变速) 八种精细化操作（注意：replace、add_section、concat三种必须独立执行，如果放进ops会出现异常报错），请求参数如下：
参数说明
| 参数名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
ops | list | 是 | 编辑操作的ops数组 | 如下 |
beat | object | 否 | 节拍器的配置选项，如果不传表示不启用节拍器，反之是启用 | 如下 |
audio_id | string | 是 | 要编辑的歌曲ID | 如下 |
title | string | 否 | 歌曲标题 | Edit |
beat参数规范
json
{
"beat": {
"enabled": true,
"bpm": 132,
"time_signature": "4/4"
}
}| 字段 | 必填 | 默认 | 说明 |
|---|---|---|---|
beat | 否 | 不传 | 不传或 enabled≠true → 旧逻辑，无节拍声 |
beat.enabled | 是 | — | true = 打开节拍网格 + 可听节拍器 |
beat.bpm | 否 | 工程/源曲推算 | 目标 BPM，范围 30～480 |
beat.time_signature | 否 | "4/4" | 拍号，格式 "N/D"（如 "3/4"） |
ops参数规范
1. 核心设计原则
ops 是所有操作的通用 DTO 结构，但每个操作有其特定的专属字段：
- 按需传输：只传递各
op声明需要的字段。 - 忽略多余字段：后台仅解析指定
op对应的可用字段，传入的无关字段将被自动忽略。 - 禁止默认填充：不要为了补齐 DTO 把无关字段默认填成
0提交，这会导致校验逻辑混乱。
2. 字段 × 操作映射表
| 字段名 | 含义 | crop | removeSection | duplicate | split | reverse | fadeIn | fadeOut | setSpeed |
|---|---|---|---|---|---|---|---|---|---|
op | 操作类型 | ✓ 必填 | ✓ 必填 | ✓ 必填 | ✓ 必填 | ✓ 必填 | ✓ 必填 | ✓ 必填 | ✓ 必填 |
start_s | 起点时间（秒） | ✓ 必填 | — | ✓ 必填 | — | ○ 双选 | ✓ 必填 | ✓ 必填 | ○ 双选 |
end_s | 终点时间（秒） | ✓ 必填 | — | ✓ 必填 | — | ○ 双选 | ○ 互斥 | ○ 可选 | ○ 双选 |
insert_at_s | 粘贴点（秒） | — | — | ○ 可选 | — | — | — | — | — |
at_s | 剪切点（秒） | — | — | — | ✓ 必填 | — | — | — | — |
sections | 删除区间列表 | — | ✓ 必填 | — | — | — | — | — | — |
close_gap | 删后是否收拢时间线 | — | ○ 可选 | — | — | — | — | — | — |
rate | 速度倍率 | — | — | — | — | — | — | — | ✓ 必填 |
duration_s | 淡入持续时间（秒） | — | — | — | — | — | ○ 互斥 | — | — |
图例说明：
✓ 必填：该操作下此字段不可缺失。○ 可选：该操作下此字段支持缺省。○ 双选：此项与其他字段（如start_s与end_s）必须成对出现（要么都传，要么都不传）。○ 互斥：二选一传参（例如duration_s与end_s互斥，至多只能传一个）。— 无效：不属于该操作的有效字段，传入会被系统直接忽略。
3. 字段类型及验证明细
所有的秒数（如 start_s、end_s、at_s 等）均相对于当前步骤开始前的时间线。
| 字段名称 | 数据类型 | 验证规则 / 详细说明 |
|---|---|---|
op | string | 本步操作枚举值，限：crop, removeSection, duplicate, split, reverse, fadeIn, fadeOut, setSpeed。 |
start_s | number | 时间线起点秒数。必须 $\ge 0$。对应不同 op 的表现：• crop: 保留起点• duplicate: 复制源起点• reverse/setSpeed: 作用区起点• fadeIn/fadeOut: 音量开始渐变的位置 |
end_s | number | 时间线终点秒数。必须满足 end_s > start_s。 |
insert_at_s | number | 【仅用于 duplicate】 粘贴位置。必须 $\ge 0$。如果不传，默认值为 end_s（即紧跟复制区尾部，等同于网页端 "Duplicate"）。 |
at_s | number | 【仅用于 split】 剪切点位置。必须 $\ge 0$。在此处断开时间线为两个 arrangement，音频内容不受损。 |
sections | Array<Object> | 【仅用于 removeSection】 需要切除的区间列表。非空数组。结构：[{ "start_s": number, "end_s": number }]，且每组必须满足 end_s > start_s。 |
close_gap | boolean | 【仅用于 removeSection】 是否收拢时间线。 • true（默认值）：删除该段，右侧音频自动左移靠拢（涟漪删除）。• false：删除该段后原位留空（静音），总时长不缩短。 |
rate | number | 【仅用于 setSpeed】 播放倍率。允许取值范围：[0.5, 2.0]（例如：1.1 代表加速 10%，0.8 代表降速 20%）。 |
duration_s | number | 【仅用于 fadeIn】 淡入时长。必须 $> 0$。与 end_s 互斥二选一。若两者皆不传，则缺省默认为 2 秒。 |
4. 各 op 示例说明
4.1 crop (剪裁保留)
- 作用：只保留指定区间，其余两头的部分全数丢弃。
- 参数条件：
start_s且end_s必填，end_s > start_s。
json
{ "op": "crop", "start_s": 10, "end_s": 90 }4.2 removeSection (删除区间)
- 作用：挖去一条或多条时间线上的部分。
- 参数条件：
sections必填且非空。close_gap缺省为true。
json
{
"op": "removeSection",
"sections": [
{ "start_s": 40, "end_s": 48 },
{ "start_s": 90, "end_s": 95 }
],
"close_gap": true
}4.3 duplicate (复制粘贴)
- 作用：将
[start_s, end_s)范围的音频复制并插在insert_at_s位置。 - 参数条件：
start_s与end_s必填。insert_at_s选填。
json
{ "op": "duplicate", "start_s": 20, "end_s": 28, "insert_at_s": 50 }4.4 split (切分)
- 作用：在
at_s点将一轨切分为前后两段独立的 arrangement。无音频丢失。 - 参数条件：
at_s必填且 $\ge 0$。
json
{ "op": "split", "at_s": 45 }4.5 reverse (倒放)
- 作用：对指定区间或整曲进行音频倒放。
- 参数条件：
start_s与end_s必须同传或同不传。若不传，代表整曲倒放。
json
// 示例 A：整曲倒放
{ "op": "reverse" }
// 示例 B：片段倒放 (15秒区间)
{ "op": "reverse", "start_s": 30, "end_s": 45 }4.6 fadeIn (淡入)
- 作用：实现音频渐显效果。
- 参数条件：
start_s必填。end_s和duration_s只能最多存在一个。
json
// 示例 A：用时长（duration）决定淡入，持续2s
{ "op": "fadeIn", "start_s": 0, "duration_s": 2 }
// 示例 B：用终点（end_s）决定淡入，到第3s完成
{ "op": "fadeIn", "start_s": 0, "end_s": 3 }4.7 fadeOut (淡出)
- 作用：实现音频渐隐效果。
- 参数条件：
start_s必填。end_s选填，若不填默认淡出一直持续到音频结尾。
json
{ "op": "fadeOut", "start_s": 80 }4.8 setSpeed (变速)
- 作用：调整区间或整曲的播放速度。
- 参数条件：
rate必填。区域坐标start_s与end_s必须成对出现，若不填代表整曲变速。
json
// 示例 A：整曲加速 10%
{ "op": "setSpeed", "rate": 1.1 }
// 示例 B：指定区间减速 10%
{ "op": "setSpeed", "rate": 0.9, "start_s": 20, "end_s": 40 }以下是一个具体的示例，请求参数如下：
json
{
"action": "batch_edit",
"audio_id": "c5246b1f-52dd-4add-ab85-ed3a017fadcd",
"ops": [
{
"op": "reverse"
},
{
"op": "setSpeed",
"rate": 1.1
},
{
"op": "fadeOut",
"start_s": 80
},
{
"op": "duplicate",
"start_s": 20,
"end_s": 28,
"insert_at_s": 50
}
],
"beat": {
"enabled": true
},
"title": "Batch Edit Song"
}注意，这个批量操作是根据ops的列表元素顺序进行执行的（不能设置一些不合理的顺序，要不然会报异常错误），运行的结果如下：
json
{
"success": true,
"task_id": "16a1e7da-35bf-4c0d-9f39-d1228fe99374",
"trace_id": "19649ab3-b1af-4e6f-bbb4-a8b080ead76b",
"data": [
{
"id": "b02e6f66-f8dd-4e15-8faa-4a60ffe1499d",
"title": "圣诞节快乐 (Edit)",
"image_url": "https://cdn2.suno.ai/image_b02e6f66-f8dd-4e15-8faa-4a60ffe1499d.jpeg",
"lyric": "[Intro]\n[acoustic guitar strumming, sleigh bells, light synth pads]\n(Um yeah)\n(Da-da-da-da-da-da-da-da-da-da-da-da-da-da-da-da-da-da-da-da-da-da-da-da)\n[Verse 1]\n[acoustic guitar, bass, and light percussion]\n穿上有一點雙泥巴圍巾遞給我\n熱呼呼冒著香氣桌上放著紅蘋果 (Um)\n門口那串小燈一閃一閃像在笑語盈盈\n你說今晚別著急慢慢把心事收好\n[Pre-Chorus]\n[drums enter, electric guitar fills]\n接著傳來就是人群都在回家我聽見你的名字在空氣裡發芽\n這一晚多安靜雪都放晴了我把所有祝福都留給你呀 (Hey)\n[Chorus]\n[full band, driving rhythm]\n聖誕節快樂 聖誕節快樂\n把你的笑放大 把煩惱都放下\n聖誕節快樂 聖誕節快樂\n今夜只要你在就已經很好了\n聖誕節快樂 (Yeah)\n[Verse 2]\n[bass and drums continue, clean electric guitar arpeggios]\n你把禮物帶放下面是一本舊畫冊\n第一頁寫著願望自己有點笨拙\n我們坐在窗邊看雪落滿屋簷\n你說今年很辛苦我說辛苦也會甜\n[Pre-Chorus]\n[acoustic guitar and electric guitar layers]\n烤箱裡擁抱慢慢鼓起暖黃色你靠著我的肩膀像靠著一座山\n這一晚多難得連時光都變軟了我把所有溫柔都唱給你聽呀 (Hey)\n[Chorus]\n聖誕節快樂 聖誕節快樂\n把你的笑放大 把煩惱都放下\n聖誕節快樂 聖誕節快樂\n今夜只要你在就已經很好了\n[Bridge]\n[half-time feel, piano chords enter]\n如果明天會遠就讓今晚些亮著\n如果世界太吵就把門輕輕關上\n我只要你回頭我就不會迷路\n這一句簡單的話 我想說很多次\n[Chorus]\n[full energy, sleigh bells prominent]\n聖誕節快樂 聖誕節快樂\n把你的笑放大 把煩惱都放下\n聖誕節快樂 聖誕節快樂\n今夜只要你在就已經很好了\n[Outro]\n[acoustic guitar fades, light synth pads]\n聖誕節快樂 (把你的笑放大)\n聖誕節快樂 (把煩惱都放下)\n聖誕節快樂",
"audio_url": "https://cdn1.suno.ai/b02e6f66-f8dd-4e15-8faa-4a60ffe1499d.mp3",
"video_url": "",
"created_at": "2026-07-16T13:13:15.239Z",
"model": "chirp-chirp",
"state": "succeeded",
"style": "Mandopop with a bright mid-tempo four-on-the-floor groove, playful handclaps, chiming bells, and bouncing bass; verse stays intimate with light piano and finger snaps, pre-chorus lifts with stacked harmonies and rising strings, chorus opens wide with gang vocals on the hook phrase and short delay throws on the last word. Add a toy-box glockenspiel turnarounds, snowy synth swells into the chorus, and a final key change feel. Crisp, glossy, festive mix with a warm close-mic lead vocal.",
"display_style": "Mandopop, pop",
"duration": 153.10575
}
]
}异步回调
由于 Suno 生成音乐的时间相对较长，大约需要 1-2 分钟，如果 API 长时间无响应，HTTP 请求会一直保持连接，导致额外的系统资源消耗，所以本 API 也提供了异步回调的支持。
整体流程是：客户端发起请求的时候，额外指定一个 callback_url 字段，客户端发起 API 请求之后，API 会立马返回一个结果，包含一个 task_id 的字段信息，代表当前的任务 ID。当任务完成之后，生成音乐的结果会通过 POST JSON 的形式发送到客户端指定的 callback_url，其中也包括了 task_id 字段，这样任务结果就可以通过 ID 关联起来了。
下面我们通过示例来了解下具体怎样操作。
首先，Webhook 回调是一个可以接收 HTTP 请求的服务，开发者应该替换为自己搭建的 HTTP 服务器的 URL。此处为了方便演示，使用一个公开的 Webhook 样例网站 https://webhook.site/，打开该网站即可得到一个 Webhook URL，如图所示：
将此 URL 复制下来，就可以作为 Webhook 来使用，此处的样例为 https://webhook.site/03e60575-3d96-4132-b681-b713d78116e2。
接下来，我们可以设置字段 callback_url 为上述 Webhook URL，同时填入 prompt，如图所示：
点击运行，可以发现会立即得到一个结果，如下：
{
"task_id": "44472ab8-783b-4054-b861-5bf14e462f60"
}稍等片刻，我们可以在 https://webhook.site/03e60575-3d96-4132-b681-b713d78116e2 上观察到生成歌曲的结果，如图所示：
内容如下：
json
{
"success": true,
"task_id": "44472ab8-783b-4054-b861-5bf14e462f60",
"data": [
{
"id": "da4324e5-84b2-484b-b0e9-dd261381c594",
"title": "Winter Whispers",
"image_url": "https://cdn1.suno.ai/image_da4324e5-84b2-484b-b0e9-dd261381c594.png",
"lyric": "[Verse]\nSnow falling gently from the sky\nChildren giggling as they pass by\nFire crackling\nCozy and warm\nChristmas spirit begins to swarm\n[Verse 2]\nTwinkling lights\nA sight to behold\nStockings hung\nWaiting to be filled with gold\nGifts wrapped with love\nPiled high\nExcitement in the air\nYou can't deny\n[Chorus]\nWinter whispers in the wind\nJoy and love it brings\nLet's celebrate this season\nWith the ones we're missing",
"audio_url": "https://cdn1.suno.ai/da4324e5-84b2-484b-b0e9-dd261381c594.mp3",
"video_url": "https://cdn1.suno.ai/da4324e5-84b2-484b-b0e9-dd261381c594.mp4",
"created_at": "2024-05-11T07:33:05.430Z",
"model": "chirp-v3",
"prompt": "A song for Christmas",
"style": "pop"
},
{
"id": "b878a87b-a0db-4046-8ccd-ecd2fb3d4372",
"title": "Winter Whispers",
"image_url": "https://cdn1.suno.ai/image_b878a87b-a0db-4046-8ccd-ecd2fb3d4372.png",
"lyric": "[Verse]\nSnow falling gently from the sky\nChildren giggling as they pass by\nFire crackling\nCozy and warm\nChristmas spirit begins to swarm\n[Verse 2]\nTwinkling lights\nA sight to behold\nStockings hung\nWaiting to be filled with gold\nGifts wrapped with love\nPiled high\nExcitement in the air\nYou can't deny\n[Chorus]\nWinter whispers in the wind\nJoy and love it brings\nLet's celebrate this season\nWith the ones we're missing",
"audio_url": "https://cdn1.suno.ai/b878a87b-a0db-4046-8ccd-ecd2fb3d4372.mp3",
"video_url": "https://cdn1.suno.ai/b878a87b-a0db-4046-8ccd-ecd2fb3d4372.mp4",
"created_at": "2024-05-11T07:33:05.430Z",
"model": "chirp-v3",
"prompt": "A song for Christmas",
"style": "pop"
}
]
}可以看到结果中有一个 task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。
相关错误码信息
下面是有关错误码列表：
| 状态码 | error.code | error.message |
|---|---|---|
| 400 | bad_request | Prompt too long. |
| 400 | bad_request | Tags too long. |
| 400 | bad_request | Title too long. |
| 403 | forbidden | The audio you upload is recognized by suno's copyright detection system as similar to an existing copyrighted work. |
| 403 | forbidden | Tags contained artist name: xxx |
| 403 | forbidden | Song Description contained artist name: xxx |
| 403 | forbidden | Tags contained artist name: xxx |
| 403 | forbidden | Lyrics contained producer tag: xxx |
| 403 | forbidden | Lyrics contained copyrighted material |
| 403 | forbidden | This song doesn't exist or has been taken offline. |
| 403 | forbidden | The relevant account has been taken offline because the song was generated too long ago. |
| 403 | forbidden | The current song does not currently support xxx. |
| 500 | api_error | GENERATE_FROM_UPLOAD_FAILED:{\"detail\":\"Insufficient credits.\"}(相关账号积分用完了) |
| 500 | api_error | The current internal service is abnormal. Consult the administrator according to trace_id. |
| 500 | api_error | The current task queue is too long. Please submit the task later.（请求频率过快） |
| 504 | timeout | timeout while waiting for audio generation |
