Skip to main content
SUNO allows us to upload reference audio for secondary creation. This document explains how to integrate the related APIs. A standard upload only requires audio_url, which is a publicly accessible audio CDN URL. mode defaults to standard, so no changes are required for existing calls. A successful standard upload consumes 0.06 Credits; failed uploads are not charged. The audio_url entered here is https://cdn.acedata.cloud/suno_demo.mp3, which is a publicly accessible CDN URL.
The result is as follows:
As you can see, data is always an object, and audio_id is the uploaded song ID. Analysis results such as lyric, style, duration, title, and media URLs are optional fields, depending on the returned content. After obtaining the song ID, you can use the Suno Audios Generation API to call operations that require audio_id, such as upload_extend, upload_cover, or segment sampling. To use the Inspo inspiration creation feature to create new music based on 1 to 4 complete reference audio tracks, directly call action=inspo and pass the list of original public audio URLs; the service will automatically complete uploading and analysis, with no need for the client to assemble audio metadata.

​
Enhanced Upload Mode

audio_url is the input URL and will be directly passed to the audio processing workflow. It will not be pre-transferred by the final-state media persistence service. Please ensure that it is publicly accessible during task processing.
When standard upload cannot process audio that you own or are authorized to use, you can set mode to enhanced. This mode must also provide a name between 1 and 100 characters, and use a publicly accessible HTTPS audio_url. Enhanced upload always uses asynchronous processing and typically takes 2 minutes or longer. Successful processing consumes 1.87 Credits; failed processing is not charged.
The API will immediately return task_id and trace_id. Use the Suno Tasks API to query the task, and after 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 through enhanced upload can be used for Cover, Samples, and Mashup. Instrumental and MIDI extraction, full-track separation, and vocal/instrumental separation may still be restricted by the account that owns the audio; operations not listed are not guaranteed to support cross-account use. The shorter the audio, the higher the processing success rate usually is.