Skip to main content
POST
custom 决定文本字段是否生效:custom=true(自定义)时 prompt 作歌词,title、style、negative_tags、auto_lyrics 和 persona_id 生效;custom=false(灵感)时 prompt 作灵感描述,上述自定义字段被忽略。style_weight、weirdness_constraint、audio_weight 和 vocal_gender 在两种模式下都会校验并生效。
本端点的字段名与其他端点略有不同:使用 style,而不是 tags。

Authorizations

string
必填
所有接口均需要使用Bearer Token进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

Body

string
默认值:"suno"
音频模型。当前传 suno(不传默认 suno)。
boolean
默认值:"false"
false=灵感模式;true=自定义模式(prompt 作歌词)。默认 false。
boolean
默认值:"false"
true=纯音乐、无人声。默认 false。
string
公共版本:v6 / v6-wild / v6-mini。与 custom_model_id 至少提供一个;使用自定义模型时省略本字段。
string
创建自定义模型任务返回的完整 UUID。与 version、persona_id 互斥;提供本字段后按自定义模型价格档计费。
string
灵感提示词 / 歌词。custom=false 时必填且不超过 3000 个字符;custom=true 且 instrumental=false 时必填且不超过 5000 个字符;自定义纯音乐可省略。
string
标题(自定义模式),不超过 80 个字符。custom=false(灵感模式)时忽略。
string
风格标签(自定义模式),不超过 1000 个字符。custom=false(灵感模式)时忽略。
string
负向风格标签(不希望出现的风格)。仅 custom=true 时生效。
boolean
true=对输入歌词进行二次创作。仅 custom=true 时生效。
string
Persona 风格 ID。仅 custom=true 时生效,与 custom_model_id 互斥。
string
人声性别:Male / Female(也接受 m / f / male / female,后端自动归一)。两种模式均生效。
number
风格权重,0.00–1.00。两种模式下都会校验并生效。
number
创意度,0.00–1.00。两种模式下都会校验并生效。
number
音频权重,0.00–1.00。两种模式下都会校验并生效。
string
风格变化程度:off / normal / high / extra / max。可省略,没有固定默认值。
boolean
默认值:"false"
是否启用 Max 模式。启用时要求 custom=true,并按普通售价的 2 倍计费。
string
输出音频格式:mp3 / m4a / wav。省略时由服务自动选择。
integer
目标生成时长,范围 10–360 秒,仅 custom=true 时可用。实际成品时长以任务结果为准。
获取结果:本接口为异步任务。提交后拿到 task_id,按 3–5s 间隔轮询 GET /v1/music/tasks/{task_id},直到 status 为 completed 或 failed(音乐生成通常 30–120s;生成中 status 可能为 pending 或 processing,progress 为 0–100 的整数且不保证按固定节点变化)。完成后在 data.result.music[] 取 audio_url(另有 image_url / video_url / title / duration 等)。失败时 data.error.message 为原因,自动退回预扣额度。

Response

integer
响应状态码
array
返回数据数组