Upload And Extend Audio
POST
/api/v1/client/tasks
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), 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 providedcontinueAt specifies the position in the original track where the extension should beginuploadUrl specifies the source audio file; ensure the uploaded audio does not exceed 8 minutes in lengthDeveloper Notes
1.
2.
3.
4.
uploadUrl parameter specifies the upload location for audio files; 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 100 characters. |
continueAt | number | Time point (seconds) from which to start extending. Greater than 0 and less than the uploaded audio duration. |
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 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 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-extend-audio",
"callBackUrl": "https://api.example.com/callback",
"input": {
"uploadUrl": "https://storage.example.com/upload",
"prompt": "Extend the music with more relaxing notes",
"lyrics": "[Verse]\nKeep the melody flowing\nInto a gentle bridge\n[Chorus]\nLet the piano rise and fall",
"style": "Classical",
"title": "Peaceful Piano Extended",
"continueAt": 60,
"instrumental": true,
"model": "V6",
"negativeTags": "Relaxing Piano",
"vocalGender": "m",
"styleWeight": 0.65,
"weirdnessConstraint": 0.65,
"audioWeight": 0.65,
"variety": 1,
"personaId": "persona_123",
"personaModel": "voice_persona"
}
}'Response Response Example
{
"msg": "Text generated successfully.",
"code": 200,
"data": {
"data": "[{\"id\":\"231a2348-2d4a-4ad2-a02a-dabd6ce49271\",\"stream_audio_url\":\"https://audiopipe.suno.ai/?item_id=231a2348-2d4a-4ad2-a02a-dabd6ce49271\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/73c347ebdf5740fcb64d7dbafce45751.jpeg\",\"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.\",\"model_name\":\"chirp-fenix\",\"title\":\"Summer Vibes Cover\",\"tags\":\"Pop, Electronic, Uplifting\"},{\"id\":\"553a46f1-faea-46a3-b2c1-9865153f7ce1\",\"stream_audio_url\":\"https://audiopipe.suno.ai/?item_id=553a46f1-faea-46a3-b2c1-9865153f7ce1\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/dc4ddc0f467b419ba3d22c0ef3ce7243.jpeg\",\"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.\",\"model_name\":\"chirp-fenix\",\"title\":\"Summer Vibes Cover\",\"tags\":\"Pop, Electronic, Uplifting\"}]",
"taskId": "857d1ad2a4c9b7eeef065676e1d945c7",
"callbackType": "text"
}
}