Generate Music
POST
/api/v1/generate
Usage Guide
Parameter Details
customMode: true):instrumental: true: style and title are requiredinstrumental: false: style, prompt, and title are requiredprompt 3000 characters, style 200 charactersprompt 5000 characters, style 1000 charactersprompt 5000 characters, style 1000 charactersprompt 5000 characters, style 1000 characterstitle length limit: 80 characters (all models)customMode: false):prompt is required regardless of instrumental settingprompt length limit: 500 charactersDeveloper Notes
customMode: false for simpler usagetext (text generation), first (first track complete), complete (all tracks complete)Callbacks
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kie.ai/api/v1/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"prompt": "A calm and relaxing piano track with soft melodies",
"style": "Classical",
"title": "Peaceful Piano Meditation",
"customMode": true,
"instrumental": true,
"model": "V4",
"callBackUrl": "https://api.example.com/callback",
"negativeTags": "Heavy Metal, Upbeat Drums",
"vocalGender": "m",
"styleWeight": 0.65,
"weirdnessConstraint": 0.65,
"audioWeight": 0.65,
"personaId": "persona_123"
}'Response Response Example
200 - Example 1
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e"
}
}