Sign in

v1

latestOpenAPI 3.1.02026-07-2611077199.5 KB

post/suno/v1/sounds

Request body

soundstring required

Describe the sound you want.

mv'chirp-v5-5' | 'chirp-v5' required

Model to use.

type'one-shot' | 'loop' required

Sound effect type: one-shot for a single-hit effect, loop for a looping effect.

bpminteger

Tempo in beats per minute. Valid range: 1 to 300 bpm.

key'C' | 'C#' | 'Cm' | 'C#m' | 'D' | 'D#' | 'Dm' | 'D#m' | 'F' | 'F#' | 'Fm' | 'F#m' | 'G' | 'G#' | 'Gm' | 'G#m' | 'A' | 'A#' | 'Am' | 'A#m' | 'B' | 'B#' | 'Bm' | 'B#m'

Key

isStorageboolean

Whether to store the generated audio.

  • true: The audio will be stored and a TTAPI CDN URL will be returned
  • false: The original source URL will be returned
hookUrlstring

Callback notification URL

Response

Request successful

statusstring required
messagestring required
dataobject required

Example response

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "jobId"
  }
}