修改、延续操作

对Suno生成的或者用户上传的音乐进行后续操作。修改、延伸、视频生成、多音频合成、MAW格式生成等等操作。

音乐延伸

POST https://api.ttapi.io/suno/v1/extend

延伸生成音乐返回的两首歌其中的一首

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	歌曲ID，需要延长的歌曲
continue_at	number	是	延长的歌曲从上一首歌曲的多少秒开始延长，单位秒
prompt	string	否	歌词，自定义模式专用
title	string	否	标题，自定义模式专用
tags	string	否	风格标签，自定义模式专用
negative_tags	string	否	不希望生成的风格标签，自定义模式专用
style_weight	number	否	音频风格权重 0-1之间，自定义模式专用
weirdness_constraint	number	否	音频奇妙度权重 0-1之间，自定义模式专用
audio_weight	number	否	音频权重 0-1之间，自定义模式专用
auto_lyrics	boolean	否	是否自动生成歌词 自定义模式专用。 false - 使用输入的歌词生成音乐 true - 根据输入的歌词进行二次创作，与灵感模式提示词效果一致 默认false
vocal_gender	string	否	音色性别 Male - 男性 Female - 女性
persona_id	string	否	歌手风格ID
isStorage	boolean	否	是否转存，false即返回官方源地址。 可选值 true false，默认true
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

获取完整音乐【免费】

POST https://api.ttapi.io/suno/v1/concat

获取延长音乐后的完整音乐内容，此接口免费

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	歌曲ID，上一步返回的music_id
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

获取歌词时间线【免费】

POST https://api.ttapi.io/suno/v1/alignedLyrics

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	返回在每条歌曲数组中的musicId，注意非jobId

Response

200

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "alignment": [
      {
        "end_s": 0.4787234042553192,
        "p_align": 1,
        "start_s": 0.39893617021276595,
        "success": true,
        "word": "[female voice][female vocals][verse]\nЧто"
      },
      {
        "end_s": 0.5585106382978724,
        "p_align": 1,
        "start_s": 0.4787234042553192,
        "success": true,
        "word": "б"
      },
      ...
     ]
   }
}   

400

获取音乐视频【免费】

POST https://api.ttapi.io/suno/v1/generateVideo

根据任务结果，生成音乐对应的视频，此接口为免费接口

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	返回在每条歌曲数组中的musicId，注意非jobId

Response

200

{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "videoUrl": "https://cdn1.suno.ai/f01dcb24-d479-4f00-9a71-958792e23212.mp4",
        "status": "complete"
    }
}

400

获取音乐WAV文件【免费】

POST https://api.ttapi.io/suno/v1/wav

根据任务结果，生成音乐对应的wav文件，此接口为免费接口

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	返回在每条歌曲数组中的musicId，注意非jobId

Response

200

{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "wavUrl": "https://cdn1.suno.ai/2ecd43e6-7a6a-4eb1-b203-1125493ed887.wav"
    }
}

400

词曲分离

POST https://api.ttapi.io/suno/v1/stems

根据任务结果，生成4条音频，实现歌词与背景音乐分离定价详见，

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	返回在每条歌曲数组中的musicId，注意非jobId
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

全轨道词曲分离

POST https://api.ttapi.io/suno/v1/stems-all

根据任务结果，生成24条音频，实现歌词与背景音乐分离，把音乐中所有乐器和歌词声音进行分离 定价详见，

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	返回在每条歌曲数组中的musicId，注意非jobId
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

音乐翻版

POST https://api.ttapi.io/suno/v1/cover

音乐翻版，修改风格，可使用suno生成或者你自己上传的音乐，定价详见

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	返回在每条歌曲数组中的musicId或者通过上传返回的music_id，注意非jobId
mv	string	是	使用模型 suno使用模型，支持 chirp-v3-0 chirp-v3-5 chirp-v4 chirp-v4-5 chirp-v4-5+ chirp-v5 chirp-v4-5-all
prompt	string	是	歌词
title	string	否	标题
tags	string	否	风格标签，自定义模式专用，最大长度200字符
negative_tags	string	否	不希望生成的风格标签
style_weight	number	否	音频风格权重 0-1之间
weirdness_constraint	number	否	音频奇妙度权重 0-1之间
audio_weight	number	否	音频权重 0-1之间
isStorage	boolean	否	是否转存，false即返回官方源地址。 可选值 true false，默认true
vocal_gender	string	否	音色性别 Male - 男性 Female - 女性
persona_id	string	否	歌手风格ID
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

添加声线

POST https://api.ttapi.io/suno/v1/add-vocals

