Generate Persona
POST
/api/v1/jobs/createTask
Document updated
Create a personalized music Persona based on generated music, giving the music a unique identity and characteristics.
Usage Guide
task_id from music generation related endpoints (generate, extend) and audio IDParameter Details
task_id (Required): Can be obtained from the following endpoints:audio_id (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
task_id from music generated with models above v3.5 (v3.5 itself is not supported).persona_id can be used in subsequent music generation requests to create music with similar style characteristics.persona_id to the following endpoints:Parameter Example
{
"task_id": "5c79****be8e",
"audio_id": "e231****-****-****-****-****8cadc7dc",
"name": "Electronic Pop Singer",
"description": "A modern electronic music style pop singer, skilled in dynamic rhythms and synthesizer tones"
}NOTE
task_id is complete and the audio_id is within the valid range.TIP
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kie.ai/api/v1/jobs/createTask' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "ai-music-api/generate-persona",
"callBackUrl": "https://api.example.com/callback",
"input": {
"task_id": "5c79****be8e",
"audio_id": "e231****-****-****-****-****8cadc7dc",
"name": "Electronic Pop Singer",
"description": "A modern electronic music style pop singer, skilled in dynamic rhythms and synthesizer tones",
"vocal_start": 0,
"vocal_end": 30,
"style": "Electronic Pop"
}
}'Response Response Example
200 - Example 1
{
"code": 200,
"msg": "success",
"data": {
"persona_id": "a1b2****c3d4",
"name": "Electronic Pop Singer",
"description": "A modern electronic music style pop singer, skilled in dynamic rhythms and synthesizer tones"
}
}