Skip to main content
POST
Create an Instant Voice Clone
Creating a clone uses one private voice slot and has no separate creation fee. Prepare the recordings. Aim for about 1–2 minutes in total across all samples. Use one speaker with a consistent speaking style and recording level. Avoid background noise and room reverb. Upload limits. Send 1–10 nonempty files by repeating the multipart files field. The entire multipart body, including form headers and boundaries, must fit within 4 MiB. Set consent=true to confirm you have the rights and consent to clone the speaker.
Without an Idempotency-Key, uploading twice can create two voices. For a safe retry, keep the same fields, file order, names, media types and contents.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Scoped to the workspace and creation operation. Without this header each submission is independent and can occupy another slot. To retry safely, reuse the same key and input. Changing the input under the same key returns 409.

Required string length: 1 - 128
Pattern: ^[!-~]{1,128}$

Body

multipart/form-data
name
string
required

Name that identifies the voice.

Required string length: 1 - 100
files
file[]
required

Audio recordings of the speaker to clone. Repeat this field for multiple files.

Required array length: 1 - 10 elements

Confirm that you have the rights and consent to clone this voice.

Available options:
true
description
string

Description of the voice.

Required string length: 1 - 1000
remove_background_noise
boolean
default:false

Remove background noise from the recordings. Leave off for clean samples; processing them can reduce clone quality.

Response

Saved voice or idempotent replay. Use for generation when active.

name
string
required
kind
enum<string>
required
Available options:
clone,
design
status
enum<string>
required
Available options:
creating,
reconciling,
active,
verificationRequired,
failed,
deleting,
deleted
models
string[]
required
operationId
string<uuid>

Creation tracking ID returned while pending.

statusUrl
string

Relative URL for polling a pending creation with the workspace API key.

id
string

Same as voiceId once the voice has an ID.

voiceId
string

Same value as id. Use for speech and dialogue when active.

message
string

Optional provider explanation on a failed or reconciling private voice. Use status to determine the outcome.