> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gradium.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Voices

> Clone your own voice using a short audio sample

Create your own custom voice clones from audio samples. Custom voices are passed to TTS using the `voice_id` parameter (not `voice`).

## Create a Custom Voice

Upload an audio file to create a new voice clone. A minimum of 10 seconds of clear audio is recommended for best results.

```python theme={null}
import json
import gradium

client = gradium.client.GradiumClient()

voice = await gradium.voices.create(
    client,
    audio_file="my_voice_sample.wav",
    name="My Custom Voice",
    description="A voice created from my recording",
    start_s=0.0,
)
print(json.dumps(voice, indent=2))
```

### Parameters

| Parameter      | Type     | Required | Description                                                                 |
| :------------- | :------- | :------: | :-------------------------------------------------------------------------- |
| `audio_file`   | `string` |    Yes   | Path to the audio file (WAV, MP3, etc.)                                     |
| `name`         | `string` |    Yes   | A name for the voice                                                        |
| `description`  | `string` |    No    | A description of the voice                                                  |
| `language`     | `string` |    No    | Language hint for the voice (e.g. `"en"`, `"fr"`, `"de"`, `"es"`, `"pt"`)   |
| `start_s`      | `float`  |    No    | Start time in seconds to begin sampling from the audio file (default `0.0`) |
| `timeout_s`    | `float`  |    No    | Maximum seconds to wait for embedding extraction (default `10.0`)           |
| `input_format` | `string` |    No    | Audio format. If omitted, inferred from the file extension                  |