添加音乐声线，只能对自己上传的音乐进行此操作，定价详见

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
custom	boolean	是	音频是否自定义 true - 音频将从歌词中生成 false - 音频将根据提示生成
music_id	string	是	通过上传返回的music_id，注意非jobId
gpt_description_prompt	string	是	灵感模式提示词
mv	string	是	使用模型 chirp-v4-5+ chirp-v5
prompt	string	是	歌词
title	string	否	标题
tags	string	否	风格标签，自定义模式专用，最大长度200字符
negative_tags	string	否	不希望生成的风格标签
style_weight	number	否	音频风格权重 0-1之间
weirdness_constraint	number	否	音频奇妙度权重 0-1之间
audio_weight	number	否	音频权重 0-1之间
isStorage	boolean	否	是否转存，false即返回官方源地址。 可选值 true false，默认true
vocal_gender	string	否	音色性别 Male - 男性 Female - 女性
overpainting_start_s	number	否	上传音乐添加人声的开始时间, 默认为0 单位秒
overpainting_end_s	number	否	上传的歌曲添加人声的结束时间 必须小于歌曲的总时长 单位秒
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

添加伴奏

POST https://api.ttapi.io/suno/v1/add-instrumental

添加音乐伴奏，只能对自己上传的音乐进行此操作，定价详见

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
custom	boolean	是	音频是否自定义 true - 音频将从歌词中生成 false - 音频将根据提示生成
music_id	string	是	通过上传返回的music_id，注意非jobId
gpt_description_prompt	string	是	灵感模式提示词
mv	string	是	使用模型 chirp-v4-5+ chirp-v5
prompt	string	否	歌词
title	string	否	标题
tags	string	否	风格标签，自定义模式专用，最大长度200字符
negative_tags	string	否	不希望生成的风格标签
style_weight	number	否	音频风格权重 0-1之间
weirdness_constraint	number	否	音频奇妙度权重 0-1之间
audio_weight	number	否	音频权重 0-1之间
isStorage	boolean	否	是否转存，false即返回官方源地址。 可选值 true false，默认true
underpainting_start_s	number	否	上传音乐添加人声的开始时间, 默认为0 单位秒
underpainting_end_s	number	否	上传的歌曲添加人声的结束时间 必须小于歌曲的总时长 单位秒
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

替换片段

POST https://api.ttapi.io/suno/v1/replace-section

替换歌词片段生成新的音乐，定价详见

提示：替换的歌词 要跟原来的歌词有重复的地方，最好相应的时间能对应上

infill_lyrics：表示你要填充或替换进去的“最新歌词片段”。 prompt：表示上下文，需要把“新歌词”前后的原歌词拼接起来。

例子：原歌词是 [Verse 1]AA [Chorus]BB [Verse 2] CC [Chorus]DD [Outro]EE，如果你想把 CC 替换为 OO infill_lyrics 就传 OO（要替换的新歌词）。 prompt 就传 BB [Verse 2]OO[Chorus]DD （在新歌词 OO 前后，保留一部分原歌词，拼成上下文）。

这样就能根据 prompt 的上下文和 infill_lyrics 的新歌词片段，生成最佳的结果。

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	音乐ID
mv	string	是	使用模型 chirp-v4-5+ chirp-v4-5 chirp-v4 chirp-v5 默认chirp-v4-5+
prompt	string	否	上下文歌词
infill_lyrics	string	否	新歌词
infill_start_s	number	是	开始替换时间，单位：秒
infill_end_s	number	是	结束替换时间，单位：秒
title	string	否	标题
tags	string	否	风格标签
negative_tags	string	否	不想要的风格
isStorage	boolean	否	是否转存，false即返回官方源地址。 可选值 true false，默认true
hookUrl	string	否	回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

200

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

400

获取音乐MIDI文件【免费】

POST https://api.ttapi.io/suno/v1/gen-midi

获取生成音乐对应的MIDI文件，此接口为免费接口

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	通过 stems-词曲分离 或 all-stems-全轨声曲分离 获取其中的一首歌的 music_id 注意： 普通音乐的 music_id 也能执行，官网只支持词曲分离和全轨分离任务的 music_id 不可跨账号执行，任务存在有效时限

Response

200（生成中）

{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "state": "running"
    }
}

200（成功）

400

重制音乐

POST https://api.ttapi.io/suno/v1/remaster

对生成的音乐进行重制，音质提升，对用Suno AI Remaster功能

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	生成接口返回的musicId，不可跨账号，账号用光下线后将不可调用，如需要相关操作请尽快执行
mv	string	是	使用模型 chirp-v4-5+ chirp-v4 chirp-v5 默认chirp-v5
variation_category	string	否	控制歌曲被转换程度，chirp-v5 模型下支持此参数 可选范围：subtle normal high

Response

200

{
    "status": "SUCCESS",
    "message": "success",
    "data": {
       "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
    }
}

400

歌手风格自定义

POST https://api.ttapi.io/suno/v1/persona

根据生成的歌曲提取歌手风格ID

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
music_id	string	是	生成接口返回的musicId，不可跨账号，账号用光下线后将不可调用，如需要相关操作请尽快执行
name	string	是	歌手名称
describe	string	否	歌手描述

Response

200

{
    "status": "string",
    "message": "string",
    "data": {
        "persona_id": "string"
    }
}

400