Suno Stems API 文档

curl --request POST \ --url https://api.ttapi.io/suno/v1/stems \ --header 'Content-Type: application/json' \ --header 'TT-API-KEY: <api-key>' \ --data ' { "music_id": "<string>", "isStorage": true, "hookUrl": "<string>", "stem_type": "lead_vocal" } '

授权

TT-API-KEY

string

header

必填

请前往 TTAPI 控制台获取 API 密钥。

请求体

application/json

music_id

string

必填

要分离的音轨的音频ID

isStorage

boolean

默认值:true

是否转存

true：音频将进行转存，返回TTAPI CDN地址
false：返回官方源地址

hookUrl

string

回调通知地址

stem_type

enum<string>

默认值:lead_vocal

要提取的分轨类型。默认 lead_vocal。可传 bass、piano、drum_kit、electric_guitar 等支持的枚举 code，用于提取指定乐器或人声分轨。

可用选项:

lead_vocal,

drum_kit,

bass,

backing_vocals,

piano,

electric_guitar,

percussion,

string_section,

synth,

acoustic_guitar,

sound_effects,

synth_pad,

synth_bass,

guitar,

brass_section,

organ,

electronic_drum_kit,

lead_electric_guitar,

synth_keys,

rhythm_electric_guitar,

electric_piano,

upright_bass,

keyboards,

distorted_electric_guitar,

kick,

snare,

risers,

synth_strings,

synth_lead,

woodwinds,

flute,

harp,

tambourine,

trumpet,

arpeggiator,

accordion,

fiddle,

pedal_steel_guitar,

synth_voice,

violin,

digital_piano,

synth_brass,

mandolin,

choir,

banjo,

bells,

clarinet,

tenor_saxophone,

trombone,

shaker,

french_horn,

glockenspiel,

electric_bass,

cello,

timpani,

harmonica,

marimba,

vibraphone,

lap_steel_guitar,

saxophone,

orchestra,

horns,

cymbals,

hand_clap,

oboe,

celesta,

congas,

drone,

alto_saxophone,

double_bass,

ukulele,

harpsichord,

baritone_saxophone,

xylophone,

tuba,

bass_guitar,

whistle,

lead_guitar,

rhodes,

808,

bongos,

bassoon,

cowbell,

viola,

sitar,

steel_drums,

piccolo,

theremin,

bagpipes,

hi_hat,

music_box,

melodica,

tabla,

koto,

djembe,

taiko,

didgeridoo

响应

请求成功

status

string

必填

示例:

"SUCCESS"

message

string

必填

示例:

"success"

data

object

必填

示例:

{
  "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}