Suno V5

API 文档开始创建

文本转音乐人声 / 器乐多版本 API

APIXO 上的 Suno 是一个多版本音乐生成接口，可根据简短概念或自定义歌词创建人声或器乐曲目。选择 V5.5、V5 或 V4.x 后端，通过结构化控件塑造音乐方向，每次成功的生成请求最多可收到两个带有封面的 MP3 变体。

后端

V5.5 / V5 / V4.x

APIXO 价格

$0.12 / 次生成

输出

最多 2 个 MP3 曲目

工作流

提示词 / 自定义歌词

交付

轮询 / 回调

正在加载工作区...

Suno V5 模型 API 费率结构

Suno 按每次成功接收的生成请求计费。V5 和 V5.5 使用较低的、由后端确定的请求价格；V4 和 V4.5 系列模式则使用较高的请求价格。

V5 / V5.5

计费依据

已接受生成请求

APIXO 价格

$0.12 / 次请求

V4 / V4.5 系列

计费依据

已接受生成请求

APIXO 价格

$0.18 / 次请求

后端模式	计费依据	APIXO 价格
V5 / V5.5	已接受生成请求	$0.12 / 次请求
V4 / V4.5 系列	已接受生成请求	$0.18 / 次请求

计费规则

一次成功的请求最多可返回两个带有封面图的 MP3 音轨变体。
请求价格不会乘以返回的曲目数量。
该接口不支持上传音频编辑、混音、分轨、MIDI、WAV 导出或声音克隆功能。
如果不需要旧版 V4.x 的功能，请使用 V5.5 或 V5 以享受 APIXO 最低的请求价格。

常见费用示例

例如：5 次 Suno V5.5 生成 = 5 x $0.12 = $0.60。

正在检查 API 访问权限...

登录以领取免费积分并使用此模型进行创作。

与 AI 集成

复制一段提示词，让您的 AI 助手安装 APIXO MCP、读取实时 schema 并将此模型接入您的应用。

接口地址

创建任务

POSThttps://api.apixo.ai/api/v1/generateTask/suno

轮询状态

GEThttps://api.apixo.ai/api/v1/statusTask/suno?taskId={taskId}

请求体

request_type

async

通过 callback_url 使用回调以实现 Webhook。

input

对象

模式、提示词、参考图、尺寸、时长和音频设置。

request_type必填

类型select

使用异步模式轮询任务状态 (poll statusTask)，或使用回调模式在结果就绪时接收 webhook 通知。async · callback

callback_url有条件的

类型text

用于接收回调通知的公开 HTTPS URL。仅限 request_type=callback

mode必填

类型select

选择生成后端版本。V5_5 · V5 · V4_5 · V4_5ALL · V4_5PLUS · V4

customMode必填

类型boolean

开启后可自定义歌词和风格；关闭后将仅根据提示词生成歌曲。

title必填

类型text

当自定义模式开启时必填。仅限 customMode=true

style必填

类型string

描述流派、情绪、乐器和声乐风格。在自定义模式下为必填项。仅限 customMode=true

prompt可选

类型string

歌曲描述或歌词。V5.5、V5 和 V4.5 模式支持最多 5000 个字符。

songDescription必填

类型string

当自定义模式关闭时，使用纯提示词模式字段。仅限 customMode=false

instrumental必填

类型boolean

开启后将生成无人声的纯音乐。

negativeTags有条件的

类型string

描述需要避免的瑕疵或风格。仅限 customMode=true

styleWeight有条件的

类型slider

遵循风格描述的强度。仅限 customMode=true

weirdnessConstraint有条件的

类型slider

值越高，生成的输出结果实验性越强。仅限 customMode=true

audioWeight有条件的

类型slider

平衡音频保真度与歌词控制力。仅限 customMode=true

vocalGender有条件的

类型select

尽力匹配所偏好的音色。f · m仅限 customMode=true

参数	类型	必填项	描述
`request_type`	select	必填	使用异步模式轮询任务状态 (poll statusTask)，或使用回调模式在结果就绪时接收 webhook 通知。async · callback
`callback_url`	text	有条件的	用于接收回调通知的公开 HTTPS URL。仅限 request_type=callback
`mode`	select	必填	选择生成后端版本。V5_5 · V5 · V4_5 · V4_5ALL · V4_5PLUS · V4
`customMode`	boolean	必填	开启后可自定义歌词和风格；关闭后将仅根据提示词生成歌曲。
`title`	text	必填	当自定义模式开启时必填。仅限 customMode=true
`style`	string	必填	描述流派、情绪、乐器和声乐风格。在自定义模式下为必填项。仅限 customMode=true
`prompt`	string	可选	歌曲描述或歌词。V5.5、V5 和 V4.5 模式支持最多 5000 个字符。
`songDescription`	string	必填	当自定义模式关闭时，使用纯提示词模式字段。仅限 customMode=false
`instrumental`	boolean	必填	开启后将生成无人声的纯音乐。
`negativeTags`	string	有条件的	描述需要避免的瑕疵或风格。仅限 customMode=true
`styleWeight`	slider	有条件的	遵循风格描述的强度。仅限 customMode=true
`weirdnessConstraint`	slider	有条件的	值越高，生成的输出结果实验性越强。仅限 customMode=true
`audioWeight`	slider	有条件的	平衡音频保真度与歌词控制力。仅限 customMode=true
`vocalGender`	select	有条件的	尽力匹配所偏好的音色。f · m仅限 customMode=true

