Skip to main content

Separate Vocals from Music

POST 
/api/v1/vocal-removal/generate

Split a music track into separate vocal and instrumental components.

Usage Guide​

  • This endpoint separates the original track into three components:
    1. Original mixed audio
    2. Vocals only
    3. Instrumental only (no vocals)
  • Both taskId and audioId are required to identify the specific track

Developer Notes​

  1. All separated files are retained for 15 days
  2. This is useful for karaoke applications, remixes, or isolating vocals for sampling
  3. The quality of separation depends on the complexity of the original track
  4. All output files are in MP3 format with the same quality as the original

Request​

Responses​

Request successful

Callbacks​

POST 
{$request.body#/callBackUrl}

System will call this callback when vocal removal is complete.

Callback Example​

{
  "code": 200,
  "msg": "vocal Removal generated successfully.",
  "data": {
    "task_id": "5e72d367bdfbe44785e28d72cb1697c7",
    "vocal_removal_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"
    }
  }
}

Callbacks Responses​

Callback received successfully