Upload And Cover Audio
POST
/api/v1/client/tasks
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 80 chars), lyrics / prompt (max 5000 chars)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)uploadUrl), generation can proceed; lyrics (formerly used via prompt), title, and style are optionaluploadUrl, modellyrics takes priority over prompt as lyrics. If lyrics is omitted, prompt is used as lyrics when provideduploadUrl specifies the source audio file; ensure the uploaded audio does not exceed 8 minutes in lengthDeveloper Notes
1.
2.
lyrics, prompt, style, and title to ensure successful processing.3.
text (text generation complete), first (first track complete), and complete (all tracks complete).4.
5.
uploadUrl parameter is used to specify the upload location of the audio file; please provide a valid URL.Optional Parameters
| Parameter | Type | Description |
|---|---|---|
lyrics | string | Lyrics content. Optional. Takes priority over prompt as lyrics. V6 maximum 5000 characters. |
prompt | string | Used as lyrics when lyrics is not provided. Optional. V6 maximum 5000 characters. |
style | string | Music style. Optional. V6 maximum 1000 characters. |
title | string | Track title. Optional. Maximum 80 characters. |
variety | integer | Diversity of generated results. Integer 0–4, default 1. 0 off / 1 normal / 2 high / 3 extra / 4 max. |
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 or Voice ID to apply to the generated music. To create one, use Generate Persona. |
Callbacks
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.emix.ai/api/v1/client/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno/upload-and-cover-audio",
"callBackUrl": "https://api.example.com/callback",
"input": {
"uploadUrl": "https://storage.example.com/upload",
"prompt": "A calm and relaxing piano track with soft melodies",
"lyrics": "[Verse]\nKeep the melody flowing\nInto a gentle bridge\n[Chorus]\nLet the piano rise and fall",
"style": "Classical",
"title": "Peaceful Piano Meditation",
"instrumental": true,
"model": "V6",
"negativeTags": "Heavy Metal, Upbeat Drums",
"vocalGender": "m",
"styleWeight": 0.65,
"weirdnessConstraint": 0.65,
"audioWeight": 0.65,
"variety": 1,
"personaId": "persona_123",
"personaModel": "voice_persona",
"duration": 20
}
}'Response Response Example
{
"msg": "Playground task completed successfully.",
"code": 200,
"data": {
"resultJson": "{\"sunoData\":[{\"duration\":30.04,\"stream_audio_url\":\"https://cdn1.suno.ai/231a2348-2d4a-4ad2-a02a-dabd6ce49271.mp3\",\"image_suno_watermark\":false,\"model_name\":\"chirp-fenix\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/73c347ebdf5740fcb64d7dbafce45751.jpeg\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/9daea8287dc6439b8649e9f849317d45.mp3\",\"id\":\"231a2348-2d4a-4ad2-a02a-dabd6ce49271\",\"title\":\"Summer Vibes Cover\",\"prompt\":\"Create an uplifting pop cover version of the uploaded audio with modern production, driving beat, and soaring vocal harmonies. Add electronic elements and build energy throughout the track.\",\"tags\":\"Pop, Electronic, Uplifting\"},{\"duration\":30.04,\"stream_audio_url\":\"https://cdn1.suno.ai/553a46f1-faea-46a3-b2c1-9865153f7ce1.mp3\",\"image_suno_watermark\":false,\"model_name\":\"chirp-fenix\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/dc4ddc0f467b419ba3d22c0ef3ce7243.jpeg\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/773ad72c9dd44feeb414e7eca6a32f95.mp3\",\"id\":\"553a46f1-faea-46a3-b2c1-9865153f7ce1\",\"title\":\"Summer Vibes Cover\",\"prompt\":\"Create an uplifting pop cover version of the uploaded audio with modern production, driving beat, and soaring vocal harmonies. Add electronic elements and build energy throughout the track.\",\"tags\":\"Pop, Electronic, Uplifting\"}]}",
"param": "{\"model\": \"suno/upload-and-cover-audio\", \"input\": \"{\\\"model\\\": \\\"V5_5\\\", \\\"uploadUrl\\\": \\\"https://tempfileb.aiquickdraw.com/kieai/market/1786351570493_fUqB0L0k.mp3\\\", \\\"instrumental\\\": false, \\\"prompt\\\": \\\"Create an uplifting pop cover version of the uploaded audio with modern production, driving beat, and soaring vocal harmonies. Add electronic elements and build energy throughout the track.\\\", \\\"duration\\\": 30, \\\"style\\\": \\\"Pop, Electronic, Uplifting\\\", \\\"title\\\": \\\"Summer Vibes Cover\\\", \\\"continueAt\\\": 7, \\\"negativeTags\\\": \\\"heavy metal, aggressive, dark\\\", \\\"vocalGender\\\": \\\"f\\\", \\\"styleWeight\\\": 0.7, \\\"weirdnessConstraint\\\": 0.5, \\\"audioWeight\\\": 0.6, \\\"variety\\\": 1}\", \"callBackUrl\": \"http://localhost:8305/test\"}",
"costTime": 102,
"createTime": 1786352250000,
"completeTime": 1786352368000,
"model": "suno/upload-and-cover-audio",
"updateTime": 1786352368000,
"state": "success",
"creditsConsumed": 12,
"taskId": "d53d3d23191ca0631fd02f746850055b"
}
}