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

# Voice clone

> Clone a voice from sample audio

Create a reusable **cloned voice** from sample audio. On success, VMEG assigns a **`voiceId`** and stores the clone as an [API voice asset](/guides/assets/voices).

## Sync vs async

| Mode  | Endpoint                                         | Results                                                                                   |
| ----- | ------------------------------------------------ | ----------------------------------------------------------------------------------------- |
| Sync  | `POST /openapi/v1/task/clone-voice/create`       | `voiceId` and sample metadata in HTTP response                                            |
| Async | `POST /openapi/v1/task/clone-voice/create-async` | [Webhook](/guides/webhook-request) when `event` is `openapi-clone-voice` (`data.voiceId`) |

Every `create` and `create-async` call requires [`X-Idempotency-Key`](/guides/idempotency). Async also needs a configured [Webhook](/guides/webhooks).

## Workflow

<Steps>
  <Step title="Prepare sample">
    Provide reference audio per request schema (URL or uploaded asset fields in API reference).
  </Step>

  <Step title="Submit clone task">
    Sync or async create endpoint with `provider` from [Supported clone methods](/guides/supported-clone-methods) and `sampleLanguage` from [Supported languages](/guides/supported-languages).
  </Step>

  <Step title="Use voiceId">
    Pass `voiceId` to [Text to speech](/guides/products/text-to-speech) requests.
  </Step>
</Steps>

## After cloning

* List clones: `POST /openapi/v1/assets/voice/clone/list`
* Rename: `POST /openapi/v1/assets/voice/clone/update`
* Delete: `POST /openapi/v1/assets/voice/clone/delete`

Clones are only available through API asset endpoints, not among voices you pick on vmeg.ai. See [Assets overview](/guides/assets/overview).

Request and callback schemas: **API reference → Voice clone** operations.

## Related

* [Voices](/guides/assets/voices)
* [Products overview](/guides/products/overview)