Skip to main content
POST
Get Vox Stem
Extract the vocal stem from an audio clip. The returned id is the vox_audio_id for Create Persona — the first step when building a Vox persona for use with task=inspiration and persona_style: "vox".
This endpoint returns the result directly (not a task ID). The extraction is processed synchronously.
Optional vocal_start_s / vocal_end_s pick the slice. Omit both to use 45 and 74 (same as the old platform). Pass them if the song is shorter than 74s, or you want another range.

Request Body

string
required
The audio clip ID to extract vocals from.
number
Vocal range start in seconds. Omit → 45.
number
Vocal range end in seconds. Omit → 74.

Response

string
The vox audio ID. Use this as vox_audio_id when creating a persona.
string
The extraction status (e.g., "complete").
string
The original clip ID that was processed.
number
Detected vocal start time in seconds.
number
Detected vocal end time in seconds.
string
URL to the extracted vocal audio file.

Example

Response Example

Workflow: Creating a Vox Persona

  1. Get Vox Stem — extract vocals; save returned id as vox_audio_id
  2. Create Persona — pass root_clip_id as clip_id, plus vocal range on the root clip
Persona create vocal_start_s / vocal_end_s are the valid range on the root clip (often 0 through the clip length). They are not the same fields as getVoxStem (which defaults to 45–74 if omitted).
Use the persona in Inspiration generation with persona_style: "vox" and artist_clip_id set to the persona’s root_clip_id.