create persona

POST

https://api.musicapi.ai/api/v1/sonic/persona

Create a virtual singer (persona) from an existing song. The persona captures the vocal characteristics and can be used permanently to generate new songs with the same voice.

Credits cost: 1

Usage

After creating a persona, use the returned persona_id with the create music with persona endpoint to generate new songs using this voice.

Advanced: Using VOX Audio

For more precise voice extraction, you can first use the get VOX endpoint to extract vocals, then provide the vox_audio_id along with the time range to create a persona from a specific vocal segment.

Important: When using vox_audio_id, the vocal_start_s and vocal_end_s values must match exactly with the values used when creating the VOX audio. For example, if you created the VOX with vocal_start_s: 10, vocal_end_s: 40, you must use the same values here.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/json

Examples

Basic usageWith description and stylesUsing VOX audio for precise extraction

{
    "name": "My Singer Voice",
    "clip_id": "042e3c92-057d-4b43-800f-b7e4daf43521"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Basic usageWith description and stylesUsing VOX audio for precise extraction

curl --location --request POST 'https://api.musicapi.ai/api/v1/sonic/persona' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "My Singer Voice",
    "clip_id": "042e3c92-057d-4b43-800f-b7e4daf43521"
}'

Responses

🟢200success

application/json

Success

Body

Example

{
    "code": 200,
    "persona_id": "c08806c1-34fa-4290-a78d-0c623eb1dd1c",
    "message": "success"
}

Modified at 2026-01-16 05:52:54

upload and cover music

sample