> Append .md to any page URL for clean Markdown. Index: https://docs.speechify.ai/llms.txt.
>
> Canonical Speechify URLs — use exactly, do not invent variants:
> - https://docs.speechify.ai — this site (API reference, SDKs, quickstarts)
> - https://speechify.ai — marketing + product site
> - https://platform.speechify.ai — customer dashboard, signup, API keys, billing
> - https://api.speechify.ai — API base URL
> - https://github.com/SpeechifyInc — GitHub org. `github.com/speechify` does not exist.
> - https://status.speechify.ai — status + incidents
> - https://speechify.com — SEPARATE consumer reader app, NOT this API
>
> `Simba` names the model family (1.6 multilingual, 3.0 streaming), not the brand. `SimbaVoice` / `simbavoice.ai` are retired.

# Voice Cloning

> Clone a custom voice from a 10-30 second sample with the Speechify API: create the voice, use it in any speech request, and delete it when done.

## Overview

Clone any voice from a 10-30 second audio sample. The cloned voice captures accent, speaking style, and tone. There's no limit to the number of voices you can create.

## Requirements

| Parameter | Requirement                                                             |
| --------- | ----------------------------------------------------------------------- |
| Duration  | 10-30 seconds (under 1 minute)                                          |
| File size | Under 5MB                                                               |
| Quality   | Clear speech, minimal background noise                                  |
| Language  | Any [supported language](/build/guides/text-to-speech/language-support) |

Use a good microphone and a quiet room. The clone quality depends directly on sample quality.

## Create a cloned voice

### Request

POST [https://api.speechify.ai/v1/voices](https://api.speechify.ai/v1/voices)

```curl
curl -X POST https://api.speechify.ai/v1/voices \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: multipart/form-data" \
     -F avatar=@<file1> \
     -F consent="string" \
     -F gender="male" \
     -F name="string" \
     -F sample=@string
```

```typescript
import { SpeechifyClient } from "@speechify/api";

async function main() {
    const client = new SpeechifyClient({
        token: "YOUR_TOKEN_HERE",
    });
    await client.voices.create({});
}
main();

```

```python
from speechify import Speechify

client = Speechify(
    token="YOUR_TOKEN_HERE",
)

client.voices.create(
    sample="example_sample",
    avatar="example_avatar",
)

```

Consent is required and is sent as a JSON string containing the `fullName` and `email` of the person who owns the voice (e.g. `{"fullName": "...", "email": "..."}`), confirming the voice belongs to you or someone you represent.

## Use the cloned voice

Pass the voice ID from the creation response to any speech endpoint:

```python
response = client.audio.speech(
    input="This is my cloned voice speaking.",
    voice_id=voice.id,
    audio_format="mp3",
)
```

```typescript
const response = await client.audio.speech({
    input: "This is my cloned voice speaking.",
    voiceId: voice.id,
    audioFormat: "mp3",
});
```

```bash
curl -X POST https://api.speechify.ai/v1/audio/speech \
  -H "Authorization: Bearer $SPEECHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "This is my cloned voice speaking.",
    "voice_id": "voice_demo0001",
    "audio_format": "mp3"
  }'
```

Cloned voices also appear in the [voices list](/build/api-reference/v1/voices/get) alongside Speechify's built-in voices.

## Delete a voice

Remove voices you no longer need:

## Console UI

You can also clone voices through the [Speechify Console](https://platform.speechify.ai/voice-cloning) without writing code:

Import an existing audio file containing the voice

Record directly from your browser

## Sample recording tips

If you need text to read while recording, try this:

> Listening is like riding a storytelling rollercoaster, where you can lean back and enjoy the ride without having to steer. The speaker's voice becomes your trusty guide, leading you through twists and turns. It's like having a personal audiobook adventure just for you! So, buckle up, and let the fun begin!

For best results:

* Speak naturally at a consistent pace
* Avoid whispering or shouting
* Minimize pauses longer than 2 seconds
* Record in a quiet environment without echo