Skip to main content
SUNO allows us to upload reference audio for secondary creation. This document explains the integration methods for the relevant APIs. Ordinary uploads only require audio_url, which is a publicly accessible audio CDN address. The mode defaults to standard, so existing calls do not need to be modified. A successful ordinary upload consumes 0.06 Credits; failed uploads incur no charges. Here, the audio_url we input is https://cdn.acedata.cloud/suno_demo.mp3, which is a publicly accessible CDN address.
The result is as follows:
As can be seen, the audio_id field in data is the song ID after the upload. With the song ID, we can use the Suno Audios Generation API to generate custom songs. For example, by passing action as upload_extend and audio_id as the returned song ID, we can generate a new song based on the reference audio.

​
Enhanced Upload Mode

When ordinary uploads cannot handle the audio you own or have been authorized to use, you can set mode to enhanced. This mode also requires providing a name of 1 to 100 characters and using a publicly accessible HTTPS audio_url. Enhanced uploads are processed asynchronously and typically take 2 minutes or longer. Successful processing consumes 1.87 Credits; processing failures incur no charges.
The interface will immediately return task_id and trace_id. Use the Suno Tasks API to query the task, and upon success, read the uploaded audio ID from response.data.audio_id. You can also provide an HTTPS callback_url to receive the final state. The audio_id obtained from enhanced uploads can be used for Cover, Samples, and Mashup. Accompaniment and MIDI extraction, full track separation, and vocal/accompaniment separation may still be subject to account restrictions; operations not listed are not guaranteed to support cross-account use. Generally, the shorter the audio, the higher the success rate of processing.