修改、延续操作

对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

int

延长的歌曲从上一首歌曲的多少秒开始延长,单位秒

prompt

string

歌词,自定义模式专用

title

string

标题,自定义模式专用

tags

string

风格标签,自定义模式专用

generateVideo

boolean

是否需要生成音频的同时生成视频,可选值 true false,默认false

isStorage

boolean

是否转存,false即返回官方源地址。 可选值 true false,默认true

hookUrl

string

回调通知地址,当设置此参数,任务成功或者失败降会向该地址发送一个post请求,携带数据与查询任务结果中返回一致

Response

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

获取完整音乐【免费】

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

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

获取歌词时间线【免费】

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

{
  "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": "б"
      },
      ...
     ]
   }
}   

获取音乐视频【免费】

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

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

获取音乐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

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

词曲分离

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

{
  "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

{
  "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-v4

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

hookUrl

string

回调通知地址,当设置此参数,任务成功或者失败降会向该地址发送一个post请求,携带数据与查询任务结果中返回一致

Response

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

添加声线

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

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

Headers

Name
Value

Content-Type

application/json

TT-API-KEY

用于请求授权 TT-API 的API密钥

Body

参数
类型
是否必须
描述

music_id

string

通过上传返回的music_id,注意非jobId

mv

string

使用模型 suno使用模型,目前只支持chirp-v4-5+

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

hookUrl

string

回调通知地址,当设置此参数,任务成功或者失败降会向该地址发送一个post请求,携带数据与查询任务结果中返回一致

Response

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

添加伴奏

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

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

Headers

Name
Value

Content-Type

application/json

TT-API-KEY

用于请求授权 TT-API 的API密钥

Body

参数
类型
是否必须
描述

music_id

string

通过上传返回的music_id,注意非jobId

mv

string

使用模型 suno使用模型,目前只支持chirp-v4-5+

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

hookUrl

string

回调通知地址,当设置此参数,任务成功或者失败降会向该地址发送一个post请求,携带数据与查询任务结果中返回一致

Response

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

Last updated

Was this helpful?