sonic

create persona

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 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.

post/api/v1/sonic/persona

Request

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

Request body

namestring required

Name for the persona. Max 80 characters.

clip_idstring required

The clip_id of the source song to extract voice from

describestring

Optional description of the persona's voice characteristics

stylesstring

Optional style tags for the persona. Max 2000 characters.

vox_audio_idstring

Optional. The vox_audio_id from get VOX endpoint. When provided, vocal_start_s and vocal_end_s are required.

vocal_start_snumber

Start time in seconds. Required when vox_audio_id is provided. Must match the value used when creating the VOX audio.

vocal_end_snumber

End time in seconds. Required when vox_audio_id is provided. Must match the value used when creating the VOX audio.

Response

Success

codeinteger required

Response code

persona_idstring required

The unique ID of the created persona. Use this with create music with persona endpoint.

messagestring required

Response message

Changes

No recorded changes to this operation across all 1 revision of this API.