ボイス

デフォルトボイス

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

プロバイダー	ボイス数	言語
Deepgram (aura-2)	160	en, es, de, fr, it, nl, ja
Shisa	77	ja, en
Cartesia	40	en, ja
ElevenLabs	6	en
OpenAI	6	en
Soniox	6	en
Minimax	4	en, zh

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

curl "https://api-tokyo.oneinbox.ai/v1/voices" \
  -H "Authorization: Bearer <api_key>"

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

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

ボイスの仕組み

すべてのエージェントにはその音声を制御する TTS（テキスト読み上げ）設定があります。エージェント作成時にデフォルトのボイスが自動的に割り当てられます — ブラウザでのクイック通話（電話番号不要）または実際の電話通話ですぐに聴くことができます。 ElevenLabs、Cartesia、または別のプロバイダーのカスタムボイスを使用したい場合はこのガイドに従ってください。切り替えるには、エージェントに provider と voice_id を設定します。voice_id はボイスをインポートしたときに返される OneInbox id（vc_abc123）です（以下を参照）。

curl -X PATCH https://api-tokyo.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 — プロバイダーのインテグレーションを追加する

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

ElevenLabs

curl -X POST https://api-tokyo.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

curl -X POST https://api-tokyo.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 ではありません）。

curl -X POST https://api-tokyo.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"
  }'

{
  "id": "vc_abc123",
  "name": "Rachel",
  "provider": "elevenlabs",
  "provider_voice_id": "21m00Tcm4TlvDq8ikWAM"
}

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

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

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

curl -X PATCH https://api-tokyo.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 で単一のボイスを取得します。

curl https://api-tokyo.oneinbox.ai/v1/voices/<voice_id> \
  -H "Authorization: Bearer <api_key>"

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

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

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

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

各ボイスオブジェクト：

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

API リファレンス

ボイス一覧 · ボイス取得 · ボイスインポート

はじめる

通話を行う

エージェントを設定する

監視・統合

コアコンセプト

デフォルトボイス

ボイスの仕組み

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

ElevenLabs

Cartesia

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

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

ボイスを取得する

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

API リファレンス

​デフォルトボイス

​ボイスの仕組み

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

​ElevenLabs

​Cartesia

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

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

​ボイスを取得する

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

​API リファレンス

デフォルトボイス

ボイスの仕組み

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

ElevenLabs

Cartesia

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

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

ボイスを取得する

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

API リファレンス