SunoAPI

SunoAPI integration (AI, Design & Media). Imported from open-connector.

API key26 toolshttps://api.sunoapi.org

GET

sunoapi_get_remaining_credits

Get remaining SunoAPI generation credits.

/api/v1/generate/credit

POST

sunoapi_generate_music

Submit a SunoAPI music generation task.

/api/v1/suno/cover/generate

14 parameters

Param	Type	Required	Description
prompt	string	optional	The prompt, lyrics, or instruction sent to SunoAPI.
style	string	optional	The music style or genre.
title	string	optional	The generated music title.
customMode	boolean	required	Whether to use SunoAPI custom mode.
instrumental	boolean	required	Whether the generated audio should be instrumental.
personaId	string	optional	The optional SunoAPI persona identifier.
personaModel	string	optional	The SunoAPI persona model.
model	string	required	The SunoAPI music generation model.
negativeTags	string	optional	Music styles or traits to avoid.
vocalGender	string	optional	The desired vocal gender.
styleWeight	number	optional	The style guidance weight between 0 and 1.
weirdnessConstraint	number	optional	The creative weirdness constraint between 0 and 1.
audioWeight	number	optional	The input audio influence weight between 0 and 1.
callBackUrl	string	required	The callback URL used to receive completed results.

GET

sunoapi_get_music_generation_details

Fetch SunoAPI music generation task details.

/api/v1/generate/record-info

1 parameter

Param	Type	Required	Description
taskId	string	optional	The SunoAPI task identifier.

POST

sunoapi_generate_lyrics

Submit a SunoAPI lyrics generation task.

/api/v1/generate/get-timestamped-lyrics

2 parameters

Param	Type	Required	Description
prompt	string	required	The lyrics prompt.
callBackUrl	string	required	The callback URL used to receive completed results.

GET

sunoapi_get_lyrics_generation_details

Fetch SunoAPI lyrics generation task details.

/api/v1/lyrics/record-info

1 parameter

Param	Type	Required	Description
taskId	string	optional	The SunoAPI task identifier.

POST

sunoapi_get_timestamped_lyrics

Fetch timestamped lyrics for one generated audio item.

/api/v1/generate/get-timestamped-lyrics

2 parameters

Param	Type	Required	Description
taskId	string	optional	The SunoAPI task identifier.
audioId	string	optional	The SunoAPI audio identifier.

POST

sunoapi_generate_persona

Submit a SunoAPI persona generation request.

/api/v1/generate/generate-persona

7 parameters

Param	Type	Required	Description
taskId	string	required	The SunoAPI task identifier.
audioId	string	required	The SunoAPI audio identifier.
name	string	required	The persona name.
description	string	required	The persona description.
vocalStart	number	optional	The audio segment start time in seconds.
vocalEnd	number	optional	The audio segment end time in seconds.
style	string	optional	The persona style label.

POST

sunoapi_separate_vocals_from_music

Submit a SunoAPI vocal separation task.

/api/v1/vocal-removal/generate

4 parameters

Param	Type	Required	Description
taskId	string	required	The SunoAPI task identifier.
audioId	string	required	The SunoAPI audio identifier.
type	string	required	The vocal removal mode.
callBackUrl	string	required	The callback URL used to receive completed results.

GET

sunoapi_get_vocal_separation_details

Fetch SunoAPI vocal separation task details.

/api/v1/vocal-removal/record-info

1 parameter

Param	Type	Required	Description
taskId	string	optional	The SunoAPI task identifier.

POST

sunoapi_extend_music

Submit a SunoAPI music extension task.

/api/v1/generate/upload-extend

17 parameters

Param	Type	Required	Description
defaultParamFlag	boolean	required	Whether to use custom parameters.
audioId	string	required	The SunoAPI audio identifier.
continueAt	number	optional	The extension start point in seconds.
prompt	string	optional	The prompt, lyrics, or instruction sent to SunoAPI.
style	string	optional	The music style or genre.
title	string	optional	The generated music title.
customMode	boolean	required	Whether to use SunoAPI custom mode.
instrumental	boolean	required	Whether the generated audio should be instrumental.
personaId	string	optional	The optional SunoAPI persona identifier.
personaModel	string	optional	The SunoAPI persona model.
model	string	required	The SunoAPI music generation model.
negativeTags	string	optional	Music styles or traits to avoid.
vocalGender	string	optional	The desired vocal gender.
styleWeight	number	optional	The style guidance weight between 0 and 1.
weirdnessConstraint	number	optional	The creative weirdness constraint between 0 and 1.
audioWeight	number	optional	The input audio influence weight between 0 and 1.
callBackUrl	string	required	The callback URL used to receive completed results.

