Suno Audios Generation API
https://api.acedata.cloud/suno/audios
Suno AI music generation API, generates 2 songs per request with extension support.
Related Products
Suno - 辰汐ai
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
Music generation operation types. `generate`: generate audio based on a prompt; `extend`: continue generating based on existing audio; `concat`: stitch existing audio clips into a complete track; `cover`: replicate the musical style of an existing track and reinterpret it; `upload_cover`: create a style cover of uploaded audio; `upload_extend`: extend and continue generating uploaded audio; `artist_consistency`: sing a new song in the style of a specified singer (Persona); `artist_consistency_vox`: sing a new song in the style of a specified singer using VOX mode; `stems`: separate a song into vocal and instrumental tracks; `all_stems`: separate a song into all individual tracks (vocals, drums, bass, other instruments); `add_stem`: add a new track to existing audio, with required `audio_id` and `stem_type`, and optional `prompt`, `title`, and `style`; `extract_stem`: extract a specified track from existing audio, with required `audio_id` and `stem_type`, and optional `audio_format`; `sounds`: generate standalone sound effects, with required `sound` and `sound_type`, and optional `bpm` and `key`; `adjust_speed`: adjust the playback speed of existing audio, with required `audio_id`, `speed_multiplier`, and `title`, while `keep_pitch` is optional; `replace_section`: replace a clip within a specified time range; `underpainting`: generate and add AI accompaniment for an uploaded vocal track; `overpainting`: generate and add AI vocals for an uploaded accompaniment track; `samples`: select a start and end range from an existing audio clip for sample-based creation; `remaster`: remaster existing audio to improve sound quality; `mashup`: mix and stitch multiple songs into one track; `inspo`: Inspo inspiration creation feature, using 1 to 4 dragged or uploaded reference audio clips to inspire entirely new music creation.
promptstring
Prompt words used to generate music in inspiration mode (effective when `custom` is `false`), with a maximum length of 500 characters. For custom mode, use `lyric` and `style` instead. When `action` is `add_stem`, this field is optional and is used to describe the track to be added.
lyric_promptstring
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`.
max_modeboolean
Whether to enable enhanced generation mode. Only `generate` (which also requires `custom` to be `true`) and `add_stem` are supported. When enabled, 1.12 and 1.344 Credits are consumed respectively; when disabled or omitted, billing is based on normal mode. Passing this parameter for other actions will return 400.
Please select
varietystring
The diversity strength of the generated results, optional: `off`, `normal`, `high`, `extra`, `max`. Only `generate` and `add_stem` are supported; passing it to other actions will return 400.
Please select
lyricstring
Lyrics for generating music under custom mode (`custom` is `true`). `chirp-v3-5` and `chirp-v4` have a maximum of 3000 characters; `chirp-v4-5` and above (including `chirp-v5`, `chirp-v5-5`) have a maximum of 5000 characters.
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
Music title (custom mode). `chirp-v3-5`, `chirp-v4` support up to 80 characters; `chirp-v4-5` and above (including `chirp-v5`, `chirp-v5-5`) support up to 100 characters. Optional when `action` is `add_stem`; required when `action` is `adjust_speed`.
stylestring
Music style description. `chirp-v3-5` and `chirp-v4` support a maximum of 200 characters; `chirp-v4-5` and above (including `chirp-v5`, `chirp-v5-5`) support a maximum of 1000 characters. Optional when `action` is `add_stem`.
variation_categorystring
Remaster variation intensity, only used for `remaster`, optional values are `high`, `normal`, `subtle`.
Please select
negative_tagsstring
Descriptions of styles or genres that should not appear in the generated music will only take effect when the custom mode (`custom` is `true`).
vocal_genderstring
Voice gender preference, optional `m` (male voice) or `f` (female voice). This is a generation preference and is not guaranteed to be strictly followed.
Please select
soundstring
The sound effect description to be generated, required when `action` is `sounds`.
audio_idstring
ID of the existing audio. This field is required when `action` is `extend`, `concat`, `add_stem`, `extract_stem`, or `adjust_speed`.
stem_typestring
Track type. Required when `action` is `add_stem` or `extract_stem`; supports `vocals`, `backing_vocals`, `drums`, `bass`, `guitar`, `keyboard`, `percussion`, `strings`, `synth`, `fx`, `brass`, `woodwinds`.
Please select
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`.
bpminteger
Sound effect target speed (beats per minute), optional only when `action` is `sounds`, must be an integer from 1 to 300.
keystring
The target mood of the sound effect, optional only when `action` is `sounds`.
durationinteger
Desired song duration (seconds), must be an integer between 10 and 360. The platform will pass this value; specific operations, modes, or models may weaken or ignore it. This is a generation target rather than a strict final length; the actual duration is subject to the response.
weirdnessnumber
Weirdness, ranges from 0 to 1. Higher values generally make the result more experimental; 0 will be passed as a valid value. The specific effect depends on the operation type, mode, and model.
keep_pitchboolean
Whether to maintain the original pitch when adjusting speed, defaults to `false`, only used for `adjust_speed`.
Please select
sound_typestring
Sound effect type, required when `action` is `sounds`. `one-shot` indicates a one-shot sound effect, and `loop` indicates a loopable sound effect.
Please select
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_formatstring
Output audio format, optional only when `action` is `extract_stem` or `sounds`, currently supports `mp3`.
Please select
audio_weightnumber
Influence weight of audio or voice characteristics, ranging from 0 to 1; 0 is also a valid value. It can be used for operations such as generation, continuation, cover singing, adding audio tracks, and voice consistency; in scenarios without reference audio or voice characteristics, the model may weaken or ignore this value.
samples_startnumber
Add a default start time for the uploaded audio sample, with a default value of 0.
style_influencenumber
Style influence, range 0 to 1. Higher values generally make the result closer to `style`; 0 is passed as a valid value. The specific effect depends on the operation type, mode, and model.
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.
speed_multipliernumber
Playback speed multiplier, required when `action` is `adjust_speed`, ranging from 0.25 to 4.
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.
replace_section_result_modestring
When `action` is `replace_section`, specify the return format. `full_song` (default) will concatenate 2 candidates separately and return 2 complete songs; `candidates` will return 2 uncombined replacement segment candidates, which need to be selected before calling `concat`.
Please select
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
Integration guide
Kind reminder: For streaming requests, the above code may not be fully applicable. Please refer to the integration documentation for changes.
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.