跳转到主要内容
POST
/
suno
/
v1
/
persona
cURL
curl --request POST \
  --url https://api.ttapi.io/suno/v1/persona \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "music_id": "<string>",
  "name": "<string>",
  "describe": "<string>",
  "vox_audio_id": "<string>",
  "vocal_start_s": 123,
  "vocal_end_s": 123,
  "styles": "<string>"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "persona_id": "<string>"
  }
}
基于已生成的音乐创建个性化的音乐 Persona
创建新版的Persona-v2-vox版:歌手风格,需要先调用 获取 VOX 接口来获取vox_audio_id。

授权

TT-API-KEY
string
header
必填

授权字段,控制台获取授权信息

请求体

application/json
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

风格

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

data
object
必填
Last modified on March 12, 2026