Upload And Cover Audio
POST
/api/v1/generate/upload-cover
This API creates a cover version of an audio track by transforming it into a new style while retaining its core melody. It incorporates Suno's upload capability, enabling users to upload an audio file for processing. The expected result is a refreshed audio track with a new style, keeping the original melody intact.
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)customMode is true (Custom Mode):instrumental is true: style, title, and uploadUrl are required.instrumental is false: style, prompt, title, and uploadUrl are required.uploadUrl is used to specify the upload location of the audio file; ensure the uploaded audio does not exceed 8 minutes in length.customMode is false (Non-custom Mode):prompt and uploadUrl are required, regardless of the instrumental setting.prompt length limit: 500 characters.Developer Notes
1.
customMode to false, instrumental to false, and provide only prompt and uploadUrl. This is the simplest configuration to quickly test the API and experience the results.2.
3.
customMode and instrumental settings to avoid errors.4.
prompt, style, and title to ensure successful processing.5.
text (text generation complete), first (first track complete), and complete (all tracks complete).6.
7.
uploadUrl parameter is used to specify the upload location of the audio file; please provide a valid URL.Optional Parameters
vocalGender (string): Vocal gender preference. Use m for male, f for female.styleWeight (number): Strength of adherence to 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., customMode 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-cover' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"uploadUrl": "https://storage.example.com/upload",
"prompt": "A calm and relaxing piano track with soft melodies",
"style": "Classical",
"title": "Peaceful Piano Meditation",
"customMode": true,
"instrumental": true,
"model": "V4",
"negativeTags": "Heavy Metal, Upbeat Drums",
"callBackUrl": "https://api.example.com/callback",
"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"
}
}