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

# 文本转语音

> 文本合成语音

使用系统或克隆 **voiceId** 将文本合成为语音。从 [音色](/zh/guides/assets/voices) 列表或克隆结果中复制 ID。

## 同步与异步

| 模式 | 接口                                       | 结果                                                                            |
| -- | ---------------------------------------- | ----------------------------------------------------------------------------- |
| 同步 | `POST /openapi/v1/task/tts/create`       | HTTP `data.results[].uri`（CDN 音频）                                             |
| 异步 | `POST /openapi/v1/task/tts/create-async` | [Webhook](/zh/guides/webhook-request)，`event` 为 `openapi-tts`（`data.results`） |

`create` 与 `create-async` 均须 [`X-Idempotency-Key`](/zh/guides/idempotency)；异步还须配置 [Webhook](/zh/guides/webhooks)。

## 流程（同步）

完整 curl 见 [快速开始](/zh/guides/quickstart)。

主要字段：

* `language.target` — [支持的语言](/zh/guides/supported-languages)
* `data[]` — 最多 50 条；每条需 `text` 与 `voiceId`（或 `timbreRefAudio`）
* `outputFormat` — `wav`、`mp3`、`m4a`

**不要传 `provider`。** 使用音色列表或克隆结果里的 **`voiceId`** 即可，服务会自动匹配对应引擎。同一请求内所有音色须属于 **同一预设档位或同一克隆引擎**（见 [支持的克隆方式](/zh/guides/supported-clone-methods#文本转语音voiceid-与-provider) 与 [错误码](/zh/guides/errors)）。

## 流程（异步）

1. 配置 [Webhooks](/zh/guides/webhooks)
2. 带幂等键 POST `create-async`
3. 从 Webhook `data.results` 取音频 URL

## 音色

* **系统音色**：`POST /openapi/v1/assets/voice/basic/list` → 复制 `voiceId`
* **克隆音色**：[声音克隆](/zh/guides/products/voice-clone) → 复制返回的 `voiceId`

完整 schema：**API 参考 → TTS**。

## 相关

* [产品概览](/zh/guides/products/overview)
* [使用限制](/zh/guides/usage-limits) — 批量上限