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

# ボイス

> OneInbox は Cartesia、Deepgram、ElevenLabs、OpenAI、Minimax、Shisa 全体で 28 種類の即使用可能なボイスを提供します。代わりにサードパーティプロバイダーの特定のカスタムボイスを使用したい場合はこのガイドに従ってください。

## デフォルトボイス

OneInbox は Cartesia、Deepgram、ElevenLabs、OpenAI、Minimax、Shisa 全体で **28 種類のボイスをすぐに使える**状態で提供します — セットアップ不要です。エージェントに `tts.voice_id` を設定するだけで即座に使用できます。

全リスト（ボイス ID 付き）はいつでも閲覧できます：

```bash theme={null}
curl "https://api.oneinbox.ai/v1/voices" \
  -H "Authorization: Bearer <api_key>"

# プロバイダーでフィルタ
curl "https://api.oneinbox.ai/v1/voices?provider=cartesia" \
  -H "Authorization: Bearer <api_key>"
```

<Note>
  `tts.voice_id` には必ずボイスオブジェクトの `id` フィールド（`vc_...`）を使用してください — `provider_voice_id` は使用しないでください。プロバイダーのネイティブ ID（例：Cartesia の UUID や Deepgram のモデル名）を渡すと `VOICE_NOT_FOUND` エラーが返されます。
</Note>

***

## ボイスの仕組み

すべてのエージェントにはその音声を制御する TTS（テキスト読み上げ）設定があります。エージェント作成時にデフォルトのボイスが自動的に割り当てられます — [ブラウザでのクイック通話](/concepts/agents#create-an-agent)（電話番号不要）または実際の電話通話ですぐに聴くことができます。

ElevenLabs、Cartesia、または別のプロバイダーのカスタムボイスを使用したい場合はこのガイドに従ってください。切り替えるには、エージェントに `provider` と `voice_id` を設定します。`voice_id` はボイスをインポートしたときに返される OneInbox `id`（`vc_abc123`）です（以下を参照）。

```bash theme={null}
curl -X PATCH https://api.oneinbox.ai/v1/agents/<agent_id> \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "tts": {
      "provider": "elevenlabs",
      "voice_id": "<vc_abc123>"
    }
  }'
```

***

## ステップ 1 — プロバイダーのインテグレーションを追加する

28 種類のプラットフォームボイス以外のボイスをインポートしたい場合は、まずサードパーティプロバイダーのインテグレーションを追加する必要があります。インテグレーションはプロバイダーの API キーを安全に保存し、OneInbox があなたの代わりに認証できるようにします。

### ElevenLabs

```bash theme={null}
curl -X POST https://api.oneinbox.ai/v1/integrations \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ElevenLabs",
    "provider": "elevenlabs",
    "api_key": "<elevenlabs_api_key>"
  }'
```

### Cartesia

```bash theme={null}
curl -X POST https://api.oneinbox.ai/v1/integrations \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Cartesia",
    "provider": "cartesia",
    "api_key": "<cartesia_api_key>"
  }'
```

どちらもインテグレーションの `id` を返します — ステップ 2 のために保存しておいてください。

***

## ステップ 2 — ボイスをインポートする

プロバイダーのボイス ID を使ってプロバイダーの特定のボイスを OneInbox にインポートします。プロバイダーのボイス ID はプロバイダーのボイスライブラリのネイティブ ID です（OneInbox の ID ではありません）。

```bash theme={null}
curl -X POST https://api.oneinbox.ai/v1/voices/import \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "elevenlabs",
    "provider_voice_id": "21m00Tcm4TlvDq8ikWAM",
    "name": "Rachel",
    "credential_id": "<crd_abc123>",
    "gender": "female",
    "language": "en",
    "accent": "American"
  }'
```

```json theme={null}
{
  "id": "vc_abc123",
  "name": "Rachel",
  "provider": "elevenlabs",
  "provider_voice_id": "21m00Tcm4TlvDq8ikWAM"
}
```

`id` フィールド（`vc_abc123`）が OneInbox のボイス ID です — 次のステップでエージェントにボイスを割り当てる際に使用します。

***

## ステップ 3 — エージェントにボイスを割り当てる

インポートレスポンスの OneInbox `id`（`vc_abc123`）を使ってエージェントにボイスを割り当てます。これによりエージェントはすべての通話でその特定のボイスを使用します。

```bash theme={null}
curl -X PATCH https://api.oneinbox.ai/v1/agents/<agent_id> \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "tts": {
      "provider": "elevenlabs",
      "voice_id": "vc_abc123",
      "speed": 1.0
    }
  }'
```

| フィールド       | 範囲      | 役割                                        |
| ----------- | ------- | ----------------------------------------- |
| `voice_id`  | —       | インポートレスポンスの OneInbox `id`（形式：`vc_abc123`） |
| `speed`     | 0.5〜2.0 | 再生速度。`1.0` が通常の発話速度                       |
| `stability` | 0.0〜1.0 | ボイスの一貫性。高いほど安定したトーン、低いほど表現豊か              |

***

## ボイスを取得する

OneInbox ID で単一のボイスを取得します。

```bash theme={null}
curl https://api.oneinbox.ai/v1/voices/<voice_id> \
  -H "Authorization: Bearer <api_key>"
```

***

## インポートされたボイスを一覧表示する

アカウント内のすべてのボイスを取得するか、プロバイダーでフィルタします：

```bash theme={null}
# アカウント内のすべてのボイス
curl https://api.oneinbox.ai/v1/voices \
  -H "Authorization: Bearer <api_key>"

# プロバイダーでフィルタ
curl "https://api.oneinbox.ai/v1/voices?provider=elevenlabs" \
  -H "Authorization: Bearer <api_key>"
```

各ボイスオブジェクト：

```json theme={null}
{
  "id": "vc_abc123",
  "name": "Rachel",
  "provider": "elevenlabs",
  "provider_voice_id": "21m00Tcm4TlvDq8ikWAM",
  "gender": "female",
  "language": "en",
  "accent": "American"
}
```

***

## API リファレンス

[ボイス一覧](/api-reference/voices/list-voices) · [ボイス取得](/api-reference/voices/get-voice) · [ボイスインポート](/api-reference/voices/import-voice)