Voices API

Clone Voice

Clone a custom voice from an audio or video sample and get back its id for use in POST /v2/tts and generation text inputs. Provide either a sync. labs-hosted url or an assetId — upload local files via POST /v2/assets/upload first. Video sources have their audio track extracted automatically (first 2 minutes). Clone slots are limited per plan.

Authentication

x-api-keystring
API Key authentication via header

Request

This endpoint expects an object.
namestringRequired
A name for the cloned voice.
providerenumRequired

The provider to clone the voice with. Currently elevenlabs.

urlstringOptional

A sync. labs-hosted url of the audio or video sample to clone from. Provide exactly one of url or assetId.

assetIdstringOptional

The id of a previously uploaded audio or video asset to clone from. Provide exactly one of url or assetId.

Response

Voice cloned successfully
voiceIdstring
The id to use for this voice in TTS and generation text inputs.
namestring
The name of the cloned voice.
internalVoiceIdstring
The internal id of the cloned voice.

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
500
Internal Server Error