Skip to main content

Separate Vocals from Music

POST 
/api/v1/vocal-removal/generate

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

Usage Guide​

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

Parameter Details​

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

Developer Notes​

  • All three audio files (original, vocal, instrumental) are retained for 14 days
  • Vocal isolation quality depends on the complexity and mixing of the original audio
  • Results include separate URLs for original audio, isolated vocals, and instrumental backing track

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"
    }
  }
}

Callbacks Responses​

Callback received successfully