MusicAPI
HomeDocs
HomeDocs
  1. Docs
  • 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. Docs

Special Scenarios

🎵 Generating Other Music Using the Sound from User-Uploaded Audio#

Step 1: Upload Your Audio#

Use the upload API endpoint to host your audio file on a service and obtain its online URL as a request parameter.
After sending the request, you will receive a clip_id within a few minutes. Save it.

Step 2: Generate Music Using the Uploaded Audio#

This step can be done using one of the three API endpoints: extend, cover, or persona.

🎼 Using Extend#

Use the extend endpoint to extend the user-uploaded song.
Set the start time to 0.1s.
Set task_type to extend_upload_music instead of extend_music.
Fill in other parameters and send the request.
You will receive a song that matches the sound of the user-uploaded music.

🎤 Using Cover#

Use the cover endpoint to create a cover of the user-uploaded song.
Set the start time to 0.1s.
Set task_type to cover_upload_music instead of cover_music.
Fill in other parameters and send the request.
You will receive a song that matches the sound of the user-uploaded music.

🎭 Using Persona#

Use the create_persona endpoint to create a persona.
Provide the online URL of the user-uploaded music.
Send the request, and you will receive a persona_id. Save this ID.
Use the created persona to generate any song that will match the sound of the user-uploaded music.
Generating a Song Using the Created Persona#
When creating a song, set task_type to persona_music.
Provide the persona_id.
Include the continue_clip_id (the clip_id of the user-uploaded music).
Modified at 2025-06-19 05:24:42
Previous
Music API FAQ & Troubleshooting
Next
Error handling
Built with