AI Music API
  1. riffusion
AI Music API
  • Introduction
  • Credits Usage Guide
  • Error handling
  • suno
    • Suno 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
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
      POST
    • create instrument music
      POST
    • get music
      GET
  • lyrics generation
    • Make Lyrics
  • get-credits
    GET
  1. riffusion

upload

POST
/api/v1/riffusion/upload
Upload your own songs and get a clip id for subsequent operations
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.sunoapi.com/api/v1/riffusion/upload' \
--header 'Content-Type: application/json' \
--data-raw '{
  "url":"https://audio.jukehost.co.uk/Ij5SXdAJKLg4tggS8T1xIH1Z0DuOWq5e.mp3"
}'
Response Response Example
{
    "code": 200,
    "clip_id": "cfbc3d3c-2add-4265-bcdf-924092096e3d",
    "message": "success"
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
url
string 
required
the online music url you want to upload,It must be copyright-free music
Examples

Responses

🟢200success
application/json
Body
code
integer 
required
clip_id
string 
required
message
string 
required
Modified at 2025-07-15 13:54:45
Previous
swap music vocals
Next
get music
Built with