Generate Persona
POST
/api/v1/generate/generate-persona
Create a personalized music Persona based on generated music, giving the music a unique identity and characteristics.
Usage Guide
taskId from music generation related endpoints (generate, extend, cover, upload-extend) and audio IDParameter Details
taskId (Required): Can be obtained from the following endpoints:/api/v1/generate)/api/v1/generate/extend)/api/v1/generate/upload-cover)/api/v1/generate/upload-extend)audioId (Required): Specifies the audio ID to create Persona forname (Required): Assigns an easily recognizable name to the Personadescription (Required): Describes the Persona's musical characteristics, style, and personalityDeveloper Notes
Important Requirements
taskId from music generated with models above v3.5 (v3.5 itself is not supported).personaId can be used in subsequent music generation requests to create music with similar style characteristics.personaId to the following endpoints:Parameter Example
{
"taskId": "5c79****be8e",
"audioId": "e231****-****-****-****-****8cadc7dc",
"name": "Electronic Pop Singer",
"description": "A modern electronic music style pop singer, skilled in dynamic rhythms and synthesizer tones"
}NOTE
taskId is complete and the audioId is within the valid range.TIP
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kie.ai/api/v1/generate/generate-persona' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"taskId": "5c79****be8e",
"audioId": "e231****-****-****-****-****8cadc7dc",
"name": "Electronic Pop Singer",
"description": "A modern electronic music style pop singer, skilled in dynamic rhythms and synthesizer tones",
"vocalStart": 0,
"vocalEnd": 30,
"style": "Electronic Pop"
}'Response Response Example
200 - Example 1
{
"code": 200,
"msg": "success",
"data": {
"personaId": "a1b2****c3d4",
"name": "Electronic Pop Singer",
"description": "A modern electronic music style pop singer, skilled in dynamic rhythms and synthesizer tones"
}
}