POST

sunoapi_upload_and_cover_audio

Submit an uploaded audio cover generation task.

/api/v1/generate/upload-cover

15 parameters

Param	Type	Required	Description
uploadUrl	string	required	The uploaded audio URL.
prompt	string	optional	The prompt, lyrics, or instruction sent to SunoAPI.
style	string	optional	The music style or genre.
title	string	optional	The generated music title.
customMode	boolean	required	Whether to use SunoAPI custom mode.
instrumental	boolean	required	Whether the generated audio should be instrumental.
personaId	string	optional	The optional SunoAPI persona identifier.
personaModel	string	optional	The SunoAPI persona model.
model	string	required	The SunoAPI music generation model.
negativeTags	string	optional	Music styles or traits to avoid.
vocalGender	string	optional	The desired vocal gender.
styleWeight	number	optional	The style guidance weight between 0 and 1.
weirdnessConstraint	number	optional	The creative weirdness constraint between 0 and 1.
audioWeight	number	optional	The input audio influence weight between 0 and 1.
callBackUrl	string	required	The callback URL used to receive completed results.

POST

sunoapi_upload_and_extend_audio

Submit an uploaded audio extension task.

/api/v1/generate/upload-extend

16 parameters

Param	Type	Required	Description
uploadUrl	string	required	The uploaded audio URL.
defaultParamFlag	boolean	required	Whether to use custom parameters.
prompt	string	optional	The prompt, lyrics, or instruction sent to SunoAPI.
style	string	optional	The music style or genre.
title	string	optional	The generated music title.
customMode	boolean	required	Whether to use SunoAPI custom mode.
instrumental	boolean	optional	Whether the generated audio should be instrumental.
personaId	string	optional	The optional SunoAPI persona identifier.
personaModel	string	optional	The SunoAPI persona model.
model	string	required	The SunoAPI music generation model.
negativeTags	string	optional	Music styles or traits to avoid.
vocalGender	string	optional	The desired vocal gender.
styleWeight	number	optional	The style guidance weight between 0 and 1.
weirdnessConstraint	number	optional	The creative weirdness constraint between 0 and 1.
audioWeight	number	optional	The input audio influence weight between 0 and 1.
callBackUrl	string	required	The callback URL used to receive completed results.

POST

sunoapi_add_vocals

Add vocals to uploaded audio through SunoAPI.

/api/v1/generate/add-vocals

11 parameters

Param	Type	Required	Description
uploadUrl	string	required	The uploaded audio URL.
callBackUrl	string	required	The callback URL used to receive completed results.
prompt	string	required	The vocal prompt.
title	string	required	The music title.
negativeTags	string	required	Music styles or traits to avoid.
style	string	required	The music and vocal style.
vocalGender	string	optional	The desired vocal gender.
styleWeight	number	optional	The style adherence weight between 0 and 1.
weirdnessConstraint	number	optional	The creative weirdness constraint between 0 and 1.
audioWeight	number	optional	The audio consistency weight between 0 and 1.
model	string	required	The add vocals model.

POST

sunoapi_add_instrumental

Add instrumental backing to uploaded audio through SunoAPI.

/api/v1/generate/add-instrumental

10 parameters

Param	Type	Required	Description
uploadUrl	string	required	The uploaded music URL.
title	string	required	The music title.
negativeTags	string	required	Music styles or traits to avoid.
tags	string	required	The music style tags.
callBackUrl	string	required	The callback URL used to receive completed results.
vocalGender	string	optional	The desired vocal gender.
styleWeight	number	optional	The style adherence weight between 0 and 1.
weirdnessConstraint	number	optional	The creative weirdness constraint between 0 and 1.
audioWeight	number	optional	The audio consistency weight between 0 and 1.
model	string	required	The add instrumental model.

POST

sunoapi_boost_music_style

Boost or expand a music style prompt.

/api/v1/style/generate

1 parameter

