Upload And Extend Audio
POST
/api/v1/generate/upload-extend
Upload and Extend Music
Parameter Usage Guide
Character Limits
When defaultParamFlag is true (Custom Parameter Mode):
instrumental: true: Provide style, title, and uploadUrl. prompt and vocalGender are not requiredinstrumental: false: Provide style, title, and uploadUrl. prompt is optional and will be used as a prompt if provided. vocalGender is not requiredcontinueAt: The point in seconds where the audio extension begins. It must be greater than 0 and less than the total duration of the uploaded audiouploadUrl: The URL of the audio file. The audio must not exceed 8 minutesWhen defaultParamFlag is false (Non-Custom Parameter Mode):
instrumental setting, only uploadUrl is requiredprompt is optional and will be used as a prompt if providedinstrumental is true, prompt and vocalGender are not requiredinstrumental is false and prompt is not provided, lyrics will be generated automaticallyDeveloper Notes
1.
2.
3.
4.
uploadUrl.Optional Parameters
| Parameter | Type | Description |
|---|---|---|
prompt | string | Describes how the music should be extended. Optional. If provided, it will be used as a prompt. Not required when instrumental is true. |
vocalGender | string | Vocal gender preference. m represents male vocals and f represents female vocals. Not required for this API. |
styleWeight | number | Controls adherence to the specified style. Range: 0–1, with up to two decimal places. Example: 0.65. |
weirdnessConstraint | number | Controls the level of creativity. Range: 0–1, with up to two decimal places. Example: 0.65. |
audioWeight | number | Controls the weight of audio elements. Range: 0–1, with up to two decimal places. Example: 0.65. |
personaId | string | Available only when defaultParamFlag is true. To generate a personaId, visit Generate Persona. |
Callbacks
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kie.ai/api/v1/generate/upload-extend' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"uploadUrl": "https://storage.example.com/upload",
"defaultParamFlag": true,
"instrumental": true,
"continueAt": 60,
"model": "V4",
"callBackUrl": "https://api.example.com/callback",
"prompt": "Extend the music with more relaxing notes",
"style": "Classical",
"title": "Peaceful Piano Extended",
"negativeTags": "Relaxing Piano",
"vocalGender": "m",
"styleWeight": 0.65,
"weirdnessConstraint": 0.65,
"audioWeight": 0.65,
"personaId": "persona_123",
"personaModel": "style_persona"
}'Response Response Example
200 - Example 1
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e"
}
}