Skip to main content

Separate Vocals from Music

POST 
/api/v1/vocal-removal/generate

Separate music into vocal, instrumental, and individual instrument tracks using advanced audio processing technology.

Usage Guide​

  • Use this endpoint to split audio into vocal, instrumental, and individual instrument components
  • Ideal for remixing, karaoke tracks, or isolating specific instruments for further processing
  • Works best with professionally recorded music with clear vocal and instrument parts

Parameter Details​

  • taskId identifies the original music generation task
  • audioId specifies which audio track to process when multiple variations exist

Developer Notes​

  • All audio files (original, vocal, instrumental, drums, bass, guitar, piano) are retained for 14 days
  • Separation quality depends on the complexity and mixing of the original audio
  • Results include separate URLs for original audio, isolated vocals, instrumental backing track, and individual instrument tracks

Request​

Responses​

Request successful

Callbacks​

POST 
{$request.body#/callBackUrl}

System will call this callback when vocal separation is complete.

Callback Example​

{
  "code": 200,
  "msg": "vocal separation generated successfully.",
  "data": {
    "task_id": "5e72d367bdfbe44785e28d72cb1697c7",
    "vocal_separation_info": {
      "instrumental_url": "https://tempfile.aiquickdraw.com/v/94322944-2c96-4be3-b7fb-606e3924a8d2_instrumental.mp3",
      "origin_url": "https://cdn1.suno.ai/549fc4b2-294f-44ea-a35b-419687b07ab9.mp3",
      "vocal_url": "https://tempfile.aiquickdraw.com/v/94322944-2c96-4be3-b7fb-606e3924a8d2_vocal.mp3",
      "drums_url": "https://tempfile.aiquickdraw.com/v/94322944-2c96-4be3-b7fb-606e3924a8d2_drums.mp3",
      "bass_url": "https://tempfile.aiquickdraw.com/v/94322944-2c96-4be3-b7fb-606e3924a8d2_bass.mp3",
      "guitar_url": "https://tempfile.aiquickdraw.com/v/94322944-2c96-4be3-b7fb-606e3924a8d2_guitar.mp3",
      "piano_url": "https://tempfile.aiquickdraw.com/v/94322944-2c96-4be3-b7fb-606e3924a8d2_piano.mp3"
    }
  }
}

Callbacks Responses​

Callback received successfully