KIE.AI
old-model
  • All Model
  • old-model
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
old-model
  • All Model
  • old-model
old-model
  • All Model
  • old-model
Suno API
4o Image APIVeo3.1 APIRunway APIFlux Kontext API
Suno API
4o Image APIVeo3.1 APIRunway APIFlux Kontext API
  1. Vocal Removal
  • Suno API Quickstart
  • Music Generation
    • Music Cover Generation Callbacks
    • Music Generation Callbacks
    • Music Extension Callbacks
    • Audio Upload and Cover Callbacks
    • Audio Upload and Extension Callbacks
    • Add Instrumental Callbacks
    • Add Vocals Callbacks
    • Replace Music Section Callbacks
    • Generate Music
      POST
    • Extend Music
      POST
    • Upload And Cover Audio
      POST
    • Upload And Extend Audio
      POST
    • Add Instrumental to Music
      POST
    • Add Vocals to Music
      POST
    • Get Music Task Details
      GET
    • Get Timestamped Lyrics
      POST
    • Boost Music Style
      POST
    • Generate Music Cover
      POST
    • Get Cover Generation Details
      GET
    • Replace Music Section
      POST
    • Generate Persona
      POST
    • Generate Mashup Music
      POST
    • Recovery Audio
      POST
  • Lyrics Generation
    • Lyrics Generation Callbacks
    • Generate Lyrics
    • Get Lyrics Task Details
  • WAV Conversion
    • Convert to WAV Callbacks
    • Convert to WAV Format
    • Get WAV Conversion Details
  • Vocal Removal
    • Audio Separation Callbacks
    • MIDI Generation Callbacks
    • Vocal & Instrument Stem Separation
      POST
    • Get Vocal Separation Details
      GET
    • Generate MIDI from Audio
      POST
    • Get MIDI Generation Details
      GET
  • Music Video Generation
    • Music Video Generation Callbacks
    • Create Music Video
    • Get Music Video Details
  • Sounds Generation
    • Generate sounds
  • voice
    • Suno Voice Generation Callback
    • Suno Voice Validation Phrase Callback
    • Suno Voice Generate Verification Phrase API
    • Suno Voice Get Verification Phrase API
    • Suno Voice Create Custom Voice API
    • Suno Voice Get Custom Voice Records
    • Suno Voice Regenerate Verification Phrase
    • Suno Voice Check Availability API
  1. Vocal Removal

Vocal & Instrument Stem Separation

POST
/api/v1/vocal-removal/generate
Use advanced audio processing technology to separate music into vocals, accompaniment, and individual instrumental stems.

Usage Guide#

Separate platform-generated mixes into vocals, accompaniment, and individual instrumental components.
Supports three processing modes:
separate_vocal — 2-stem separation (vocals + accompaniment)
split_stem — Up to 12-stem separation
split_stem_advanced — Advanced multi-stem separation, supporting precise extraction of a single target stem through stemName
Suitable for karaoke production, mixing, sample extraction, and detailed post-production.
Works best with professional AI-generated mixes that have clearly separated vocals and instruments.
Billing: Each API call consumes credits; repeated calls for the same audio stem will be charged again (no server-side caching).
Pricing: Please check https://kie.ai/pricing for the current credit cost per call.

Separation Mode Description#

Mode (type)Returned StemsTypical Use CasesCredit Cost
separate_vocal （default）2 stems — Vocals + accompanimentQuick vocal removal, karaoke, and basic mixing10 credits
split_stemUp to 12 stems — Vocals, backing vocals, drums, bass, guitar, keyboard, strings, brass, woodwinds, percussion, synthesizer, FX/other;Advanced mixing, remixing, sound design, and individual instrument extraction50 credits
split_stem_advancedUp to 12 stems — Same as split_stem, with support for specifying a single target stem through stemName for precise separationIndividual instrument extraction and detailed post-production20 credits

Parameters#

NameTypeDescription
taskIdstringThe ID of the original music generation task
audioUrlstringThe URL of the user-uploaded audio file. Required when processing user-uploaded audio. Cannot be used together with audioId.
audioIdstringSpecifies the audio variant to process when multiple versions exist. Cannot be used together with audioUrl.
typestringSeparation mode: separate_vocal, split_stem, or split_stem_advanced; defaults to separate_vocal
stemNamestringTakes effect only when type is split_stem; specifies the name of the individual stem/instrument to separate;

Developer Notes#

All returned audio file URLs are valid for 14 days.
Separation quality depends on the complexity and mixing characteristics of the original track.
separate_vocal returns 2 stems — vocals + accompaniment.
split_stem returns up to 12 independent stems — vocals, backing vocals, drums, bass, guitar, keyboard, strings, brass, woodwinds, percussion, synthesizer, and FX/other.
split_stem_advanced supports specifying a single target stem through stemName for precise extraction.
Billing: Each request consumes credits. Repeatedly submitting the same stem will deduct credits again (no server-side caching).

Callbacks

vocalRemovalGenerated

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Request successful
Bodyapplication/json

🔴500Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kie.ai/api/v1/vocal-removal/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "taskId": "5c79****be8e",
  "audioId": "e231****-****-****-****-****8cadc7dc",
  "callBackUrl": "https://api.example.com/callback",
  "type": "separate_vocal"
}'
Response Response Example
200 - Example 1
{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "5c79****be8e"
    }
}
Previous
MIDI Generation Callbacks
Next
Get Vocal Separation Details
Built with