MusicAPI
HomeDocs
HomeDocs
  1. sonic
  • Introduction
  • Credits Usage Guide
  • Music API FAQ & Troubleshooting
  • Special Scenarios
  • Error handling
  • Webhook Integration Guide
  • sonic
    • Sonic Instructions
    • create / extend / cover music
      POST
    • upload and extend music
      POST
    • upload and cover music
      POST
    • create persona
      POST
    • sample
      POST
    • mashup
      POST
    • get BPM
      POST
    • get VOX
      POST
    • get wav
      POST
    • get midi
      POST
    • get lyrics timeline
      POST
    • upsample tags
      POST
    • concat music
      POST
    • stems basic
      POST
    • stems full
      POST
    • upload music
      POST
    • get music
      GET
  • riffusion(Deprecated)
    • Riffusion instructions
    • create music (with lyrics)
      POST
    • create music (with description)
      POST
    • cover music
      POST
    • extend music
      POST
    • replace music section
      POST
    • swap music sound
      POST
    • swap music vocals
      POST
    • upload
      POST
    • get music
      GET
  • producer
    • Producer instructions
    • Complete Request Examples
    • create music
    • upload
    • download
    • get music
  • studio(Unavailable)
    • Studio Instructions
    • description mode (Use case1)
    • extend mode (Use case2)
    • custom mode (Use case3)
    • instrumental mode (Use case4)
    • get music
  • lyrics generation
    • Make Lyrics
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
    • create instrument music
    • get music
  • get-credits
    GET
  • Schemas
    • 记录不存在
    • 参数不正确
HomeDocs
HomeDocs
  1. sonic

get VOX

POST
https://api.musicapi.ai/api/v1/sonic/vox
Extract vocal audio data from a song. You can optionally specify a time range (up to 30 seconds) to extract vocals from a specific portion.
Credits cost: 1
Other details:
1.
The clip ID must be created through our service.
2.
The clip ID should ideally have been created within the last 24 hours.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/json

Example
{
    "clip_id": "26c9c592-0566-46cf-bb71-91ac1deaa7b5",
    "vocal_start_s": 0,
    "vocal_end_s": 30
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.musicapi.ai/api/v1/sonic/vox' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clip_id": "26c9c592-0566-46cf-bb71-91ac1deaa7b5",
    "vocal_start_s": 0,
    "vocal_end_s": 30
}'

Responses

🟢200success
application/json
Success
Body

Example
{
    "code": 200,
    "message": "success",
    "data": {
        "vox_audio_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "status": "complete",
        "source_clip_id": "26c9c592-0566-46cf-bb71-91ac1deaa7b5",
        "vocal_start_s": 0,
        "vocal_end_s": 30,
        "wave_response": {}
    }
}
Modified at 2026-01-16 07:37:16
Previous
get BPM
Next
get wav
Built with