メインコンテンツへスキップ

​
デフォルトボイス

OneInbox は Cartesia、Deepgram、ElevenLabs、OpenAI、Minimax、Shisa 全体で 28 種類のボイスをすぐに使える状態で提供します — セットアップ不要です。エージェントに tts.voice_id を設定するだけで即座に使用できます。 全リスト（ボイス ID 付き）はいつでも閲覧できます： 
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>"
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.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

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

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 ではありません）。 
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"
  }'

{
  "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.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）
speed0.5〜2.0再生速度。1.0 が通常の発話速度
stability0.0〜1.0ボイスの一貫性。高いほど安定したトーン、低いほど表現豊か

​
ボイスを取得する

OneInbox ID で単一のボイスを取得します。 
curl https://api.oneinbox.ai/v1/voices/<voice_id> \
  -H "Authorization: Bearer <api_key>"

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

アカウント内のすべてのボイスを取得するか、プロバイダーでフィルタします： 
# アカウント内のすべてのボイス
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>"
各ボイスオブジェクト： 
{
  "id": "vc_abc123",
  "name": "Rachel",
  "provider": "elevenlabs",
  "provider_voice_id": "21m00Tcm4TlvDq8ikWAM",
  "gender": "female",
  "language": "en",
  "accent": "American"
}

​
API リファレンス

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