Skip to main content
POST
https://api.mountsea.ai
/
suno
/
v2
/
persona
Create Persona
curl --request POST \
  --url https://api.mountsea.ai/suno/v2/persona \
  --header 'Content-Type: application/json' \
  --data '
{
  "clip_id": "<string>",
  "name": "<string>",
  "is_public": true,
  "description": "<string>",
  "persona_type": "<string>",
  "vox_audio_id": "<string>",
  "vocal_start_s": 123,
  "vocal_end_s": 123,
  "user_input_styles": "<string>",
  "image_s3_id": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "persona_type": "<string>",
  "is_public": true,
  "clip": {},
  "vocal_start_s": 123,
  "vocal_end_s": 123
}
Create a persona based on an audio clip. Personas can be used to generate music with consistent vocal characteristics.
This endpoint returns the created persona directly (not a task ID). For vocal personas (persona_type: "vox"), first extract the vocal stem using Get Vox Stem.

​
Request Body

​
clip_id
string
required
The audio clip ID to create persona from.
​
name
string
required
The name of the persona.
​
is_public
boolean
default:true
required
Whether the persona is publicly accessible.
​
description
string
A description of the persona.
​
persona_type
string
The type of persona. Use "vox" for vocal personas.
​
vox_audio_id
string
The vox audio ID returned from Get Vox Stem. Required for vocal personas.
​
vocal_start_s
number
The start time (in seconds) of the vocal segment to use.
​
vocal_end_s
number
The end time (in seconds) of the vocal segment to use.
​
user_input_styles
string
Style tags describing the persona (e.g., “soulful vocals, R&B, smooth harmonies”).
​
image_s3_id
string
Base64 encoded image for the persona avatar (format: data:image/png;base64,...).

​
Response

The response contains the complete persona object with all details.
​
id
string
The created persona ID.
​
name
string
The persona name.
​
description
string
The persona description.
​
persona_type
string
The type of persona (e.g., "vox").
​
is_public
boolean
Whether the persona is public.
​
clip
object
The source clip information.
​
vocal_start_s
number
The vocal start time.
​
vocal_end_s
number
The vocal end time.

​
Example

curl -X POST https://api.mountsea.ai/suno/v2/persona \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "clip_id": "316c630b-284b-4fbd-9b35-f0551d4b98da",
    "name": "My Vocal Persona",
    "description": "A soulful R&B voice",
    "is_public": true,
    "persona_type": "vox",
    "vox_audio_id": "373efa9c-a366-42bb-806c-afdfc9b306a7",
    "vocal_start_s": 16.13,
    "vocal_end_s": 46.13,
    "user_input_styles": "soulful vocals, R&B, smooth harmonies"
  }'

​
Response Example

{
  "id": "61515b86-62f5-427a-bc29-6befa382536a",
  "name": "My Vocal Persona",
  "description": "A soulful R&B voice",
  "image_s3_id": "https://cdn2.suno.ai/image_316c630b-284b-4fbd-9b35-f0551d4b98da.jpeg",
  "root_clip_id": "316c630b-284b-4fbd-9b35-f0551d4b98da",
  "clip": {
    "id": "316c630b-284b-4fbd-9b35-f0551d4b98da",
    "status": "complete",
    "title": "Roadtrip Sunrise",
    "audio_url": "https://cdn1.suno.ai/316c630b-284b-4fbd-9b35-f0551d4b98da.mp3",
    "image_url": "https://cdn2.suno.ai/image_316c630b-284b-4fbd-9b35-f0551d4b98da.jpeg"
  },
  "persona_type": "vox",
  "is_public": true,
  "user_input_styles": "soulful vocals, R&B, smooth harmonies",
  "vocal_start_s": 16.13,
  "vocal_end_s": 46.13,
  "vocal_clip_id": "70149747-3f33-4e56-a4f4-8c44c30d7a0f",
  "upvote_count": 0,
  "clip_count": 1,
  "follower_count": 0
}

​
Workflow: Creating a Vocal Persona

For creating a vocal persona, follow these steps: 
// Step 1: Get vox stem to extract vocals
const voxResponse = await fetch('https://api.mountsea.ai/suno/v2/getVoxStem', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your-api-key'
  },
  body: JSON.stringify({ clip_id: 'your-clip-id' })
});
const voxData = await voxResponse.json();
// voxData.id is the vox_audio_id to use

// Step 2: Create persona with the extracted vox audio
const personaResponse = await fetch('https://api.mountsea.ai/suno/v2/persona', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your-api-key'
  },
  body: JSON.stringify({
    clip_id: 'your-clip-id',
    name: 'My Vocal Persona',
    is_public: true,
    persona_type: 'vox',
    vox_audio_id: voxData.id,
    vocal_start_s: voxData.vocal_start_s,
    vocal_end_s: voxData.vocal_end_s,
    user_input_styles: 'your style description'
  })
});
const persona = await personaResponse.json();
console.log('Persona created:', persona.id);
Once created, personas can be used in the Generate Music endpoint via the persona parameter to create music with consistent vocal characteristics.