跳转到主要内容
POST
音色提取
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 suno/persona,参数放进 input。两种写法效果与计费完全一样。
任务成功后,data.persona_id 是创建出的音色 ID。生成、翻唱、续写时填进 persona_id,就会用这个音色演唱。

授权

Authorization
string
header
必填

在请求头 Authorization: Bearer YOUR_API_KEY 里带上 API Key。

请求体

application/json
music_id
string
必填

源曲目:要处理的曲目,填之前生成结果里的 music_id。

name
string
必填

名称:给创建出来的音色或模型起个名字。

describe
string

说明:对这个音色的补充说明。

vocal_start_s
number

人声起点:从第几秒开始取这段人声。与人声终点一起填,区间须短于 30 秒。

必填范围: x >= 0
vocal_end_s
number

人声终点:取到第几秒结束。须大于人声起点,且区间短于 30 秒。

styles
string

适合风格:这个音色适合演绎的曲风。

notify_hook
string<uri>

推送地址:任务结束后,把和查询结果相同的内容 POST 到这个地址(公网可以访问的 http / https 地址)。不传就自己查询。

响应

OK

code
enum<string>
必填
可用选项:
success
data
object
必填
message
string