Skip to main content
POST
Create cloned voice
Clones a voice from an uploaded audio sample and registers it as a custom voice on your account. The returned voice_id is immediately callable through the same TTS endpoints as preset voices.
Voice cloning via the API is not available on the Free tier. Free-tier accounts can clone in Supertone Play.

Endpoint

Send as multipart/form-data.

Request body

Sample quality tips

For the best clone quality:
  • Clean, single-speaker audio with minimal background noise.
  • 5–30 seconds is usually sufficient.
  • Mono is preferred; high sample rate is fine.

Response

Returns the new custom voice object, including the assigned voice_id. Save the ID — pass it to Create speech to use the voice.

Errors

See also

Docs: Custom voices

Lifecycle walkthrough with SDK examples.

Custom voice example

End-to-end: clone, list, and call.

Authorizations

x-sup-api-key
string
header
required

Body

multipart/form-data

Audio file and voice metadata

files
file
required

Audio file to clone voice from (all common audio formats accepted, max 3MB)

name
string
required

Name of the cloned voice

description
string

Description of the cloned voice

Response

Successfully created cloned voice

voice_id
string
required

Unique identifier for the created voice

Example:

"voice_123456789"