MusicAPI

create music (with lyrics)

POST

https://api.musicapi.ai/api/v1/riffusion/create

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

custom_mode

boolean

required

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

lyrics

string

optional

Lyrics to generate the song (only applicable when custom_mode is true).

title

string

optional

Title of the song (optional metadata).(only applicable when custom_mode is true)

make_instrumental

boolean

required

Whether to generate an instrumental-only track.

prompt

string

optional

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

sound

string

optional

Style and sound details. Specify genre, vocal tone, etc.(only applicable when custom_mode is true)

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

Example

{
    "mv":"FUZZ-1.1 Pro",
    "lyrics": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
    "custom_mode":true,
    "title":"Starts",
    "sound":"pop",
    "make_instrumental":false
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.musicapi.ai/api/v1/riffusion/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mv":"FUZZ-1.1 Pro",
    "lyrics": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
    "custom_mode":true,
    "title":"Starts",
    "sound":"pop",
    "make_instrumental":false
}'

Responses

🟢200success

application/json

Body

message

string

required

task_id

string

required

Example

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

Modified at 2025-06-26 16:37:05

Riffusion instructions

create music (with description)