create persona

Note: Persona creation is available. For reliable results, build a persona from a recently generated song — very old source clips may no longer be usable upstream. If you get an error that the source is no longer available, regenerate the song and create the persona from that fresh clip. You're only charged when a persona is created successfully.

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

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

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

Usage#

Advanced: Using VOX Audio#

Request

Request Code Samples

Responses

Usage

Advanced: Using VOX Audio