上传音频并翻唱
-
直接用公网音频 URL 生成翻唱，无需先调用
suno-upload。 -
audio_url必填（公网 HTTP(S) 直链，建议不超过 8 分钟）。不要传本地路径或blob:URL。 -
version仅支持v6/v6-wild/v6-mini，省略默认v6。使用custom_model_id时省略version；custom_model_id与persona_id互斥。 -
建议显式传
custom。custom=false时gpt_description必填（不超过 3000 字）；custom=true且instrumental=false时prompt必填（不超过 5000 字）。 -
duration_s仅自定义模式，范围 10–360 秒。max_mode=true要求自定义模式，按普通售价的 2 倍计费。 -
提交接口：统一通过
POST /v1/music/generations提交，使用model: "suno-upload-cover"选择此能力。 -
任务查询：提交返回
task_id，通过GET /v1/music/generations/{task_id}获取任务状态和结果。
Authorization
BearerAuth
使用 MAPI Bearer Token 认证。格式：Authorization: Bearer sk-xxxxxx。
In: header
Request Body
application/json
固定填写 suno-upload-cover。
公网可访问的 HTTP(S) 音频直链，建议原音频不超过 8 分钟。本地路径、blob: URL 和需要登录的页面链接不可用。
uri公共版本：v6 / v6-wild / v6-mini。省略默认 v6。使用 custom_model_id 时省略。
"v6""v6" | "v6-wild" | "v6-mini"创建模型任务返回的完整 UUID。与 version、persona_id 互斥。
建议显式发送。false 使用 gpt_description；true 使用歌词和风格字段。
是否生成纯音乐。custom=true 且本字段为 false 时，prompt 必填。
false灵感描述，custom=false 时必填，不超过 3000 个字符。
length <= 3000自定义模式歌词，不超过 5000 个字符。
length <= 5000风格描述，不超过 1000 个字符。
length <= 1000标题，不超过 80 个字符。
length <= 80不希望出现的风格。
风格权重，范围 0–1。
0 <= value <= 1创意度权重，范围 0–1。
0 <= value <= 1音频权重，范围 0–1。
0 <= value <= 1是否对输入歌词进行二次创作。
人声性别：Male / Female。
"Male" | "Female"Persona ID，与 custom_model_id 互斥。
目标生成时长，范围 10–360 秒，仅自定义模式可用。
10 <= value <= 360风格变化程度：off / normal / high / extra / max。
"off" | "normal" | "high" | "extra" | "max"是否启用 Max 模式。启用时要求自定义模式，并按普通售价的 2 倍计费。
false输出格式：mp3 / m4a / wav。
"mp3" | "m4a" | "wav"Response Body
application/json
application/json
curl -X POST "https://loading/v1/music/generations" \ -H "Content-Type: application/json" \ -d '{ "model": "suno-upload-cover", "version": "v6", "audio_url": "https://example.com/reference.mp3", "custom": true, "instrumental": true, "tags": "piano, ambient", "duration_s": 120, "variety": "normal", "audio_format": "m4a" }'{
"code": 200,
"message": "success",
"data": [
{
"status": "submitted",
"task_id": "task_01M24YMN4EV04M84R5QYM77R1E"
}
]
}{
"code": "invalid_request",
"message": "audio_url is required",
"data": null
}最后更新于