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

# 速度と感情の制御

> 生成される音声の速度と感情を制御する方法を学びます。

<Warning>
  この機能は非推奨になりました。詳細は[チェンジログ](/changelog/2025#april-2025)を参照してください。
</Warning>

速度と感情の制御は、[プレイグラウンド](https://play.cartesia.ai) およびテキスト読み上げ (TTS) エンドポイント ([Bytes](/2024-11-13/api-reference/tts/bytes)、[SSE](/2024-11-13/api-reference/tts/sse)、[WebSocket](/2024-11-13/api-reference/tts/websocket)) の API で利用できます。

<Note>
  **コントロールの効果はボイスと原稿によって異なります。** 生成された音声にアーティファクト (歪み) が発生する場合は、強度を下げたり、適用するコントロールの数を減らしてみてください。
</Note>

## プレイグラウンド

プレイグラウンドでは、Text-to-Speech タブの「Speed/Emotion」ボタンをクリックすることで、速度と感情のコントロールにアクセスできます。

<Frame>
  <img src="https://mintcdn.com/cartesia-2650f86a/N8b057CQHGBDct9c/assets/images/speed-emotion-pg.png?fit=max&auto=format&n=N8b057CQHGBDct9c&q=85&s=f0e6ce58c828b075d43940bf14016408" width="1552" height="572" data-path="assets/images/speed-emotion-pg.png" />
</Frame>

## API

<Warning>
  この機能は現在実験的なものであり、互換性のない変更が加えられる可能性があります。
</Warning>

API でコントロールを使用するには、API リクエストの `voice` オブジェクトに `__experimental_controls` ディクショナリを追加します。

```json theme={null}
"voice": {
  "mode": "id",
  "id": "VOICE_ID",
  "__experimental_controls": {
    "speed": "normal",
    "emotion": [
      "positivity:high",
      "curiosity"
    ]
  }
}
```

### 速度オプション

* `"slowest"`: 非常に遅い音声
* `"slow"`: 通常よりも遅い音声
* `"normal"`: デフォルトの速度
* `"fast"`: 通常よりも速い音声
* `"fastest"`: 非常に速い音声

より細かい制御を行うには、速度を $[-1.0, 1.0]$ の範囲内の数値で定義できます。0 はデフォルト速度を表し、負の値で音声が遅くなり、正の値で速くなります。

<CodeGroup>
  ```json Using a label theme={null}
  "__experimental_controls": {
    "speed": "fast"
  }
  ```

  ```json Using a number theme={null}
  "__experimental_controls": {
    "speed": -0.1
  }
  ```
</CodeGroup>

### 感情オプション

`emotion` パラメータは、`emotion_name:level` 形式の「タグ」の配列です。例: `positivity:high` や `curiosity`。

#### 感情名

* `anger`
* `positivity`
* `surprise`
* `sadness`
* `curiosity`

#### 感情レベル

<Note>
  **感情のコントロールは加算的なものであり、感情を減らしたり取り除いたりすることはできません。** たとえば、`anger:low` はボイスにわずかな怒りを加えるもので、ボイスから怒りを減らすものではありません。
</Note>

* `lowest`
* `low`
* (中程度の感情の追加にはレベルを省略します)
* `high`
* `highest`