示例 (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/suno" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "V5_5",
      "customMode": true,
      "instrumental": false,
      "title": "Neon Freeway Nights",
      "style": "Synthwave, dreamy pop",
      "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful."
    }
  }'

完整 API 文档

能力

跨多个 Suno 版本灵活创作歌曲

完整歌曲生成

通过文本构建完整的音乐概念，而不是分别组合人声、乐器和编曲。生成结果在结构、时长、歌词演绎和混音方面可能会有差异。

可选模型版本

APIXO 提供 V5_5、V5、V4_5、V4_5ALL、V4_5PLUS 和 V4，允许应用程序选择后端，而不是将该路由仅视为 V5。

自定义歌词结构

自定义模式接受提供的歌词以及标题和风格描述。可以使用如 [Verse]、[Chorus] 和 [Bridge] 等段落标签来组织所请求的歌曲结构。

人声或纯音乐输出

同一接口既支持生成带人声的歌曲，也支持纯器乐。在任一创作流程中，通过设置必需的 instrumental 参数即可生成纯器乐。

风格与实验性控制

自定义模式提供风格遵循度、新奇度、负面标签、音频权重以及尽力而为的人声声色偏好等参数，用于塑造同一音乐主题的不同演绎版本。

两种创意变体

一次成功的生成请求可返回两个音轨对象，每个对象包含一个 MP3 URL 和一个封面图 URL，以便团队可以从一次请求中评估不同的编曲或演绎版本。

创作工作流

从一个概念开始，或提供歌曲结构

仅提示词生成歌曲

LYuHuh

仅提示词

自定义歌词与风格生成

将 `customMode` 设置为 `true`，然后在生成人声时提供标题、风格和歌词。自定义模式还支持负面标签、风格遵循度、实验性、音频权重和音色控制。

自定义模式

API 详情

Suno 接口规格

由 APIXO 验证并记录的创作、输出和交付行为。

6 个可选枚举值

后端

1–500 字符

简单提示词

V4: 3K · 后续版本: 5K

自定义提示词

最多 2 个变体

追踪记录

MP3 + 封面图

资产

默认 15 天

保留

应用场景

适用于 Suno 路由的音乐工作流

歌曲创作

探索原创歌曲概念

将一个想法转变为不同的人声曲目，或提供结构化的歌词和风格指导以比较可能的编曲。在进一步使用前，请检查发音、歌词准确性、歌曲结构和不希望出现的相似性。

品牌音频

草拟营销活动音乐

为广告、社交活动和品牌内容生成人声片段或器乐概念。请将输出视为创意草稿，并在发布前完成适当的权利和商业许可审查。

短格式音频

创建片头和片尾概念音乐

为播客、频道、直播和系列节目开发音乐方向。使用风格和负面标签控制来探索基调，同时检查混音平衡、人声瑕疵以及是否适合预期的剪辑。

互动媒体

制作叙事配乐原型

通过描述情绪、流派、乐器和强度，为游戏、预告片、场景和虚构背景制作器乐创意。该路由不提供分轨、MIDI 或可编辑的项目会话。

说明与常见问题

APIXO Suno 路由操作指南

集成说明

该产品页面标题为“Suno V5”，但实际路由支持多版本，当前最新的可选后端为 V5_5。

Suno 于 2025 年 9 月 23 日发布了 v5，并于 2026 年 3 月 26 日发布了 v5.5；仅当选择 V5_5 时，v5.5 的特定改进才会生效。

APIXO 的 V4 版本支持最多 3,000 个字符的自定义歌词，而 V4.5、V5 和 V5.5 系列版本支持最多 5,000 个字符。

V4 版本的自定义风格支持最多 200 个字符，更高版本的可选后端支持最多 1,000 个字符；APIXO 文档指出标题最多 80 个字符，负面标签最多 200 个字符。

典型生成耗时 60-90 秒；APIXO 建议在 45 秒后进行首次轮询，之后每 5-10 秒轮询一次。

HfEUvQ

常见问题解答

否。APIXO 的产品名称仍为“Suno V5”，但 suno 路由目前开放 V5_5、V5、V4_5、V4_5ALL、V4_5PLUS 和 V4 版本。将其描述为一个多版本的 Suno 音乐 API 更为准确。

`styleWeight`、`weirdnessConstraint` 和 `audioWeight` 接受 0 到 1 之间的值。`styleWeight` 增加对风格描述的遵循度，更高的 `weirdnessConstraint` 鼓励实验性，而 `audioWeight` 则在音频保真度与歌词控制之间取得平衡。APIXO 不会发布全路由范围的默认值。

APIXO 指出，一个被接受的生成请求可以返回两个变体，并显示一个包含两个音轨对象的 resultUrls 数组。应用程序仍应解析返回的数组，而不是假定两个音轨总是能成功完成。

APIXO 的详细路由文档列出每次生成（包括返回的变体）的价格为 $0.12，而不是每个音轨 $0.12。文档明确指出该费率适用于 V5 和 V5.5；旧后端的单独费率和部分结果的计费方式未公开逐项列出。

文档未涵盖上传音频、扩展、翻唱、混音、母带重制、声音克隆或编辑等工作流。结果提供 MP3 和封面图的 URL，并在可用时返回歌词；不提供 WAV、分轨、MIDI、视频或可编辑的项目文件。