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 requiredduration is an optional parameter and will only take effect when the model is prompt 3000 characters, style 200 charactersprompt 5000 characters, style 1000 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: 3000 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 'https://api.kie.ai/api/v1/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A calm and relaxing piano track with soft melodies",
"customMode": true,
"instrumental": true,
"model": "V4",
"callBackUrl": "https://api.example.com/callback",
"style": "Classical",
"title": "Peaceful Piano Meditation",
"negativeTags": "Heavy Metal, Upbeat Drums",
"vocalGender": "m",
"styleWeight": 0.65,
"weirdnessConstraint": 0.65,
"audioWeight": 0.65,
"personaId": "persona_123",
"personaModel": "style_persona",
"duration": 20
}'Response Response Example
200 - Example 1
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e"
}
}