APIXO

音频

Suno V5

Suno API 可根据提示词、风格和歌词生成录音室级别的音乐，每次运行返回两条轨道，并支持适合生产环境的异步交付。

$0.12 / generation

单次运行 2 条音轨V4 / V4.5 / V5自定义歌词模式MP3 + 封面图

正在加载工作区...

接口地址

POSThttps://api.apixo.ai/api/v1/generateTask/suno创建任务

GEThttps://api.apixo.ai/api/v1/statusTask/suno?taskId={taskId}轮询状态

身份验证

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

登录以领取免费积分，测试演练场，并继续进行 API 集成。

请求体

request_type

async

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

provider

official

与 Seedance 2.0 手册一致。

input

对象

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

参数

request_type必填

类型select

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

callback_url有条件的

类型text

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

mode必填

类型select

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

customMode必填

类型boolean

启用自定义歌词模式。关闭时，将使用纯提示词歌曲描述模式。

title必填

类型text

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

style必填

类型string

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

prompt可选

类型string

歌曲描述或歌词。在较新的 Suno 版本中，自定义模式支持更长的歌词。

songDescription必填

类型string

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

instrumental必填

类型boolean

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

negativeTags有条件的

类型string

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

styleWeight有条件的

类型slider

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

weirdnessConstraint有条件的

类型slider

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

audioWeight有条件的

类型slider

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

vocalGender有条件的

类型select

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

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

示例 (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",
      "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 V5 API 指南

用于音频生成工作流的 Suno API

通过 APIXO 使用 Suno，您可以在 Playground 中测试提示词、查看演示、比较价格，并将相同的设置直接应用于生产环境的 API 调用。

Suno V5 工作流

在一个页面内构建和部署 Suno V5 API 工作流

此 Suno V5 模型主页专为希望在同一工作流中评估生成质量、比较价格、创建 API 密钥并将测试好的设置应用于生产代码的团队而设计。

Suno V5 提示词测试

在将请求投入生产前，使用 Suno V5 Playground 测试提示词、模式选项和输出设置。

Suno V5 演示回顾

先检查真实的或占位的音频输出，然后将相同的演示参数加载到 Playground 中以加快迭代速度。

Suno V5 API 对接

无需离开当前模型页面，即可从可视化测试无缝切换到 API 密钥、cURL 示例、请求 JSON 和相关文档。

Suno V5 定价清晰

在为生产任务选择成本模式前，请先在同一页面比较可用的定价方案。

Suno V5 输入控制

直接在 Playground 中调整歌词、风格和人声控制，以确保测试的表单与文档化的 API 接口一致。

Suno V5 生产就绪

当异步轮询、回调交付、生成历史和可预测的计费对团队工作流至关重要时，请使用 APIXO。

模型概览

什么是 Suno API？

Suno 已通过 APIXO 作为生产级 API 提供，用于音频生成。该模型页面将 Playground 测试、真实请求参数、定价和文档对接整合在一个工作流中。

请先使用此页面验证提示词和模式选项，然后将相同的设置用于 API 密钥、cURL 示例、后端集成和可重复的生成任务。

面向生产团队的 Suno API 工作流

从 Playground 开始，选择与您的输入资产相匹配的模式。
当您需要快速获得基准配置时，可以查看输出示例并加载演示参数。
在发送大批量或更高分辨率的任务前，请检查价格。
对交互式应用使用异步轮询模式，对后端队列使用回调模式。

Suno API 技术规格

当前 Suno API 的功能及集成相关限制条件。

Suno 模式

纯提示词、自定义歌词和纯音乐

Suno 输出

单次运行 2 条音轨

Suno 参数控制

V4 / V4.5 / V5 / 自定义歌词模式

Suno 延迟

通常需要 60-90 秒

Suno V5 核心功能

Suno 音乐生成

使用结构化提示词生成音频，生成设置全程可见，方便 API 对接。

Suno 创意控制

在投入生产调用之前，直接在 Playground 中调整歌词、风格或模式设置。

Suno API 工作流

在同一模型页面上，您可以使用异步任务创建、轮询和回调交付功能，并查看请求示例。

您可以用 Suno V5 构建什么？

Suno 创作者工具

将音乐生成功能添加到创作者工作流中，满足用户从提示词到音频的快速迭代需求。

Suno 品牌音频

通过 API 任务生成营销活动配乐、短格式背景音乐、片头、片尾或声音概念。

Suno 生产自动化

通过后端队列运行可重复的异步音频任务，同时跟踪输入、任务 ID 和结果链接。

Suno V5 注意事项与限制

Suno 的生成采用异步任务交付；生产系统应支持轮询或回调处理。
结果质量取决于提示词的清晰度、输入素材的质量以及提供商侧的模型行为。
所有请求都必须通过供应商的安全、内容审核和账户访问权限检查。
即使使用相同的提示词结构，生成的音频在歌词、声乐风格、节奏和混音方面也可能有所不同。

Suno V5 常见问题

开始构建

先在上方 Playground 进行测试，准备好集成时再查阅 API 文档。

尝试 Playground 查看 API 文档

用于 音频生成 工作流的 Suno API

在一个页面内构建和部署 Suno V5 API 工作流

什么是 Suno API？

面向生产团队的 Suno API 工作流

Suno API 技术规格

Suno 模式

Suno 输出

Suno 参数控制

Suno 延迟

Suno V5 核心功能

Suno 音乐生成

Suno 创意控制

Suno API 工作流

您可以用 Suno V5 构建什么？

Suno 创作者工具

Suno 品牌音频

Suno 生产自动化

Suno V5 注意事项与限制

Suno V5 常见问题

在编写 API 代码前，我可以测试 Suno 吗？

Suno 是否支持异步生成？

Suno 的参数来自哪里？

之后可以替换演示素材吗？

开始构建

用于音频生成工作流的 Suno API