Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有音频。提交表单以生成音频。
探索不同用例和参数配置
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
Suno generate musicSuno | Starter | 1per run | $0.005 | - | - |
Suno 使用完整指南
通过 ApiPass 接入 `suno/generate`，你可以把一句自然语言描述直接变成完整歌曲。无论你想生成带人声的流行歌、纯音乐背景、广告配乐，还是用于 Demo 的旋律草稿，ApiPass 都提供统一的任务接口、异步查询能力和稳定的 Webhook 回调，适合从原型到生产环境的完整接入。
Suno Generate 是 Suno 的文生音乐生成能力，能够基于文本描述创建完整歌曲。你可以指定音乐风格、标题、是否纯音乐、歌手性别，以及在高级模式下进一步控制风格强度、创意程度和排除标签。通过 ApiPass，开发者无需直接处理底层账号体系，即可用统一 API 调用 Suno V5、V4.5PLUS、V4.5ALL、V4.5 和 V4 等版本，快速把 AI 音乐能力接入自己的产品。
输入一句对歌曲主题、情绪、节奏或场景的描述，就能生成可直接试听的完整音乐作品。它非常适合快速验证创意方向、生成短期营销内容，或为产品提供“输入一句话即可生成歌曲”的交互体验。
当你需要更精细的控制时，可以启用 `customMode`，显式传入 `style` 与 `title`。这样能够更稳定地约束生成结果的题材、流派和命名方式，适用于批量内容生产、模板化生成流程以及品牌场景。
Suno 音乐生成通常需要几十秒，因此 ApiPass 以任务模式提供接口。你可以在创建任务后轮询 `/api/v1/jobs/recordInfo`，也可以提供 `callBackUrl` 使用 Webhook，在生成完成后自动接收结果并继续你的后续处理链路。
生成包含AI演唱人声和与您的提示相匹配的连贯歌词的完整歌曲。Suno V5模型可创造出多种语言和风格的自然人声。
创作没有人类歌声的纯器乐曲目。非常适合背景音乐、游戏配乐、冥想应用以及任何需要无歌词音乐的使用场景。
支持从流行、摇滚和嘻哈到古典、电子和世界音乐等数百种音乐流派。结合多种风格并使用反向标签排除不需要的元素。
在男声和女声之间进行选择，以符合您的创作愿景。AI提供适应音乐风格的自然声音。
使用风格权重、怪异度限制和音频权重参数微调您的创作。在严格遵循提示和允许创造性探索之间取得平衡。
下面这些工作流非常适合直接接入 `suno/generate`，并结合异步任务与 Webhook 构建稳定的生产流程。
让用户通过一句提示词快速获得两首候选歌曲，适合灵感生成、AI 创作助手和互动娱乐产品。
把活动主题、产品卖点或广告文案映射为风格化音乐，实现大批量、模板化的配乐生产。
在用户提交请求后立即返回 taskId，由后端异步接收 Webhook 并把音频 URL、封面和元数据写回业务系统。
利用每次生成两首变体的特点，把 Suno Generate 接到内部审核台、编辑台或发布流程中，形成更可控的内容生产链路。
根据你的输入内容和控制需求，选择最适合的 Suno 接口形态。
如果你的核心需求是“先生成歌词文本”，应优先使用 `suno/lyrics`；如果你希望直接得到完整歌曲结果，包括音频与封面，则应使用 `suno/generate`。两者可以串联使用，但目标不同。
`suno/generate` 适合从零开始创建歌曲；如果你已经有现成的 Suno 歌曲并想续写，应选择 `suno/extend`；如果你要重做已有音频的风格版本，则更适合 `suno/cover`。
为用户提供一句话生成歌曲、灵感扩写、风格重写和快速试听的创作工具，适合音乐创作平台、灵感笔记产品和内容工作室。
根据活动主题、广告文案或商品卖点自动生成配乐，为短视频、广告投放和品牌内容提供更低成本、可自动化的声音素材。
在游戏开发、互动体验或虚拟角色产品中，根据剧情、角色设定或场景标签快速生成背景音乐与主题旋律，用于原型验证与内容迭代。
将 Suno Generate 接入任务队列、CMS 或自动化工作流系统，在接收用户请求后异步生成并回写结果，减少前端等待时间并提升整体流程稳定性。
在 ApiPass 控制台生成你的 API Key。后续所有 `suno/generate` 请求都使用这一凭证进行身份校验。
向 `/api/v1/jobs/createTask` 发送包含 `model: "suno/generate"` 的请求，并在 `input` 中提供 prompt、style、title、instrumental 等参数。接口会立即返回 `taskId`。
使用 `taskId` 轮询 `/api/v1/jobs/recordInfo`，或在创建任务时传入 `callBackUrl`。生成成功后，你会拿到音频 URL、封面图以及歌曲元数据。
所有 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/generate",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "prompt": "A catchy pop song about summer love with upbeat tempo and cheerful melody",
12 "customMode": false,
13 "instrumental": false,
14 "vocalGender": "f"
15 }
16});
17
18console.log(task.data.taskId);该 API 接受具有以下结构的 JSON payload：
1{
2 "model": "suno/generate",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "prompt": "string",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "style": "string",
10 "title": "string",
11 "vocalGender": "m | f",
12 "negativeTags": "string",
13 "styleWeight": "number",
14 "weirdnessConstraint": "number",
15 "audioWeight": "number"
16 },
17 "channel": "auto"
18}model必填string用于 Suno V5 音乐生成的模型标识符
"suno/generate"
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.prompt可选string要生成音乐的文本描述。当 customMode 为 false，或 customMode 为 true 且 instrumental 为 false 时必填。
customMode=false：prompt 为必填，最多 500 个字符。customMode=true + instrumental=false：prompt 为必填。customMode=true + instrumental=true：prompt 为可选。对于 customMode=true： V4：最多 3000 个字符； V5_5、V5、V4_5PLUS、V4_5ALL、V4_5：最多 5000 个字符
"一首关于夏日恋爱的抓耳流行歌曲，节奏欢快"
input.customMode可选boolean启用自定义模式以获得更多控制。为 true 时，style 和 title 为必填。
当 customMode=false 时，style 和 title 会被忽略，且不会发送给服务商。
参数模式：
customMode=false + instrumental=false
promptcustomMode=false + instrumental=true
promptcustomMode=true + instrumental=false
styletitlepromptcustomMode=true + instrumental=true
styletitlepromptfalse
input.instrumental可选boolean生成无人声的纯音乐。
false
input.style可选string音乐风格/流派。customMode 为 true 时必填。
customMode=true 时必填。customMode=false 时会被忽略。 V4：最多 200 个字符； V5_5、V5、V4_5PLUS、V4_5ALL、V4_5：最多 1000 个字符
"流行、欢快、夏日氛围"
input.title可选string生成音乐的标题。customMode 为 true 时必填。
最大长度：80 个字符
"夏日恋曲"
input.vocalGender可选string生成歌曲中的人声音色性别。
仅在 customMode=true 时生效。
可用选项：
"f"
input.personaId可选string生成歌曲使用的 Persona ID。
仅在 customMode=true 时生效。
"1234567890"
input.negativeTags可选string生成时要排除的风格或特征。
仅在 customMode=true 时生效。
"激进、重金属、尖叫"
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_abc123xyz"
6 }
7}code状态码，200 表示成功
message响应消息
data.taskId用于查询状态和结果的唯一任务 ID
生成完成后，会向你的 callBackUrl 发送 POST 请求
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "success",
6 "completeTime": 1755599644000,
7 "costTime": 45000,
8 "createTime": 1755599599000,
9 "model": "suno/generate",
10 "resultJson": {
11 "data": [
12 {
13 "id": "audio_001",
14 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_audio.mp3",
15 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_cover.jpeg",
16 "duration": 180.5,
17 "title": "Summer Love",
18 "style": "Pop"
19 },
20 {
21 "id": "audio_002",
22 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_1_audio.mp3",
23 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_1_cover.jpeg",
24 "duration": 175.2,
25 "title": "Summer Love",
26 "style": "Pop"
27 }
28 ]
29 }
30 },
31 "msg": "Task completed successfully."
32}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "fail",
6 "failCode": "GENERATION_FAILED",
7 "failMsg": "Music generation failed due to content policy violation"
8 },
9 "msg": "Task 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_abc123xyz");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "audio_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_audio.mp3",
11 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_cover.jpeg",
12 "duration": 180.5
13 }
14 ]
15 }
16 }
17}code状态码，200 表示成功
data.taskId任务 ID
data.state当前状态：queuing、generating、success 或 fail
data.resultJson.data包含 URL 和元数据的已生成音频曲目数组
API 页面显示参数架构，但 Suno 还有几个特定于业务的模式组合和回调规则，容易被忽略。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
创建新的 Suno V5 音乐生成任务
该 API 接受具有以下结构的 JSON payload：
1{
2 "model": "suno/generate",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "prompt": "string",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "style": "string",
10 "title": "string",
11 "vocalGender": "m | f",
12 "negativeTags": "string",
13 "styleWeight": "number",
14 "weirdnessConstraint": "number",
15 "audioWeight": "number"
16 },
17 "channel": "auto"
18}model必填string用于 Suno V5 音乐生成的模型标识符
"suno/generate"
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.prompt可选string要生成音乐的文本描述。当 customMode 为 false，或 customMode 为 true 且 instrumental 为 false 时必填。
customMode=false：prompt 为必填，最多 500 个字符。customMode=true + instrumental=false：prompt 为必填。customMode=true + instrumental=true：prompt 为可选。对于 customMode=true： V4：最多 3000 个字符； V5_5、V5、V4_5PLUS、V4_5ALL、V4_5：最多 5000 个字符
"一首关于夏日恋爱的抓耳流行歌曲，节奏欢快"
input.customMode可选boolean启用自定义模式以获得更多控制。为 true 时，style 和 title 为必填。
当 customMode=false 时，style 和 title 会被忽略，且不会发送给服务商。
参数模式：
customMode=false + instrumental=false
promptcustomMode=false + instrumental=true
promptcustomMode=true + instrumental=false
styletitlepromptcustomMode=true + instrumental=true
styletitlepromptfalse
input.instrumental可选boolean生成无人声的纯音乐。
false
input.style可选string音乐风格/流派。customMode 为 true 时必填。
customMode=true 时必填。customMode=false 时会被忽略。 V4：最多 200 个字符； V5_5、V5、V4_5PLUS、V4_5ALL、V4_5：最多 1000 个字符
"流行、欢快、夏日氛围"
input.title可选string生成音乐的标题。customMode 为 true 时必填。
最大长度：80 个字符
"夏日恋曲"
input.vocalGender可选string生成歌曲中的人声音色性别。
仅在 customMode=true 时生效。
可用选项：
"f"
input.personaId可选string生成歌曲使用的 Persona ID。
仅在 customMode=true 时生效。
"1234567890"
input.negativeTags可选string生成时要排除的风格或特征。
仅在 customMode=true 时生效。
"激进、重金属、尖叫"
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/generate",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "prompt": "A catchy pop song about summer love with upbeat tempo and cheerful melody",
9 "customMode": false,
10 "instrumental": false,
11 "vocalGender": "f"
12 }
13 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_abc123xyz"
6 }
7}code状态码，200 表示成功
message响应消息
data.taskId用于查询状态和结果的唯一任务 ID
