Upload And Extend Audio
POST
/api/v1/generate/upload-extend
This API extends audio tracks while preserving their original style. It includes Suno's upload functionality, allowing users to upload audio files for processing. The expected result is a longer track that seamlessly continues the input style.
Parameter Usage Guide
Character Limits
style (max 1000 chars), title (max 100 chars), prompt (max 5000 chars)style (max 1000 chars), title (max 100 chars), prompt (max 5000 chars)style (max 1000 chars), title (max 80 chars), prompt (max 5000 chars)style (max 200 chars), title (max 80 chars), prompt (max 3000 chars)defaultParamFlag is true (Custom Parameters):instrumental is true: style, title, and uploadUrl are required.instrumental is false: style, prompt, title, and uploadUrl are required.continueAt: The time point in seconds from which to start extending (must be greater than 0 and less than the uploaded audio duration).uploadUrl: Specifies the upload location for audio files; ensure uploaded audio does not exceed 8 minutes.defaultParamFlag is false (Default Parameters):instrumental setting, only uploadUrl and prompt are required.Developer Notes
1.
2.
3.
4.
uploadUrl parameter specifies the upload location for audio files; provide a valid URL.Optional Parameters
vocalGender (string): Vocal gender preference. Use m for male, f for female.styleWeight (number): Strength of adherence to the style. Range 0–1, up to 2 decimal places. Example: 0.65.weirdnessConstraint (number): Controls creative deviation. Range 0–1, up to 2 decimal places. Example: 0.65.audioWeight (number): Balance weight for audio features. Range 0–1, up to 2 decimal places. Example: 0.65.personaId (string): Persona ID to apply to the generated music. Only available when Custom Mode is enabled (i.e., defaultParamFlag is true). To create one, use Generate Persona.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/upload-extend' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"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"
}
}