上传音频并翻唱
上传公网音频 URL，并使用 Suno V6 生成翻唱版本
本接口直接使用公开音频 URL 生成翻唱，无需先调用 uploadTask。提交后返回 task_id，通过 GET /v1/music/tasks/{task_id} 查询结果。
curl --request POST \
--url https://26j.cn/v1/music/generations/uploadCover \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno",
"version": "v6",
"audio_url": "https://example.com/reference.mp3",
"custom": true,
"instrumental": true,
"tags": "piano, ambient",
"duration_s": 120,
"variety": "normal",
"audio_format": "m4a"
}'
import requests
response = requests.post(
"https://26j.cn/v1/music/generations/uploadCover",
headers={"Authorization": "Bearer <token>"},
json={
"model": "suno",
"version": "v6",
"audio_url": "https://example.com/reference.mp3",
"custom": True,
"instrumental": True,
"tags": "piano, ambient",
"duration_s": 120,
"audio_format": "m4a",
},
)
print(response.json())
const response = await fetch("https://26j.cn/v1/music/generations/uploadCover", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "suno",
version: "v6",
audio_url: "https://example.com/reference.mp3",
custom: true,
instrumental: true,
tags: "piano, ambient",
duration_s: 120,
audio_format: "m4a"
})
});
console.log(await response.json());
Authorizations
Authorizationstring必填Bearer Token。访问 API Key 管理页面 获取 API Key。
Body
modelstring默认 suno固定使用 suno。
audio_urlstring必填公网可访问的 HTTP(S) 音频直链，建议原音频不超过 8 分钟。本地路径、blob: URL 和需要登录的页面链接不可用。
versionstring默认 v6公共版本：v6 / v6-wild / v6-mini。使用 custom_model_id 时省略。
custom_model_idstring创建模型任务返回的完整 UUID。与 version、persona_id 互斥。
customboolean建议显式发送。false 使用 gpt_description；true 使用歌词和风格字段。
instrumentalboolean默认 false是否生成纯音乐。custom=true 且本字段为 false 时，prompt 必填。
gpt_descriptionstring灵感描述，custom=false 时必填，不超过 3000 个字符。
promptstring自定义模式歌词，不超过 5000 个字符。
tagsstring风格描述，不超过 1000 个字符。
titlestring标题，不超过 80 个字符。
negative_tagsstring不希望出现的风格。
style_weightnumber风格权重，范围 0–1。
weirdnessnumber创意度权重，范围 0–1。
audio_weightnumber音频权重，范围 0–1。
auto_lyricsboolean是否对输入歌词进行二次创作。
vocal_genderstring人声性别：Male / Female。
persona_idstringPersona ID，与 custom_model_id 互斥。
duration_sinteger目标生成时长，范围 10–360 秒，仅自定义模式可用。
varietystring风格变化程度：off / normal / high / extra / max。
max_modeboolean默认 false是否启用 Max 模式。启用时要求自定义模式，并按普通售价的 2 倍计费。
audio_formatstring输出格式：mp3 / m4a / wav。
Response
codeinteger响应状态码。
dataarray提交结果，读取 data[0].task_id 并轮询任务查询接口。
{
"code": 200,
"data": [
{"status": "submitted", "task_id": "task_01M24YMN4EV04M84R5QYM77R1E"}
]
}
This documentation is built and hosted on Mintlify, a developer documentation platform.