Skip to main content

Upload And Extend Audio

POST 
/api/v1/generate/upload-extend

This API extends an audio track while preserving its original style. It includes Suno's upload functionality, allowing users to upload an audio file for processing. The expected outcome is a longer audio track that seamlessly continues the style of the input.

Parameter Usage Guide​

  • When defaultParamFlag is true (Custom Parameters):

    • prompt, style, title, continueAt and uploadUrl are required
    • prompt length limit: 3000 characters
    • style length limit: 200 characters
    • title length limit: 80 characters
    • continueAt specifies the time in seconds to start extending the audio
    • uploadUrl is used to specify the upload location of the audio file; ensure the uploaded audio does not exceed 2 minutes in length.

  • When defaultParamFlag is false (Use Default Parameters):

    • Only uploadUrl is required
    • Other parameters will use the original audio's parameters

Developer Notes​

  1. Generated files are retained for 15 days
  2. The model version must match the source music
  3. This feature is perfect for creating longer works by extending existing music
  4. The uploadUrl parameter is used to specify the upload location of the audio file; please provide a valid URL.

Request​

Responses​

Request successful

Callbacks​

POST 
{$request.body#/callBackUrl}

System will call this callback when audio generation is complete.

Callback Example​

{
  "code": 200,
  "msg": "All generated successfully.",
  "data": {
    "callbackType": "complete",
    "task_id": "2fac****9f72",
    "data": [
      {
        "id": "8551****662c",
        "audio_url": "https://example.cn/****.mp3",
        "source_audio_url": "https://example.cn/****.mp3",
        "stream_audio_url": "https://example.cn/****",
        "source_stream_audio_url": "https://example.cn/****",
        "image_url": "https://example.cn/****.jpeg",
        "source_image_url": "https://example.cn/****.jpeg",
        "prompt": "[Verse] Night city lights shining bright",
        "model_name": "chirp-v3-5",
        "title": "Iron Man",
        "tags": "electrifying, rock",
        "createTime": "2025-01-01 00:00:00",
        "duration": 198.44
      }
    ]
  }
}

Callbacks Responses​

Callback received successfully