音声エンジンを作成

POST

/v1/speech-engine

POST

/v1/speech-engine

curl -X POST https://api.elevenlabs.io/v1/speech-engine \
     -H "Content-Type: application/json" \
     -d '{
  "speech_engine": {
    "ws_url": "string"
  }
}'

{
  "speech_engine_id": "seng_3701k3ttaq12ewp8b7qv5rfyszkz",
  "name": "My Speech Engine",
  "speech_engine": {
    "ws_url": "wss://example.com/transcript",
    "request_headers": {}
  },
  "asr": {
    "quality": "high",
    "provider": "elevenlabs",
    "user_input_audio_format": "pcm_16000",
    "keywords": []
  },
  "tts": {
    "model_id": "eleven_flash_v2",
    "voice_id": "cjVigY5qzO86Huf0OWal",
    "agent_output_audio_format": "pcm_16000",
    "stability": 0.5,
    "speed": 1,
    "similarity_boost": 0.8,
    "optimize_streaming_latency": 3
  },
  "turn": {
    "turn_timeout": 7,
    "silence_end_call_timeout": -1,
    "turn_eagerness": "normal",
    "mode": "turn"
  },
  "vad": {
    "background_voice_detection": false
  },
  "conversation": {
    "max_duration_seconds": 600,
    "client_events": [
      "audio",
      "interruption",
      "agent_response",
      "user_transcript"
    ]
  },
  "privacy": {
    "record_voice": true,
    "retention_days": -1,
    "delete_transcript_and_pii": false,
    "delete_audio": false,
    "apply_to_existing_conversations": false,
    "zero_retention_mode": false
  },
  "call_limits": {
    "agent_concurrency_limit": -1,
    "daily_limit": 100000,
    "bursting_enabled": true
  },
  "language": "en",
  "cascade_timeout_seconds": 4,
  "tags": [
    "production",
    "v1"
  ],
  "overrides": {
    "first_message": false
  },
  "metadata": {
    "created_at_unix_secs": 1714000000,
    "updated_at_unix_secs": 1714000000,
    "created_from": "api",
    "last_updated_from": "api"
  }
}

新しいSpeech Engineリソースを作成します

リクエスト

This endpoint expects an object.

speech_engineobject必須

Speech EngineのWebSocket設定

namestringオプションデフォルト値 Speech Engine

音声エンジンの名前

asrobjectオプション

ASR設定

ttsobjectオプション

TTS設定

turnobjectオプション

ターン検出設定

vadobjectオプション

音声アクティビティ検出の設定

conversationobjectオプション

会話設定（クライアントイベントなど）

privacyobjectオプション

プライバシー設定（録音、保持、ゼロ保持モード）

call_limitsobjectオプション

この音声エンジンの同時実行数および1日の会話数制限

languagestringオプションデフォルト値 en

音声エンジンの言語

cascade_timeout_secondsdoubleオプション2-15デフォルト値 4

試行を中止して再試行するまで、上流のスピーチエンジンエンドポイントの応答を待つ時間（秒）。2～15秒である必要があります。

tagslist of stringsオプション

分類用タグ。

overridesobjectオプション

会話の開始時にクライアントが設定できるオーバーライド設定

レスポンス

成功レスポンス。

speech_engine_idstring

音声エンジンリソースID

namestring

人間が読めるSpeech Engine名

speech_engineobject

アップストリーム文字起こしサーバーのWebSocket接続設定

asrobject

自動音声認識の設定

ttsobject

テキスト読み上げの出力設定。

turnobject

ターン検出設定

vadobject

音声アクティビティ検出の設定

conversationobject

クライアントイベントや時間制限を含む会話レベルの設定

privacyobject

録音、保持、PIIの取り扱いを制御するプライバシー設定

call_limitsobject

この音声エンジンの同時実行数および1日の会話数制限

languagestring

音声エンジンで使用するISO言語コード（例：‘en’）

cascade_timeout_secondsdouble

試行を中止して再試行するまで、上流のスピーチエンジンエンドポイントの応答を待つ時間（秒）。2～15秒である必要があります。

tagslist of strings

分類とフィルタリングのための任意のタグ

overridesobject

会話の開始時にクライアントが設定できるオーバーライド設定

metadataobject

ソース情報を含む作成および更新タイムスタンプ

access_infoobject or nullオプション

ユーザーに対する音声エンジンのアクセス情報。

エラー

422

Unprocessable Entity Error

ヘッダー

リクエスト

レスポンス

エラー