修改、延续操作

对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

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

custom

boolean

是

音频是否自定义 true - 音频将从歌词中生成 false - 音频将根据提示生成

string

是

使用模型 suno使用模型，支持 chirp-v3-0 chirp-v3-5 chirp-v4 chirp-v4-5

chirp-v4-5+ chirp-v5 chirp-v4-5-all

prompt

string

否

歌词

gpt_description_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

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

参数

类型

是否必须

描述

custom

boolean

是

音频是否自定义 true - 音频将从歌词中生成 false - 音频将根据提示生成

music_id

string

是

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

gpt_description_prompt

string

是

灵感模式提示词

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

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

参数

类型

是否必须

描述

custom

boolean

是

音频是否自定义 true - 音频将从歌词中生成 false - 音频将根据提示生成

music_id

string

是

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

gpt_description_prompt

string

否

灵感模式提示词

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

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

替换片段

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

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

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

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

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

{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "state": "complete",
        "instruments": [
            {
                "name": "Synth Voice",
                "notes": [
                    {
                        "pitch": 60, "start": 11.166666666666666, "end": 11.333333333333334, "velocity": 0.49606299212598426
                    },
                    {
                        "pitch": 60, "start": 11.5, "end": 11.666666666666666, "velocity": 0.49606299212598426
                    },
                    {
                        "pitch": 60, "start": 11.833333333333334, "end": 12, "velocity": 0.49606299212598426
                    },
                    {
                        "pitch": 58, "start": 12.166666666666666, "end": 12.333333333333334, "velocity": 0.49606299212598426
                    },
                    {
                        "pitch": 58, "start": 12.5, "end": 12.666666666666666, "velocity": 0.49606299212598426
                    },
                    {
                        "pitch": 60, "start": 12.833333333333334, "end": 13, "velocity": 0.49606299212598426
                    },
                    ...
                ]
            }
        ]
    }
}

重制音乐

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，不可跨账号，账号用光下线后将不可调用，如需要相关操作请尽快执行

string

是

使用模型 chirp-v4-5+ chirp-v4 chirp-v5 默认chirp-v5

variation_category

string

否

控制歌曲被转换程度，chirp-v5 模型下支持此参数可选范围：subtle normal high

Response

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

歌手风格自定义【免费】

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

是

音乐ID

name

string

是

歌手名称

describe

string

_否

歌手描述

vox_audio_id

string

否

获取歌手VOX接口中生成的ID，指定片段的歌曲作为依据生成歌手风格ID

vocal_start_s

number

否

如果传入 vox_audio_id 此参数为必传，值与 获取歌手VOX接口 中入参一致

vocal_end_s

number

否

如果传入 vox_audio_id 此参数为必传，值与 获取歌手VOX接口 中入参一致

styles

string

否

风格

Response

{
    "status": "string",
    "message": "string",
    "data": {
        "persona_id": "string" //用在生成音乐接口中指定人声
    }
}

生成BPM【免费】

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

根据生成的歌曲生成BPM

Headers

Name

Value

Content-Type

application/json

TT-API-KEY

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

Body

参数

类型

是否必须

描述

music_id

string

是

音乐ID

Response

{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "avg_bpm": "", //平均bpm
        "max_bpm":"", //最大bpm
        "min_bpm":""  //最小bpm
    }
}

获取歌手VOX【免费】

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

截取音乐片段获取歌手的 vox_audio_id

Headers

Name

Value

Content-Type

application/json

TT-API-KEY

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

Body

参数

类型

是否必须

描述

music_id

string

是

音乐ID

vocal_start_s

number

否

人声开始时间，单位秒

vocal_end_s

number

否

人声结束时间，单位秒 注意：结束时间 - 开始时间应大于0，小于等于30

Response

{
    "status": "string",
    "message": "string",
    "data": {
        "id": "string", // vox_audio_id 用做“歌手风格自定义”中的入参
        "status": "string", //状态
        "source_clip_id": "string", //原始音乐ID
        "vocal_start_s": 0, //人声开始时间，单位秒
        "vocal_end_s": 0, //人声结束时间，单位秒
        "wave_response": {
            "waveform_aggregates": [
                {
                    "mip_map_level": 0,
                    "data": [
                        [
                            0
                        ]
                    ]
                }
            ]
        }
    }
}

TAG风格增强【免费】

POST https://api.ttapi.io/suno/v1/upsample-tags

音乐tag风格增强

Headers

Name

Value

Content-Type

application/json

TT-API-KEY

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

Body

参数

类型

是否必须

描述

tags

string

是

风格

Response

{
    "status": "string",
    "message": "string",
    "data": {
        "upsampled_tags": "string" //增强后的风格
    }
}

音乐合成-Mashup

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

根据两首歌曲混合生成一首新的歌曲，定价详见

Headers

Name

Value

Content-Type

application/json

TT-API-KEY

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

Body

参数

类型

是否必须

描述

mashup_music_id

array

是

混合音乐ID列表，必须为两首音乐 ['xxx','xxx'] 返回在每条歌曲数组中的musicId或者通过上传返回的music_id，注意非jobId

custom

boolean

是

音频是否自定义 true - 音频将从歌词中生成 false - 音频将根据提示生成

string

是

使用模型 suno使用模型，支持 chirp-v3-5 chirp-v4 chirp-v4-5

chirp-v4-5+ chirp-v5 chirp-v4-5-all

prompt

string

否

歌词

gpt_description_prompt

string

否

灵感模式提示词

instrumental

boolean

否

是否生成纯音乐默认 false

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 - 女性

auto_lyrics

boolean

否

是否自动生成歌词,自定义模式专用 false - 使用输入的歌词生成音乐 true - 根据输入的歌词进行二次创作，与灵感模式提示词效果一致默认 false

hookUrl

string

否

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

Response

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

Previous生成 & 查询 NextProducer API

Last updated 3 minutes ago

hashtag音乐延伸

hashtag获取完整音乐【免费】

hashtag获取歌词时间线【免费】

hashtag获取音乐视频【免费】

hashtag获取音乐WAV文件【免费】

hashtag词曲分离

hashtag全轨道词曲分离

hashtag音乐翻版

hashtag添加声线

hashtag添加伴奏

hashtag替换片段

hashtag获取音乐MIDI文件【免费】

hashtag重制音乐

hashtag歌手风格自定义【免费】

hashtag生成BPM【免费】

hashtag获取歌手VOX【免费】

hashtagTAG风格增强【免费】

hashtag音乐合成-Mashup

音乐延伸

获取完整音乐【免费】

获取歌词时间线【免费】

获取音乐视频【免费】

获取音乐WAV文件【免费】

词曲分离

全轨道词曲分离

音乐翻版

添加声线

添加伴奏

替换片段

获取音乐MIDI文件【免费】

重制音乐

歌手风格自定义【免费】

生成BPM【免费】

获取歌手VOX【免费】

TAG风格增强【免费】

音乐合成-Mashup