> ## 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.

# Voices

> System and cloned voices for TTS

Voices are API-only — referenced by `voiceId` in TTS and media translation; not shared with voices on vmeg.ai. See [Assets overview](/guides/assets/overview).

## Two voice types

| Type               | Source                                                   | API access                                                     |
| ------------------ | -------------------------------------------------------- | -------------------------------------------------------------- |
| **System (basic)** | Platform presets                                         | `POST /openapi/v1/assets/voice/basic/list`                     |
| **Cloned**         | [Voice clone](/guides/products/voice-clone) task success | `POST /openapi/v1/assets/voice/clone/list`, `update`, `delete` |

## `voiceId` and `provider`

Each voice in list or task responses includes:

| Field          | System presets                                                                                     | Cloned voices                                         |
| -------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| **`voiceId`**  | Stable ID from [List system voices](/api-reference/assets/voices/list-system-voices) (e.g. `sv_…`) | Stable ID from clone list or clone task (e.g. `cv_…`) |
| **`provider`** | Preset tier code `S1`–`S7`                                                                         | Clone engine `V1`–`V5`                                |

**Use the values exactly as the API returns them** — do not build or guess IDs.

* For [Text to speech](/guides/products/text-to-speech), **`voiceId` is enough**; do not send `provider` on TTS requests.
* For [Media translation](/guides/products/media-translation) webhooks, translated lines may include both fields. **Keep `voiceId` and `provider` together** when you store or edit a line for later updates.

<Note>
  Preset tiers use codes **`S1`–`S7`**; clone engines use **`V1`–`V5`**. Copy values from API responses — do not guess or construct them.
</Note>

## System voices

List available preset voices and pick a `voiceId` for [Text to speech](/guides/products/text-to-speech).

Filter options and response fields: [List system voices](/api-reference/assets/voices/list-system-voices).

Use **`displayName`** and **`localName`** for UI labels.

**`cover`** and **`audio`** are HTTPS preview URLs you can fetch directly. Use each URL exactly as returned.

## Cloned voices

When a voice clone task succeeds (sync response or async webhook), VMEG persists a clone with a new **`voiceId`**. Use it in subsequent TTS calls.

You can rename or delete clones via the clone asset endpoints. Request and response fields: [List cloned voices](/api-reference/assets/voices/list-cloned-voices), [Rename cloned voice](/api-reference/assets/voices/rename-cloned-voice), and [Delete cloned voice](/api-reference/assets/voices/delete-cloned-voice).

## Typical flow

```text theme={null}
List basic voices → copy voiceId → TTS
        or
Voice clone → voiceId in webhook/sync response → TTS
```

Supported languages for synthesis: [Supported languages](/guides/supported-languages).