Separate Audio Stems
Changed onSeparate a recording of at most 3600 seconds into six stems with ElevenLabs six_stems_v1: vocals, drums, bass, guitar, piano and other. Upload the audio through the asset upload API (at most 200 MB) and pass its asset_id. The request waits for the stems and answers 200 with a time-limited mp3 url for each, every stem the full length of the audio. Each request is priced per second of the audio. A request the workspace's API credits cannot cover is refused with 402 insufficient_credit before the model runs. The credits are charged once the stems are made, and a failed separation is not charged. If the balance no longer covers the charge when the stems are ready, the request answers 402 insufficient_credit without them. Send an Idempotency-Key header with every request: it is required. Repeating a request with the same key and body returns the original stems with fresh URLs without charging again, a duplicate sent while the original is still running gets 409 request_in_progress, and the same key with a different body gets 409 conflict. Failed requests replay their stored error; use a new key for a new attempt.
Request
- Base URLhttps://api.heygen.com
- URLhttps://api.heygen.com/v3/audio/stems
- Auth
- API key in header x-api-key
- or HTTP bearer
Headers
Required client-supplied key for safely retrying a request that charges. A retry within 24 hours that shares this key returns the original response instead of running again. The body must be the same: a different body under the same key returns 409 conflict. A retry that arrives while the original is still in flight gets a 409 request_in_progress. When the original could not be confirmed, repeating it with the same key settles that attempt instead of starting another. Scope is the space plus the request path, so the same key on another video is independent, and a key sent by another member of the space replays that member's response. A missing or blank value is rejected with 400. Keys must be 1–255 characters from [A-Za-z0-9_:.-]; a UUID is a safe default.
Request body
Response
The stems with their download URLs.
Changes
- info
endpoint added
- info