MusicAPI
HomeDocs
HomeDocs
  1. riffusion
  • Introduction
  • Credits Usage Guide
  • Music API FAQ & Troubleshooting
  • Special Scenarios
  • Error handling
  • sonic
    • Sonic Instructions
    • create music
      POST
    • extend music
      POST
    • concat music
      POST
    • cover music
      POST
    • create persona
      POST
    • create music with persona
      POST
    • upload music
      POST
    • get music
      GET
  • riffusion
    • Riffusion instructions
    • create music (with lyrics)
      POST
    • create music (with description)
      POST
    • cover music
      POST
    • extend music
      POST
    • replace music section
      POST
    • swap music sound
      POST
    • swap music vocals
      POST
    • upload
      POST
    • get music
      GET
  • studio(Unavailable)
    • Studio Instructions
    • description mode (Use case1)
      POST
    • extend mode (Use case2)
      POST
    • custom mode (Use case3)
      POST
    • instrumental mode (Use case4)
      POST
    • get music
      GET
  • lyrics generation
    • Make Lyrics
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
    • create instrument music
    • get music
  • get-credits
    GET
  1. riffusion

create music (with description)

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
mv
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).
Example
{
    "mv":"FUZZ-1.1 Pro",
    "prompt": "r&b pop song",
    "custom_mode":false
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.musicapi.ai/api/v1/riffusion/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mv":"FUZZ-1.1 Pro",
    "prompt": "r&b pop song",
    "custom_mode":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:41:30
Previous
create music (with lyrics)
Next
cover music
Built with