> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 语速控制

## 概述

语速控制功能可让你调整智能体的说话快慢。适用于：

* 让不同受众更容易理解语音内容
* 匹配特定使用场景（例如，教育内容使用较慢语速）
* 针对不同类型的对话进行优化

## 配置

通过 [`speed` 参数](/docs/zh/api-reference/agents/create#request.body.conversation_config.tts.speed)控制语速，规格如下：

* **范围**：0.7 至 1.2
* **默认值**：1.0
* **类型**：可选

### 更新语速

#### 通过控制台更新

在控制台中打开智能体，前往 **音色** 标签页，然后调整语速控制。保存更改。

![音色标签页中的语速控制设置](/docs/_fern-img/4a1dfe1db33f9f03bb614b56173c7c00596f2d6c36b0f17ce43f151bd4d07f66.webp)

#### 通过 CLI 更新

#### 拉取智能体配置

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### 编辑 \`agent_configs/\<agent-name>.json\`

设置 `conversation_config.tts.speed`：

```json
{
  "conversation_config": {
    "tts": {
      "speed": 1.1
    }
  }
}
```

#### 推送更改

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### 通过 API 更新

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "tts": {"speed": 1.1},
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    tts: { speed: 1.1 },
  },
});
```

## 工作原理

speed 参数会影响语音生成的节奏：

* 低于 1.0 的值会降低语速
* 高于 1.0 的值会提高语速
* 1.0 表示正常语速

> **Note**
>
> 接近最小值或最大值的极端设置可能会影响生成语音的质量。

## 最佳实践

* 先使用默认语速（1.0），再根据用户反馈调整
* 使用具体内容测试不同语速
* 设置语速时考虑目标受众
* 在极端值下监控语音质量

> **Warning**
>
> 不支持 0.7–1.2 范围以外的值。