Skip to main content
POST
/
v1
/
custom-voices
/
cloned-voice
Create cloned voice
curl --request POST \
  --url https://supertoneapi.com/v1/custom-voices/cloned-voice \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-sup-api-key: <api-key>' \
  --form files='@example-file' \
  --form 'name=<string>' \
  --form 'description=<string>'
{
  "voice_id": "voice_123456789"
}

Documentation Index

Fetch the complete documentation index at: https://docs.supertoneapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

POST https://supertoneapi.com/v1/custom-voices/cloned-voice
Send as multipart/form-data.

​
Request body

FieldRequiredDescription
files✅The audio sample to clone from. Must be WAV or MP3, under 3 MB.
name✅Voice name. Max 100 characters.
description—Free-form description.

​
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

StatusCause
400 Bad RequestMissing files or name, or name too long.
413 Payload Too LargeAudio file exceeds 3 MB.
415 Unsupported Media TypeFile is not WAV or MP3.
403 ForbiddenFree tier account (cloning via API not permitted).

​
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"