Skip to main content
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>"
  }
}
Create a personalized music Persona based on previously generated music.
To create the new Persona-v2 VOX version (singer style), you must first call the Vox API to obtain a vox_audio_id.

Authorizations

TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
music_id
string
required

歌曲id

name
string
required

名称

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

Request successful

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

data
object
required
Last modified on March 16, 2026