歌曲拼接

POST  v1/suno/submit/concat

请求参数

Authorization

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 Token。

Authorization: Bearer ******************

Body 参数

Content-Type: application/json

参数名	类型	必填	说明
clip_id	string	必需	片段ID。通常用于指定关联的音频片段，可能是续写或修补的基础。
is_infill	boolean	必需	是否修补。布尔值，指示当前操作是否为“修补”模式（即在现有音频中间插入内容）。
prompt	string	可选	歌词/提示词。具体的歌词内容或音乐描述。
mv	string	可选	模型版本。可选 chirp-v3-0 或 chirp-v3-5，不填默认为 chirp-v3-0。
title	string	可选	标题。自定义模式下使用，指定歌曲名。
tags	string	可选	风格标签。自定义模式下使用，如 "Pop, Emotional"。
make_instrumental	boolean	可选	纯音乐。设为 true 则生成无歌词的伴奏。
task_id	string	可选	任务ID。用于关联之前的任务进行后续操作。
continue_at	number	可选	续写时间点。Float类型，单位秒，指定歌曲延长的起始时间。
continue_clip_id	string	可选	续写源ID。指定需要续写的那首歌的 Clip ID。
gpt_description_prompt	string	可选	灵感模式提示词。用于让 AI 自动生成歌词和曲调的描述词。
notify_hook	string	可选	回调地址。任务完成后服务器通知的 URL。

请求示例 (JSON)

{
    "clip_id": "extend 后的 歌曲ID",
    "is_infill": false
}

返回响应

200 成功

Content-Type: application/json

响应参数

字段名	类型	必填	说明
code	string	必需	状态码。
message	string	必需	提示信息。
data	string	必需	数据载荷。

响应示例

{
    "code": "success",
    "message": "",
    "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}

示例代码

import http.client
import json

conn = http.client.HTTPSConnection("nxaiapp.com")
payload = json.dumps({
   "clip_id": "extend 后的 歌曲ID",
   "is_infill": False
})
headers = {
   'Authorization': 'Bearer <token>',
   'Content-Type': 'application/json'
}
conn.request("POST", "/v1/suno/submit/concat", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))