Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有音频。提交表单以生成音频。
探索不同用例和参数配置
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
Suno cover musicSuno | Starter | 1per run | $0.005 | - | - |
Suno 使用完整指南
将任意歌曲转换为全新风格——使用 AI 驱动的音乐重制能力，创作爵士、原声、电子或任意流派的翻唱版本。
Suno V5_5 Cover API 支持你上传任意音频文件，并由 AI 将其重制为完全不同的音乐风格。无论你想把摇滚歌曲改编成柔和爵士版本，将流行曲转换为原声抒情歌，还是为古典作品创作 EDM 混音，Cover API 都会分析原始作品，并在保留核心旋律与结构的同时，以新的配器、人声和编曲重新生成。
用自然语言描述目标风格。AI 会理解你的描述，并据此转换上传的音频。非常适合快速进行风格转换。
指定精确的风格、标题和其他参数，以精准控制翻唱输出。适合需要特定音乐属性的专业制作。
在任意流派之间转换歌曲——从流行到爵士、从摇滚到原声、从古典到电子。AI 能理解数百种音乐风格及其标志性元素。
生成不同性别和风格的全新人声。可将男声轨转换为女声，或反向转换，并生成自然逼真、匹配新风格的 AI 人声。
创作纯器乐翻唱，或彻底重新构想配器。可将吉他替换为弦乐，将合成器替换为原声乐器，或进行任意组合。
通过 audio weight 参数控制保留与转换之间的平衡。既可以贴近原曲，也可以创作出完全全新的作品。
只需几个步骤，即可将歌曲转换为全新风格
上传你想要翻唱的歌曲。支持最大 50MB 的 MP3、WAV、OGG、M4A 和 FLAC 格式。
描述你想要的风格，或使用自定义模式指定精确参数。请具体说明乐器、氛围和节奏变化。
微调 style weight、audio weight 和人声偏好，以获得期望的结果。
提交请求，等待 AI 分析歌曲并以新风格重新创作。
获取生成的翻唱版本。每个翻唱版本都包含新的配器、编曲，并可选择包含新的人声。
遵循这些建议，获得最佳翻唱生成效果
更高质量的源文件能生成更好的翻唱效果。为获得最佳结果，请避免使用重度压缩或低码率音频。
不要只写“让它更爵士”，而应描述具体内容，例如“带有 walking bass、钢琴伴奏和刷镲鼓点的 smooth jazz”。
根据你希望保留多少原曲元素来调整 audio weight。较低的值可以实现更明显的风格转换。
为曲目创作官方混音和替代版本，并发布到多个平台。
生成面向特定受众、活动或情绪定制的翻唱版本。
为卡拉 OK 应用、练习曲目和演出伴奏创建歌曲的器乐翻唱版本。
展示歌曲在不同流派中的声音效果，用于音乐理论和编曲教学。
借助深入理解音乐风格的高质量 AI，在任意流派之间转换歌曲。
简洁的文件上传 API，支持所有主流音频格式。无需复杂预处理。
快速生成翻唱，标准长度歌曲通常可在 1-2 分钟内完成。
所有 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创建新任务，为上传的歌曲生成 AI 翻唱版本
通过这个示例快速上手所选语言的 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/cover",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "audioUrl": "https://your-storage.com/songs/original.mp3",
12 "customMode": false,
13 "instrumental": false,
14 "prompt": "Transform into smooth jazz with piano and saxophone",
15 "vocalGender": "f"
16 }
17});
18
19console.log(task.data.taskId);该 API 接受具有以下结构的 JSON 负载：
1{
2 "model": "suno/cover",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "audioUrl": "string (required)",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "prompt": "string",
10 "style": "string",
11 "title": "string",
12 "vocalGender": "m | f",
13 "personaId": "string",
14 "negativeTags": "string",
15 "styleWeight": "number",
16 "weirdnessConstraint": "number",
17 "audioWeight": "number"
18 }
19}model必填string用于 Suno V5 翻唱生成的模型标识符
"suno/cover"
callBackUrl可选string翻唱生成完成时用于接收 webhook 通知的 URL
"https://your-domain.com/api/callback"
翻唱生成参数：
input.model_version可选string要使用的 Suno 模型版本。默认为 V5。
可用选项：
"V5"
input.audioUrl必填string用于创建翻唱的源音频文件 URL。必须是可公开访问的 URL。
"https://your-storage.com/songs/original.mp3"
input.customMode可选boolean启用自定义模式以进行更精细的控制。当为 true 时，style 和 title 为必填。
false
input.instrumental可选boolean生成不含人声的纯音乐翻唱。
false
input.prompt可选string目标翻唱风格的描述。当 customMode 为 false 时必填。
customMode=false：prompt 为必填，最多 500 个字符。customMode=true + instrumental=false：prompt 为必填，最多 5000 个字符。customMode=true + instrumental=true：prompt 为可选，最多 5000 个字符。对于 customMode=true： V4：最多 3000 个字符 V5_5, V5, V4_5PLUS, V4_5ALL, V4_5：最多 5000 个字符
"Transform into smooth jazz with piano and saxophone"
input.style可选string翻唱的目标音乐风格。当 customMode 为 true 时必填。
customMode=true 时必填。customMode=false 时会被忽略。 V4：最多 200 个字符 V5_5, V5, V4_5PLUS, V4_5ALL, V4_5：最多 1000 个字符
"Jazz, Smooth, Lounge"
input.title可选string翻唱版本的标题。当 customMode 为 true 时必填。
最大长度：80 个字符
"My Song (Jazz Cover)"
input.vocalGender可选string翻唱版本的人声性别。
仅在 customMode=true 时生效。
可用选项：
"f"
input.personaId可选string生成歌曲使用的角色 ID。
仅在 customMode=true 时生效。
"1234567890"
input.negativeTags可选string生成时要排除的风格或特征。
仅在 customMode=true 时生效。
"aggressive, heavy metal, screaming"
input.styleWeight可选number目标风格的应用强度。范围：0.0-1.0
仅在 customMode=true 时生效。数字范围为 0.00 到 1.00。必须以 0.01 为增量。不接受布尔值。
0.5
input.weirdnessConstraint可选number控制创意程度。数值越高，结果越具有实验性。范围：0.0-1.0
仅在 customMode=true 时生效。数字范围为 0.00 到 1.00。必须以 0.01 为增量。不接受布尔值。
0.3
input.audioWeight可选number从源音频中保留内容的程度。范围：0.0-1.0
仅在 customMode=true 时生效。数字范围为 0.00 到 1.00。必须以 0.01 为增量。不接受布尔值。
0.5
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_cover_abc123"
6 }
7}code状态码，200 表示成功
message响应消息
data.taskId用于查询翻唱生成状态的任务 ID
翻唱生成完成后，会向你的 callBackUrl 发送 POST 请求
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_cover_abc123",
5 "state": "success",
6 "completeTime": 1755599750000,
7 "costTime": 65000,
8 "model": "suno/cover",
9 "resultJson": {
10 "data": [
11 {
12 "id": "cover_001",
13 "audio_url": "https://cdn.apipass.dev/results/task_cover_abc123_0_audio.mp3",
14 "image_url": "https://cdn.apipass.dev/results/task_cover_abc123_0_cover.jpeg",
15 "duration": 195.5
16 }
17 ]
18 }
19 },
20 "msg": "Cover generation completed successfully."
21}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_cover_abc123",
5 "state": "fail",
6 "failCode": "INVALID_AUDIO_URL",
7 "failMsg": "Unable to download audio from provided URL"
8 },
9 "msg": "Cover generation 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_cover_abc123");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_cover_abc123",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "cover_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_cover_abc123_0_audio.mp3",
11 "image_url": "https://cdn.apipass.dev/results/task_cover_abc123_0_cover.jpeg",
12 "duration": 195.5
13 }
14 ]
15 }
16 }
17}data.state当前状态：queuing、generating、success 或 fail
data.resultJson.data生成的翻唱版本数组，包含 URL 和元数据
API 页面显示参数架构，但 Suno 还有几个特定于业务的模式组合和回调规则，容易被忽略。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
创建新任务，为上传的歌曲生成 AI 翻唱版本
该 API 接受具有以下结构的 JSON 负载：
1{
2 "model": "suno/cover",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "audioUrl": "string (required)",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "prompt": "string",
10 "style": "string",
11 "title": "string",
12 "vocalGender": "m | f",
13 "personaId": "string",
14 "negativeTags": "string",
15 "styleWeight": "number",
16 "weirdnessConstraint": "number",
17 "audioWeight": "number"
18 }
19}model必填string用于 Suno V5 翻唱生成的模型标识符
"suno/cover"
callBackUrl可选string翻唱生成完成时用于接收 webhook 通知的 URL
"https://your-domain.com/api/callback"
翻唱生成参数：
input.model_version可选string要使用的 Suno 模型版本。默认为 V5。
可用选项：
"V5"
input.audioUrl必填string用于创建翻唱的源音频文件 URL。必须是可公开访问的 URL。
"https://your-storage.com/songs/original.mp3"
input.customMode可选boolean启用自定义模式以进行更精细的控制。当为 true 时，style 和 title 为必填。
false
input.instrumental可选boolean生成不含人声的纯音乐翻唱。
false
input.prompt可选string目标翻唱风格的描述。当 customMode 为 false 时必填。
customMode=false：prompt 为必填，最多 500 个字符。customMode=true + instrumental=false：prompt 为必填，最多 5000 个字符。customMode=true + instrumental=true：prompt 为可选，最多 5000 个字符。对于 customMode=true： V4：最多 3000 个字符 V5_5, V5, V4_5PLUS, V4_5ALL, V4_5：最多 5000 个字符
"Transform into smooth jazz with piano and saxophone"
input.style可选string翻唱的目标音乐风格。当 customMode 为 true 时必填。
customMode=true 时必填。customMode=false 时会被忽略。 V4：最多 200 个字符 V5_5, V5, V4_5PLUS, V4_5ALL, V4_5：最多 1000 个字符
"Jazz, Smooth, Lounge"
input.title可选string翻唱版本的标题。当 customMode 为 true 时必填。
最大长度：80 个字符
"My Song (Jazz Cover)"
input.vocalGender可选string翻唱版本的人声性别。
仅在 customMode=true 时生效。
可用选项：
"f"
input.personaId可选string生成歌曲使用的角色 ID。
仅在 customMode=true 时生效。
"1234567890"
input.negativeTags可选string生成时要排除的风格或特征。
仅在 customMode=true 时生效。
"aggressive, heavy metal, screaming"
input.styleWeight可选number目标风格的应用强度。范围：0.0-1.0
仅在 customMode=true 时生效。数字范围为 0.00 到 1.00。必须以 0.01 为增量。不接受布尔值。
0.5
input.weirdnessConstraint可选number控制创意程度。数值越高，结果越具有实验性。范围：0.0-1.0
仅在 customMode=true 时生效。数字范围为 0.00 到 1.00。必须以 0.01 为增量。不接受布尔值。
0.3
input.audioWeight可选number从源音频中保留内容的程度。范围：0.0-1.0
仅在 customMode=true 时生效。数字范围为 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/cover",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "audioUrl": "https://your-storage.com/songs/original.mp3",
9 "customMode": false,
10 "instrumental": false,
11 "prompt": "Transform into smooth jazz with piano and saxophone",
12 "vocalGender": "f"
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_cover_abc123"
6 }
7}code状态码，200 表示成功
message响应消息
data.taskId用于查询翻唱生成状态的任务 ID
