KIE.AI
English
  • English
  • Chinese
English
  • English
  • Chinese
Support
English
  • English
  • Chinese
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Vocal Removal
  • Suno API Quickstart
  • Music Generation
    • Music Generation Callbacks
    • Music Extension Callbacks
    • Audio Upload and Cover Callbacks
    • Audio Upload and Extension Callbacks
    • Add Instrumental Callbacks
    • Add Vocals Callbacks
    • Music Cover Generation 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
    • Create Suno Cover Task
      POST
    • Get Cover Generation Details
      GET
    • Replace Music Section
      POST
    • Generate Persona
      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
    • Separate Vocals from Music
      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
English
  • English
  • Chinese
Support
English
  • English
  • Chinese
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Vocal Removal

Get Vocal Separation Details

GET
/api/v1/vocal-removal/record-info
Retrieve detailed information about a vocal separation task.

Usage Guide#

Use this endpoint to check the status of a vocal separation task
Access the URLs for vocal, instrumental, and individual instrument tracks once processing is complete
Track processing progress and any errors that may have occurred
Supports querying results for both separate_vocal and split_stem separation types

Status Descriptions#

PENDING: Task is waiting to be processed
SUCCESS: Vocal separation completed successfully
CREATE_TASK_FAILED: Failed to create the separation task
GENERATE_AUDIO_FAILED: Failed during audio processing
CALLBACK_EXCEPTION: Error occurred during callback

Response Data Structure Description#

separate_vocal type: Returns instrumentalUrl and vocalUrl fields, other instrument fields are null
split_stem type: Returns detailed instrument separation fields, instrumentalUrl is null

Developer Notes#

Separated audio file URLs are only available when status is SUCCESS
Error codes and messages are provided for failed tasks
Separated audio files are retained for 14 days after successful processing
Field structure varies based on the type parameter from the original request

Request

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

Responses

🟢200
application/json
Request successful
Body

🔴500Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.kie.ai/api/v1/vocal-removal/record-info?taskId=5e72****97c7' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - separate_vocal Type Query Result
{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "3e63b4cc88d52611159371f6af5571e7",
        "musicId": "376c687e-d439-42c1-b1e4-bcb43b095ec2",
        "callbackUrl": "https://57312fc2e366.ngrok-free.app/api/v1/vocal-removal/test",
        "musicIndex": 0,
        "completeTime": 1753782937000,
        "response": {
            "id": null,
            "originUrl": null,
            "originData": [
                {
                    "duration": 245.6,
                    "audio_url": "https://example001.mp3",
                    "stem_type_group_name": "Vocals",
                    "id": "3d7021c9-fa8b-4eda-91d1-3b9297ddb172"
                },
                {
                    "duration": 245.6,
                    "audio_url": "https://example002.mp3",
                    "stem_type_group_name": "Instrumental",
                    "id": "d92a13bf-c6f4-4ade-bb47-f69738435528"
                }
            ],
            "instrumentalUrl": "https://file.aiquickdraw.com/s/d92a13bf-c6f4-4ade-bb47-f69738435528_Instrumental.mp3",
            "vocalUrl": "https://file.aiquickdraw.com/s/3d7021c9-fa8b-4eda-91d1-3b9297ddb172_Vocals.mp3",
            "backingVocalsUrl": null,
            "drumsUrl": null,
            "bassUrl": null,
            "guitarUrl": null,
            "pianoUrl": null,
            "keyboardUrl": null,
            "percussionUrl": null,
            "stringsUrl": null,
            "synthUrl": null,
            "fxUrl": null,
            "brassUrl": null,
            "woodwindsUrl": null
        },
        "successFlag": "SUCCESS",
        "createTime": 1753782854000,
        "errorCode": null,
        "errorMessage": null
    }
}
Previous
Separate Vocals from Music
Next
Generate MIDI from Audio
Built with