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

Documentation Index

Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt

Use this file to discover all available pages before exploring further.

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

Song ID

​
name
string
required

Name

​
describe
string

Description

​
vox_audio_id
string

ID generated by the singer VOX endpoint. Uses the specified song segment to generate a singer style ID.

​
vocal_start_s
number

Required when vox_audio_id is provided. Use the same value as in the singer VOX endpoint request.

​
vocal_end_s
number

Required when vox_audio_id is provided. Use the same value as in the singer VOX endpoint request.

​
styles
string

Style

Response

Request successful

​
status
string
required
Example:

"SUCCESS"

​
message
string
required
Example:

"success"

​
data
object
required
Last modified on March 21, 2026