Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"

Body

multipart/form-data
files
file[]
required

Audio files to use for voice cloning. Up to 25 files allowed. For Cartesia and MiniMax, only 1 file is supported. For Inworld, up to 3 files are supported.

voice_name
string
required

Name for the cloned voice

Required string length: 1 - 200
voice_provider
enum<string>
required

Voice provider to use for cloning.

Available options:
elevenlabs,
cartesia,
minimax,
fish_audio,
platform

Response

Voice cloned successfully

voice_id
string
required

Unique id for the voice.

Example:

"retell-Cimo"

voice_name
string
required

Name of the voice.

Example:

"Adrian"

provider
enum<string>
required

Indicates the provider of voice.

Available options:
elevenlabs,
openai,
cartesia,
minimax,
fish_audio,
platform
Example:

"elevenlabs"

gender
enum<string>
required

Gender of voice.

Available options:
male,
female
Example:

"male"

accent
string

Accent annotation of the voice.

Example:

"American"

age
string

Age annotation of the voice.

Example:

"Young"

preview_audio_url
string

URL to the preview audio of the voice.

Example:

"https://retell-utils-public.s3.us-west-2.amazonaws.com/adrian.mp3"