音频

Suno V5

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

$0.12 / use

单次运行 2 条音轨异步工作流提示词和歌词控制MP3 + 封面图

参数

Model Version*

Custom Mode*

已启用

Title*

Style of Music*

Lyrics (optional but recommended)

Instrumental Only*

已禁用

Vocal Gender Preference

输出

生成的内容将显示在这里

接口地址

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

Use async to poll or callback to receive a webhook when ready.async · callback

callback_url有条件的

类型text

Publicly accessible URL for callback mode.仅限 request_type=callback

mode必填

类型select

Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS

customMode必填

类型boolean

Enable to control title/style/lyrics. When off, prompt-only mode is used.

title必填

类型text

Appears in metadata and can steer theme. Required when Custom Mode is on.仅限 customMode=

style必填

类型string

Describe genre/mood/instrumentation. Required in Custom Mode.仅限 customMode=

prompt有条件的

类型string

Provide full lyrics for sung output. Required when Instrumental is off.仅限 customMode=

songDescription必填

类型string

Simple mode: one field to steer both style and topic when Custom Mode is off.仅限 customMode=

instrumental必填

类型boolean

Turn on to generate backing track without vocals.

negativeTags有条件的

类型string

Negative Tags仅限 customMode=

styleWeight有条件的

类型slider

How strongly to follow the Style description.仅限 customMode=

weirdnessConstraint有条件的

类型slider

Push creativity/experimentation. Higher = wilder.仅限 customMode=

audioWeight有条件的

类型slider

Balance audio vs lyrical fidelity. Higher favors audio fidelity.仅限 customMode=

vocalGender有条件的

类型select

Best-effort vocal timbre preference (custom mode only).f · m仅限 customMode=

参数	类型	必填项	描述
`request_type`	select	必填	Use async to poll or callback to receive a webhook when ready.async · callback
`callback_url`	text	有条件的	Publicly accessible URL for callback mode.仅限 request_type=callback
`mode`	select	必填	Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS
`customMode`	boolean	必填	Enable to control title/style/lyrics. When off, prompt-only mode is used.
`title`	text	必填	Appears in metadata and can steer theme. Required when Custom Mode is on.仅限 customMode=
`style`	string	必填	Describe genre/mood/instrumentation. Required in Custom Mode.仅限 customMode=
`prompt`	string	有条件的	Provide full lyrics for sung output. Required when Instrumental is off.仅限 customMode=
`songDescription`	string	必填	Simple mode: one field to steer both style and topic when Custom Mode is off.仅限 customMode=
`instrumental`	boolean	必填	Turn on to generate backing track without vocals.
`negativeTags`	string	有条件的	Negative Tags仅限 customMode=
`styleWeight`	slider	有条件的	How strongly to follow the Style description.仅限 customMode=
`weirdnessConstraint`	slider	有条件的	Push creativity/experimentation. Higher = wilder.仅限 customMode=
`audioWeight`	slider	有条件的	Balance audio vs lyrical fidelity. Higher favors audio fidelity.仅限 customMode=
`vocalGender`	select	有条件的	Best-effort vocal timbre preference (custom mode only).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",
    "mode": "V5",
    "title": "Neon Freeway Nights",
    "style": "Synthwave, dreamy pop",
    "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful.",
    "songDescription": "A dreamy synthwave song about neon city nights and freedom.",
    "customMode": true,
    "instrumental": false,
    "negativeTags": "off-key vocals, muddy mix",
    "styleWeight": 0.7,
    "weirdnessConstraint": 0.25,
    "audioWeight": 0.6,
    "vocalGender": "f"
  }'

完整 API 文档

示例输出

使用 APIXO 上的 Suno V5 API 生成

2 追踪记录

Neon Freeway Nights

查看

完整指南

什么是 Suno API？

Suno API 是一款专为快速生产工作流设计的文生音乐接口。它可以将提示词、风格标签和自定义歌词转化为两首完整的歌曲输出，并配有相关的封面图像。

这使其适用于创作者工具、品牌内容生成和自动化音乐制作等场景，在这些场景中，快速迭代比手动创作更为重要。

生成工作流说明

提交带有纯提示词或自定义歌词模式参数的生成请求。
通过轮询或回调接口地址异步接收任务状态。
成功后，消耗两条生成的音轨及对应的封面元数据。

Suno API 技术规格

与产品和后端集成相关的运行特性。

输出

单次生成 2 条音轨

控制界面

风格、怪异度、音频权重

生成模式

仅提示词模式和自定义歌词模式

交付

异步轮询或回调

核心能力

双轨道输出

每次生成返回两个歌曲变体，加速制作团队的 A/B 测试与创意迭代。

创意控制滑块

调节风格权重、怪异度和音频权重，使输出从稳健的商业曲目转向实验性的纹理质感。

歌词与人声工作流

支持纯提示词生成和自定义歌词模式，并可选择器乐和人声性别偏好。

支持异步集成

支持轮询或回调策略，可轻松集成到基于队列的后端工作流中。

你可以构建什么？

应用内音乐生成

为 UGC、短视频和社交创作工具生成品牌音乐片段及创作者友好型音轨。

播客与视频品牌推广

生成片头、片尾曲、转场音效和循环主题曲，且氛围和节奏可控。

短视频内容配乐

为 TikTok、Shorts 和 Reels 创建自定义背景音乐，围绕风格和歌词记忆点进行快速迭代。

游戏与交互音频

为游戏和交互式体验原型化环境循环音效、菜单主题和轻量化配乐构思。

备注与限制

每次生成将返回两个音轨；输出数量不可自定义。
演练场工作流采用异步优先模式；API 层面提供回调编排功能。
在支持的版本中，自定义模式的提示词/歌词长度上限为 5,000 个字符。
人声性别和人声特征属于尽力而为的控制，并非严格保证。

常见问题

开始构建

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

尝试 Playground 查看 API 文档

Suno V5

示例输出

什么是 Suno API？

生成工作流说明

Suno API 技术规格

输出

控制界面

生成模式

交付

核心能力

双轨道输出

创意控制滑块

歌词与人声工作流

支持异步集成

你可以构建什么？

应用内音乐生成

播客与视频品牌推广

短视频内容配乐

游戏与交互音频

备注与限制

常见问题

我可以只生成一条音轨而不是两条吗？

我可以强制要求精确的歌词输出吗？

此 API 是同步的吗？

返回什么文件类型？

开始构建