Suno Sound Effects API Documentation

curl --request POST \ --url https://api.ttapi.io/suno/v1/sounds \ --header 'Content-Type: application/json' \ --header 'TT-API-KEY: <api-key>' \ --data ' { "sound": "<string>", "mv": "chirp-v5", "type": "one-shot", "bpm": 123, "isStorage": true, "hookUrl": "<string>" } '

Authorizations

TT-API-KEY

string

header

required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json

sound

string

required

Describe the sound you want.

enum<string>

default:chirp-v5

required

Model to use.

Available options:

chirp-v5-5,

chirp-v5

type

enum<string>

default:one-shot

required

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

Available options:

one-shot,

loop

bpm

integer

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

key

enum<string>

Key

Available options:

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

isStorage

boolean

default:true

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

hookUrl

string

Callback notification URL

Response

Request successful

status

string

required

Example:

"SUCCESS"

message

string

required

Example:

"success"

data

object

required

Example:

{
  "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}