---
title: "create persona"
method: POST
path: "/api/v1/sonic/persona"
tags: ["sonic"]
---

# create persona

`POST /api/v1/sonic/persona`

## Request

- Base URL: `https://api.musicapi.ai`
- URL: `https://api.musicapi.ai/api/v1/sonic/persona`
- Auth: HTTP bearer

**Due to official restrictions, this is currently unavailable！**

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](create-music) endpoint to generate new songs using this voice.

## Advanced: Using VOX Audio

For more precise voice extraction, you can first use the [get VOX](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 body

- object
  - `name` string, required: Name for the persona. Max 80 characters.
  - `clip_id` string, required: The clip_id of the source song to extract voice from
  - `describe` string: Optional description of the persona's voice characteristics
  - `styles` string: Optional style tags for the persona. Max 2000 characters.
  - `vox_audio_id` string: Optional. The vox_audio_id from get VOX endpoint. When provided, vocal_start_s and vocal_end_s are required.
  - `vocal_start_s` number: Start time in seconds. Required when vox_audio_id is provided. **Must match the value used when creating the VOX audio.**
  - `vocal_end_s` number: End time in seconds. Required when vox_audio_id is provided. **Must match the value used when creating the VOX audio.**

## Response `200`

Success

- object
  - `code` integer, required: Response code
  - `persona_id` string, required: The unique ID of the created persona. Use this with create music with persona endpoint.
  - `message` string, required: Response message

---

[API](https://skmtc.dev/musicapi/apis/musicapi-docs-suno-style-ai-music-generation-api.md) - [All operations](https://skmtc.dev/musicapi/apis/musicapi-docs-suno-style-ai-music-generation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/musicapi/apis/musicapi-docs-suno-style-ai-music-generation-api/revisions/f94a2c7ed4a1?raw)