Suno Audios Generation API
POSThttps://api.acedata.cloud/suno/audios
Suno AI music generation API, generates 2 songs per request with extension support.
Related Products
Suno - Ace Data Cloud
Suno music generation platform, directly interfaces with this API, high-speed and stable availability.
Request Headers
acceptstring
Specify the format of the response returned by the server. If not specified, the default format is `application/json`; if `application/x-ndjson` is specified, the response will be returned in a JSON format separated by newline characters, streamed back in chunks.
Please select
authorizationstring
Bearer token
Request Body
actionstring
Types of operations for generating music. `generate`: Generate audio based on prompts; `extend`: Continue generating based on existing audio; `concat`: Stitch existing audio clips into a complete track; `cover`: Copy the musical style of an existing track and reinterpret it; `upload_cover`: Style cover of uploaded audio; `upload_extend`: Extend and continue generating uploaded audio; `artist_consistency`: Sing new songs in the style of a specified artist (Persona); `artist_consistency_vox`: Sing new songs in the style of a specified artist using VOX mode; `stems`: Separate the song into vocal and accompaniment tracks; `all_stems`: Separate the song into all independent tracks (vocals, drums, bass, other instruments); `replace_section`: Replace segments within a specified time period; `underpainting`: Generate and add AI accompaniment to the uploaded vocal track; `overpainting`: Generate and add AI vocals to the uploaded accompaniment track; `samples`: Add AI samples to the uploaded audio within a specified time period; `remaster`: Remaster existing audio to enhance sound quality; `mashup`: Mix and stitch multiple songs into one track.
promptobject
Prompts for generating music, no longer than 200 characters.
lyric_promptobject
Prompts for automatically generating lyrics, effective only when `custom` is `true` and `lyric` is empty.
modelstring
The model used for generating music has a default value of `chirp-v4`.
lyricstring
Lyrics for generating music
customboolean
Whether to enable the custom mode flag. If `true`, the audio will be generated based on the lyrics; otherwise, it will be generated based on the prompts.
Please select
instrumentalboolean
Pure accompaniment mode (no lyrics), default is `false`. When set to `true`, the lyrics filled in above will be ignored.
Please select
titlestring
Title of the Music
stylestring
Music styles
variation_categorystring
`variation_category` only supports version v5 and above, with only three optional values: `high`, `normal`, `subtle`.
style_negativestring
Styles of description that are not desired in music generation.
vocal_genderstring
Voice gender, selectable values are `'m'` (male voice) or `'f'` (female voice)
audio_idstring
Audio ID used for generating additional audio based on existing audio. This field is required when `action` is `extend` or `concat`.
audio_urlsarray
A list of reference audio URLs for inspiration, requiring 1 to 4 publicly accessible audio addresses. This field is mandatory when `action` is `inspo`.
persona_idstring
Generate the singer Persona ID used when creating songs based on the unique style characteristics of the specified singer.
mashup_audio_idsarray
Audio ID list for mixing and mashup. This field is required when `action` is `mashup`.
weirdnessnumber
The "Weirdness" advanced parameter in the Suno official custom mode has a value range of 0 to 1, with higher values resulting in more creative and experimental outputs. It is only effective in custom mode.
continue_atnumber
Continue generating from the specified time point (seconds) of the existing audio. For example, 213.5 means to continue from 3 minutes and 33.5 seconds.
samples_endnumber
Add the end time of the sample for the uploaded audio, which must be less than the total duration of the song.
audio_weightnumber
The weight of the uploaded reference audio, with a value range from 0 to 1, where a higher value indicates greater reliance on the reference audio. This only takes effect during the cover operation.
samples_startnumber
Add a default start time for the uploaded audio sample, with a default value of 0.
style_influencenumber
The "Style Influence" advanced parameter in the Suno official custom mode has a value range of 0 to 1, with higher values being closer to the selected style. It is only effective in custom mode.
overpainting_endnumber
Add the end time of the AI voice to the uploaded audio, which must be less than the total duration of the song.
underpainting_endnumber
Add the end time for the AI accompaniment to the uploaded audio, which must be less than the total duration of the song.
overpainting_startnumber
Set the default start time for the AI voice of the uploaded audio to 0.
replace_section_endnumber
When `action` is `replace_section`, specify the end time (in seconds) of the segment to be replaced.
underpainting_startnumber
Set the default start time for the AI accompaniment added to the uploaded audio, with a default value of 0.
replace_section_startnumber
When `action` is `replace_section`, specify the start time (in seconds) of the segment to be replaced.
callback_urlstring
Callback URL to be called after audio generation is complete.
asyncboolean
Whether to process in asynchronous mode. When set to `true`, the interface immediately returns `task_id`, without the need to provide `callback_url`, and then the result can be obtained by polling the corresponding task query interface; if `callback_url` is also provided, the result will be pushed to that callback address.
Please select
Response
Suno Music Generation
Allow Use General Balance
When 'Allow General Balance' is enabled, the general balance is used automatically if an app's balance is insufficient.
Kind reminder: For streaming requests, the above code may not be fully applicable. Please refer to the integration documentation for changes.