Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有音频。提交表单以生成音频。
探索不同用例和参数配置
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
Suno extend musicSuno | Starter | 1per run | $0.005 | - | - |
Suno 使用完整指南
无缝续写现有 AI 生成歌曲，添加新的段落，同时保持音乐连贯性。
Suno V5_5 Extension API 可用于扩展此前通过 Suno V5_5 生成的歌曲。借助此功能，你可以从原曲的任意位置无缝续写并添加新段落，创作更长的音乐作品。无论你想增加一段主歌、延长尾奏，还是铺陈出高潮结尾，扩展 API 都能在生成新内容的同时，保持原曲的音乐风格、调性、速度和整体氛围。
让 AI 使用原始参数自动续写歌曲。非常适合快速扩展，并与源音轨保持高度一致。
通过指定起始点、新提示词、风格和标题来掌控扩展过程。适合对歌曲的发展和演变方式进行创意控制。
扩展内容会自然融入原始音轨，匹配速度、调性和风格，生成听感专业的更长作品。
精确选择扩展开始的位置。可以从结尾继续、与尾奏重叠，或从歌曲中的任意时刻分支延展。
保持原有风格，或通过自定义参数让风格逐步演变。可以增强能量、过渡到不同情绪，或加入新的音乐元素。
可多次扩展歌曲，创作史诗级长度的音轨。每次扩展都可以继续延展，从而构建复杂的歌曲结构。
只需几个简单步骤，即可扩展你的 AI 生成歌曲
首先，使用 suno/generate API 创建一首歌曲。记下响应中你想要扩展的音轨对应的 audio ID。
在自动扩展（使用原始参数）和自定义扩展（使用你自己的参数）之间做出选择。
对于自定义扩展，请以秒为单位指定 continueAt 时间，即扩展应开始的位置。
使用 audio ID 和你选择的参数调用 API。扩展内容将从你指定的位置无缝生成。
获取扩展后的音频文件。结果会将原始内容与新扩展内容合成为一条完整音轨。
遵循这些建议，实现无缝的歌曲扩展
从自然过渡点开始扩展，例如乐句结尾、副歌之后或器乐间奏中，可获得最顺滑的效果。
在自定义模式下，描述音乐应如何演进——增强能量、加入乐器、过渡到桥段，或逐渐收束进入尾奏。
使用自定义参数时，保持与原曲相近的风格可获得更连贯的结果；也可以有意制造对比，形成更具动态感的过渡。
通过扩展初始生成结果，创作完整的 4-5 分钟歌曲，非常适合商业音乐制作。
扩展音轨并生成适合 DJ 混音、现场演出和加长舞曲版本的变化段落。
通过串联扩展，为视频、游戏和多媒体项目构建更长的背景音乐作品。
从不同位置出发，并使用不同风格进行扩展，创作歌曲的替代版本。
可与 suno/generate 生成的音轨完美配合。原始生成和扩展使用相同的 API key 与工作流。
无需重新生成整首歌曲，即可创作更长作品。扩展会根据生成的新内容合理计费。
扩展内容保持与原始 Suno V5_5 生成结果同样的高质量，并实现无缝的音频衔接。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
使用 SDK 创建任务，保存返回的 taskId，并获取 Suno 的结果。
运行这些 SDK 示例前，请先安装 @apipass-dev/apipass-sdk。
1npm install @apipass-dev/apipass-sdk
2# or
3pnpm add @apipass-dev/apipass-sdk
4# or
5yarn add @apipass-dev/apipass-sdk请将 API Key 保存在服务端环境变量中。SDK 会自动以 Bearer token 发送，并添加 JSON 请求头。
client.jobs.createTask创建一个新任务，用于扩展现有的 Suno V5 生成歌曲
通过这个示例快速上手所选语言的 SDK。
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const task = await client.jobs.createTask({
8 "model": "suno/extend",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "audioId": "abc123-def456-ghi789",
12 "continueAt": 120,
13 "prompt": "Build up to a powerful chorus with harmonies and drums",
14 "style": "Pop Rock, Uplifting, Anthemic",
15 "title": "Rise Again (Extended)"
16 }
17});
18
19console.log(task.data.taskId);该 API 接受具有以下结构的 JSON 负载：
1{
2 "model": "suno/extend",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 | V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "audioId": "string (required)",
7 "instrumental": "boolean",
8 "continueAt": "integer",
9 "prompt": "string",
10 "style": "string",
11 "title": "string",
12 "personaId": "string",
13 "negativeTags": "string",
14 "styleWeight": "number",
15 "weirdnessConstraint": "number",
16 "audioWeight": "number"
17 },
18 "channel": "auto"
19}model必填string用于 Suno V5 扩展的模型标识符
"suno/extend"
callBackUrl可选string扩展完成时用于接收 webhook 通知的 URL
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 中对应的服务商；这些服务商负责实际的图像和视频生成任务。APIPASS 目前提供三种服务商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用服务商之间自动分配任务，以平衡最低成本与可靠性能。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
用于扩展现有歌曲的参数：
input.model_version可选string要使用的 Suno 模型版本。默认为 V5（最新）。
可用选项：
"V5"
input.audioId必填string要扩展的源音频轨道 ID。可从此前 suno/v5 生成任务的结果中获取。
"abc123-def456-ghi789"
input.instrumental可选boolean生成不含人声的纯音乐扩展。
false
input.continueAt必填integer开始扩展的时间点，单位为秒。必填
必须 > 0
120
input.prompt必填string对扩展段落的描述。
V4：最多 3000 个字符 V5_5、V5、V4_5PLUS、V4_5ALL、V4_5：最多 5000 个字符
"Build up to a powerful chorus with harmonies"
input.style必填string扩展所使用的音乐风格。必填
V4：最多 200 个字符 V5_5、V5、V4_5PLUS、V4_5ALL、V4_5：最多 1000 个字符
"Pop Rock, Uplifting"
input.title可选string扩展后音轨的标题。必填
最大长度：80 个字符
"Rise Again (Extended)"
input.vocalGender可选string扩展所使用的人声性别。
可用选项：
"f"
input.personaId可选string生成歌曲所使用的 Persona ID。
仅在 customMode=true 时生效。
"1234567890"
input.negativeTags可选string在生成中需要排除的风格或特征。
仅在 customMode=true 时生效。
"aggressive, heavy metal, screaming"
input.styleWeight可选number遵循风格的严格程度。范围：0.0-1.0
仅在 customMode=true 时生效。customMode=false 时将被忽略。取值为 0.00 到 1.00 之间的数字。必须以 0.01 为步进。不接受布尔值。
0.5
input.weirdnessConstraint可选number控制创意程度。值越高，生成结果越具实验性。范围：0.0-1.0
仅在 customMode=true 时生效。customMode=false 时将被忽略。取值为 0.00 到 1.00 之间的数字。必须以 0.01 为步进。不接受布尔值。
0.3
input.audioWeight可选number生成时音频影响的权重。范围：0.0-1.0
仅在 customMode=true 时生效。customMode=false 时将被忽略。取值为 0.00 到 1.00 之间的数字。必须以 0.01 为步进。不接受布尔值。
0.5
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_extend_xyz789"
6 }
7}code状态码，200 表示成功
message响应消息
data.taskId用于查询扩展状态的任务 ID
扩展完成后，会向你的 callBackUrl 发送一个 POST 请求
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_extend_xyz789",
5 "state": "success",
6 "completeTime": 1755599700000,
7 "costTime": 50000,
8 "model": "suno/extend",
9 "resultJson": {
10 "data": [
11 {
12 "id": "audio_ext_001",
13 "audio_url": "https://cdn.apipass.dev/results/task_extend_xyz789_0_audio.mp3",
14 "image_url": "https://cdn.apipass.dev/results/task_extend_xyz789_0_cover.jpeg",
15 "duration": 240.5
16 }
17 ]
18 }
19 },
20 "msg": "Extension completed successfully."
21}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_extend_xyz789",
5 "state": "fail",
6 "failCode": "INVALID_AUDIO_ID",
7 "failMsg": "Source audio ID not found or expired"
8 },
9 "msg": "Extension failed."
10}client.jobs.recordInfo查询扩展任务状态并获取结果
通过这个示例快速上手所选语言的 SDK。
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const result = await client.jobs.recordInfo("task_extend_xyz789");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_extend_xyz789",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "audio_ext_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_extend_xyz789_0_audio.mp3",
11 "image_url": "https://cdn.apipass.dev/results/task_extend_xyz789_0_cover.jpeg",
12 "duration": 240.5
13 }
14 ]
15 }
16 }
17}data.state当前状态：queuing、generating、success 或 fail
data.resultJson.data包含扩展后音频轨道的数组，提供 URL 和元数据
API 页面显示参数架构，但 Suno 还有几个特定于业务的模式组合和回调规则，容易被忽略。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
创建一个新任务，用于扩展现有的 Suno V5 生成歌曲
该 API 接受具有以下结构的 JSON 负载：
1{
2 "model": "suno/extend",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 | V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "audioId": "string (required)",
7 "instrumental": "boolean",
8 "continueAt": "integer",
9 "prompt": "string",
10 "style": "string",
11 "title": "string",
12 "personaId": "string",
13 "negativeTags": "string",
14 "styleWeight": "number",
15 "weirdnessConstraint": "number",
16 "audioWeight": "number"
17 },
18 "channel": "auto"
19}model必填string用于 Suno V5 扩展的模型标识符
"suno/extend"
callBackUrl可选string扩展完成时用于接收 webhook 通知的 URL
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 中对应的服务商；这些服务商负责实际的图像和视频生成任务。APIPASS 目前提供三种服务商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用服务商之间自动分配任务，以平衡最低成本与可靠性能。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
用于扩展现有歌曲的参数：
input.model_version可选string要使用的 Suno 模型版本。默认为 V5（最新）。
可用选项：
"V5"
input.audioId必填string要扩展的源音频轨道 ID。可从此前 suno/v5 生成任务的结果中获取。
"abc123-def456-ghi789"
input.instrumental可选boolean生成不含人声的纯音乐扩展。
false
input.continueAt必填integer开始扩展的时间点，单位为秒。必填
必须 > 0
120
input.prompt必填string对扩展段落的描述。
V4：最多 3000 个字符 V5_5、V5、V4_5PLUS、V4_5ALL、V4_5：最多 5000 个字符
"Build up to a powerful chorus with harmonies"
input.style必填string扩展所使用的音乐风格。必填
V4：最多 200 个字符 V5_5、V5、V4_5PLUS、V4_5ALL、V4_5：最多 1000 个字符
"Pop Rock, Uplifting"
input.title可选string扩展后音轨的标题。必填
最大长度：80 个字符
"Rise Again (Extended)"
input.vocalGender可选string扩展所使用的人声性别。
可用选项：
"f"
input.personaId可选string生成歌曲所使用的 Persona ID。
仅在 customMode=true 时生效。
"1234567890"
input.negativeTags可选string在生成中需要排除的风格或特征。
仅在 customMode=true 时生效。
"aggressive, heavy metal, screaming"
input.styleWeight可选number遵循风格的严格程度。范围：0.0-1.0
仅在 customMode=true 时生效。customMode=false 时将被忽略。取值为 0.00 到 1.00 之间的数字。必须以 0.01 为步进。不接受布尔值。
0.5
input.weirdnessConstraint可选number控制创意程度。值越高，生成结果越具实验性。范围：0.0-1.0
仅在 customMode=true 时生效。customMode=false 时将被忽略。取值为 0.00 到 1.00 之间的数字。必须以 0.01 为步进。不接受布尔值。
0.3
input.audioWeight可选number生成时音频影响的权重。范围：0.0-1.0
仅在 customMode=true 时生效。customMode=false 时将被忽略。取值为 0.00 到 1.00 之间的数字。必须以 0.01 为步进。不接受布尔值。
0.5
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "suno/extend",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "audioId": "abc123-def456-ghi789",
9 "continueAt": 120,
10 "prompt": "Build up to a powerful chorus with harmonies and drums",
11 "style": "Pop Rock, Uplifting, Anthemic",
12 "title": "Rise Again (Extended)"
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_extend_xyz789"
6 }
7}code状态码，200 表示成功
message响应消息
data.taskId用于查询扩展状态的任务 ID
