---
title: "Get Vocal Separation Details"
method: GET
path: "/api/v1/vocal-removal/record-info"
---

# Get Vocal Separation Details

`GET /api/v1/vocal-removal/record-info`

## Query parameters

- `taskId` string, required

## Response `200`

Request successful

- object
  - `code` 200 | 400 | 401 | 404 | 405 | 413 | 429 | 430 | 455 | 500 — # Status Codes - ✅ 200 - Request successful - ⚠️ 400 - Invalid parameters - ⚠️ 401 - Unauthorized access - ⚠️ 404 - Invalid request method or path - ⚠️ 405 - Rate limit exceeded - ⚠️ 413 - Theme or prompt too long - ⚠️ 429 - Insufficient credits - ⚠️ 430 - Your call frequency is too high. Please try again later. - ⚠️ 455 - System maintenance - ❌ 500 - Server error
  - `msg` string — Error message when code != 200
  - `data` object
    - `taskId` string — Task ID
    - `musicId` string — The ID of the source music track that was processed for vocal separation
    - `musicIndex` integer — Music index, 0 or 1
    - `callbackUrl` string — The callback URL that was provided in the vocal separation request
    - `completeTime` string, date-time — The timestamp when the separation was completed
    - `response` object
      - `id` string, nullable — Response ID
      - `originUrl` string — Original audio URL
      - `originData` object[] — Array of separated audio track information
        - `duration` number — Audio duration in seconds
        - `audio_url` string, uri — URL of the separated audio track
        - `stem_type_group_name` string — Name of the stem type group (e.g., Vocals, Instrumental, Drums, Bass, etc.)
        - `id` string — Unique identifier for the audio track. This ID can be used as audioId parameter in MIDI generation.
      - `instrumentalUrl` string — Instrumental part audio URL (exists for separate_vocal type)
      - `vocalUrl` string — Vocal part audio URL
      - `backingVocalsUrl` string — Backing vocals part audio URL (exists for split_stem type)
      - `drumsUrl` string — Drums part audio URL
      - `bassUrl` string — Bass part audio URL
      - `guitarUrl` string — Guitar part audio URL
      - `keyboardUrl` string — Keyboard part audio URL (exists for split_stem type)
      - `percussionUrl` string — Percussion part audio URL (exists for split_stem type)
      - `stringsUrl` string — Strings part audio URL (exists for split_stem type)
      - `synthUrl` string — Synthesizer part audio URL (exists for split_stem type)
      - `fxUrl` string — Effects part audio URL (exists for split_stem type)
      - `brassUrl` string — Brass part audio URL (exists for split_stem type)
      - `woodwindsUrl` string — Woodwinds part audio URL (exists for split_stem type)
    - `successFlag` 'PENDING' | 'SUCCESS' | 'CREATE_TASK_FAILED' | 'GENERATE_AUDIO_FAILED' | 'CALLBACK_EXCEPTION' — The current status of the vocal separation task
    - `createTime` string, date-time — Creation time
    - `errorCode` number — Error code, valid when task fails
    - `errorMessage` string — Error message, valid when task fails

## Other responses

- `500` — Server error

---

[API](https://skmtc.net/sunoapi/apis/file-upload-api.md) · [All operations](https://skmtc.net/sunoapi/apis/file-upload-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sunoapi/file-upload-api/versions/22d45ee33a4a/schema)