create music (with description)

POST

/api/v1/riffusion/create

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.sunoapi.com/api/v1/riffusion/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mv":"FUZZ-1.1 Pro",
    "prompt": "r&b pop song",
    "custom_mode":false
}'

Response Example

{
    "message": "success",
    "task_id": "6d7253ac-916e-49a8-b288-91ffa7f8a8cd"
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

enum<string>

required

Model version. Options: "FUZZ-1.1 Pro", "FUZZ-1.1", "FUZZ-1.0 Pro", "FUZZ-1.0"

Allowed values:

FUZZ-1.1 ProFUZZ-1.0 ProFUZZ-1.1FUZZ-1.0

prompt

string

required

Song prompt/description. Only used when custom_mode is false.

custom_mode

boolean

required

Enable custom mode (set to true to use lyrics-based generation).

Examples

Responses

🟢200success

application/json

Body

message

string

required

task_id

string

required

Modified at 2025-07-15 13:52:16

create music (with lyrics)

cover music