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

# 语音库、预览和自定义语音

> 搜索并预览 ThunderPhone 语音，生成语音示例，申请自定义语音访问权限，从音频创建语音，并管理语音定价和状态。

打开 **声音**（`/dashboard/voices`）以浏览适用于您的智能体的声音，并在您的组织已启用该功能时，使用简短音频样本创建自定义声音。

## 浏览声音库

使用搜索功能以及 **语言** 和 **性别** 筛选器缩小目录范围。每一行都会显示声音名称、支持的语言信息、内置音频样本，以及适用于全部或部分语言的高级附加费。

智能体构建器会将此目录筛选为与智能体主要语言和附加语言兼容的声音。在声音库中选择声音不会更改智能体；请打开智能体的 **配置** 选项卡进行分配。

## 试听声音朗读您的文本

选择 **让 *声音* 朗读您的文本**，输入 **1–500 个字符**，选择支持的语言，然后生成样本。

* 每个新样本将从组织余额中扣除 **3 美分**。
* 确认对话框会在生成前显示费用。
* 完全相同的缓存样本将免费提供，并标记为 **从缓存提供**。
* 每个组织每小时最多可创建 **30 个样本**。
* 仅可使用该声音支持的语言试听声音。

[声音样本 API](/api-reference/voice-samples) 以编程方式提供相同的工作流程。

## 申请自定义声音访问权限

自定义声音按组织启用。如果尚未启用访问权限，请选择 **申请访问权限**，输入您需要的声音名额数量，并可选择在最多 **2,000 个字符**内描述使用场景。

一次只能有一个待处理的申请。启用访问权限后，页面会显示已使用和可用的自定义声音名额数量。需要更高配额时，请使用 **申请更多名额**。

## 创建自定义声音

<Steps>
  <Step title="确认您的权利">
    确认您拥有使用和克隆该声音的权利。未完成此确认，无法创建自定义声音。
  </Step>

  <Step title="录制或上传清晰样本">
    在浏览器中录制最长 15 秒的音频，或上传最大 **4 MB** 的 **WAV** 或 **MP3** 文件。请使用单一说话者、稳定语速，并尽可能减少背景噪声。
  </Step>

  <Step title="命名并分类">
    输入长度为 1–100 个字符的名称，选择其语言，并可选择将声音标记为女性或男性。选择 **创建声音**。
  </Step>
</Steps>

创建过程为异步。声音会处于 **创建中**、**就绪** 或 **失败** 状态。就绪的声音可以播放并分配给智能体；失败的声音可以使用新样本重试。

<Note>
  自定义声音语言选择器包含支持创建自定义声音的语言。其范围可能小于完整的[语音智能体语言目录](/zh/guides/supported-languages)。
</Note>

## 重命名、重试和删除

* **重命名** 会更改整个控制台中显示的标签，但不会更改声音 ID。
* **重试** 会在失败后启动新的创建尝试。
* **删除** 会从您组织的选择器中移除该声音，并释放其配额名额。已在使用该声音的智能体会保留其已保存的配置，直到您使用其他声音重新保存它们。

有关完整的对象、状态、配额申请、试听、重命名和删除协议，请参阅[自定义声音 API](/api-reference/custom-voices)。

## 定价

固定的高级声音/语言组合会在声音库和构建器中标记为 **+3 美分/分钟**。实际语音附加费基于实际的声音语言组合；语言标签和高级声音标签不会叠加为两项独立的 3 美分费用。适用时，组织专属的自定义声音定价会由自定义声音策略返回，并反映在构建器的综合费率中。