> 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/ja/api-reference/agents/create#request.body.conversation_config.tts.speed)で制御します。仕様は次のとおりです：

* **範囲**：0.7～1.2
* **デフォルト**：1.0
* **型**：任意

### 速度を更新する

#### ダッシュボードで更新

ダッシュボードでエージェントを開き、**Voice**タブに移動して速度制御を調整します。変更を保存してください。

![Voiceタブ内の速度制御設定](/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 },
  },
});
```

## 仕組み

速度パラメータは、音声生成のペースに影響します：

* 1.0未満の値では音声が遅くなります
* 1.0を超える値では音声が速くなります
* 1.0は通常の話す速度を表します

> **Note**
>
> 最小値または最大値に近い極端な値は、生成される音声の品質に影響する場合があります。

## ベストプラクティス

* デフォルト速度（1.0）から始め、ユーザーフィードバックに基づいて調整します
* 特定のコンテンツで異なる速度をテストします
* 速度を設定する際はターゲットオーディエンスを考慮します
* 極端な値での音声品質を監視します

> **Warning**
>
> 0.7～1.2の範囲外の値はサポートされていません。