Param	Type	Required	Description
content	string	required	The style description.

POST

sunoapi_replace_music_section

Replace a section of generated SunoAPI music.

/api/v1/generate/replace-section

9 parameters

Param	Type	Required	Description
taskId	string	required	The SunoAPI task identifier.
audioId	string	required	The SunoAPI audio identifier.
prompt	string	required	The replacement lyrics.
tags	string	required	The music style tags.
title	string	required	The music title.
infillStartS	number	required	The replacement start time in seconds.
infillEndS	number	required	The replacement end time in seconds.
negativeTags	string	optional	Music styles or traits to avoid.
callBackUrl	string	optional	The callback URL used to receive completed results.

POST

sunoapi_generate_mashup

Submit a SunoAPI mashup task.

/api/v1/generate/mashup

12 parameters

Param	Type	Required	Description
uploadUrlList	array	required	The two audio URLs to mash up.
customMode	boolean	required	Whether to use custom mode.
prompt	string	optional	The mashup prompt.
style	string	optional	The music style.
title	string	optional	The music title.
instrumental	boolean	optional	Whether the output should be instrumental.
model	string	required	The mashup model.
vocalGender	string	optional	The desired vocal gender.
styleWeight	number	optional	The style guidance weight between 0 and 1.
weirdnessConstraint	number	optional	The creative weirdness constraint between 0 and 1.
audioWeight	number	optional	The input audio influence weight between 0 and 1.
callBackUrl	string	required	The callback URL used to receive completed results.

POST

sunoapi_generate_sounds

Submit a SunoAPI sounds generation task.

/api/v1/generate/sounds

7 parameters

Param	Type	Required	Description
prompt	string	required	The sound prompt.
model	string	required	The sound generation model.
soundLoop	boolean	required	Whether to enable loop playback.
soundTempo	integer	optional	Sound tempo in BPM.
soundKey	string	optional	Sound musical key.
grabLyrics	boolean	optional	Whether to grab lyrics.
callBackUrl	string	required	The callback URL used to receive completed results.

POST

sunoapi_generate_music_cover

Submit a SunoAPI music cover image task.

/api/v1/suno/cover/generate

2 parameters

Param	Type	Required	Description
taskId	string	required	The SunoAPI task identifier.
callBackUrl	string	required	The callback URL used to receive completed results.

GET

sunoapi_get_music_cover_details

Fetch SunoAPI music cover task details.

/api/v1/suno/cover/record-info

1 parameter

Param	Type	Required	Description
taskId	string	optional	The SunoAPI task identifier.

POST

sunoapi_create_music_video

Submit a SunoAPI music video task.

/api/v1/suno/cover/generate

5 parameters

Param	Type	Required	Description
taskId	string	required	The SunoAPI task identifier.
audioId	string	required	The SunoAPI audio identifier.
callBackUrl	string	required	The callback URL used to receive completed results.
author	string	optional	Video author label.
domainName	string	optional	Video domain name.

GET

sunoapi_get_music_video_details

Fetch SunoAPI music video task details.

/api/v1/mp4/record-info

1 parameter

Param	Type	Required	Description
taskId	string	optional	The SunoAPI task identifier.

POST

sunoapi_convert_to_wav_format

Submit a SunoAPI WAV conversion task.

/api/v1/wav/generate

3 parameters

Param	Type	Required	Description
taskId	string	required	The SunoAPI task identifier.
audioId	string	required	The SunoAPI audio identifier.
callBackUrl	string	required	The callback URL used to receive completed results.

GET

sunoapi_get_wav_conversion_details

Fetch SunoAPI WAV conversion task details.

/api/v1/wav/record-info

1 parameter

Param	Type	Required	Description
taskId	string	optional	The SunoAPI task identifier.

POST

sunoapi_generate_midi

Submit a SunoAPI MIDI generation task.

/api/v1/midi/generate

3 parameters

Param	Type	Required	Description
taskId	string	required	The SunoAPI task identifier.
callBackUrl	string	required	The callback URL used to receive completed results.
audioId	string	required	The SunoAPI audio identifier.

GET

sunoapi_get_midi_generation_details

Fetch SunoAPI MIDI generation task details.

/api/v1/midi/record-info

1 parameter

Param	Type	Required	Description
taskId	string	optional	The SunoAPI task identifier.