Skip to main content
POST
/
suno
/
v2
/
voicePersona
/
create
create voice persona
curl --request POST \
  --url https://api.mountsea.ai/suno/v2/voicePersona/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "vox_audio_id": "<string>",
  "voice_recording_id": "<string>",
  "phrase_id": "<string>",
  "verification_audio_url": "https://example.com/verification.wav",
  "vocal_start_s": 0,
  "vocal_end_s": 12.6,
  "name": "My Voice",
  "description": "<string>",
  "is_public": false,
  "image_s3_id": "<string>"
}
'
{
  "taskId": "15c257ff-43f7-4678-bd41-202ad6b8488b"
}
This is Step 2 of the Voice Persona creation workflow. You must complete Step 1: Init first to get the required parameters. See the full workflow guide.
All fields marked as “from init result” (vox_audio_id, voice_recording_id, phrase_id, vocal_start_s, vocal_end_s) should be passed directly from the init task result without modification.
The verification_audio_url must contain a clear recording of the user reading the full phrase_text from the init step. Incomplete or unclear recordings will cause voice verification to fail.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
vox_audio_id
string
required

init 步骤返回的人声音频 ID，同时用于同账号匹配

​
voice_recording_id
string
required

init 步骤返回的录音 ID

​
phrase_id
string
required

init 步骤返回的验证短语 ID

​
verification_audio_url
string<uri>
required

用户朗读验证短语后的录音 URL（WAV/MP3）

Example:

"https://example.com/verification.wav"

​
vocal_start_s
number
required

人声起始秒（init 步骤返回值）

Example:

0

​
vocal_end_s
number
required

人声结束秒（init 步骤返回值）

Example:

12.6

​
name
string
required

Persona 名称

Example:

"My Voice"

​
description
string

Persona 描述

​
is_public
boolean

是否公开，默认 false

Example:

false

​
image_s3_id
string

封面图片（base64 或 null 自动生成）

Response

201 - application/json
​
taskId
string
required

task id. Use this id to query task status.

Example:

"15c257ff-43f7-4678-bd41-202ad6b8488b"