Utwórz silnik mowy

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"
  }
}

Utwórz nowy zasób Speech Engine

Żądanie

This endpoint expects an object.

speech_engineobjectWymagany

Konfiguracja WebSocket silnika mowy

namestringOpcjonalnyDomyślnie Speech Engine

Nazwa silnika mowy

asrobjectOpcjonalny

Konfiguracja ASR

ttsobjectOpcjonalny

Konfiguracja TTS

turnobjectOpcjonalny

Konfiguracja wykrywania tury

vadobjectOpcjonalny

Konfiguracja wykrywania aktywności głosowej

conversationobjectOpcjonalny

Konfiguracja rozmowy (zdarzenia klienta itp.)

privacyobjectOpcjonalny

Ustawienia prywatności (nagrywanie, retencja, tryb zerowej retencji)

call_limitsobjectOpcjonalny

Limity równoległości i dzienne limity rozmów dla tego silnika mowy

languagestringOpcjonalnyDomyślnie en

Język silnika mowy

cascade_timeout_secondsdoubleOpcjonalny2-15Domyślnie 4

Czas w sekundach oczekiwania na odpowiedź endpointu nadrzędnego silnika mowy, zanim próba zostanie przerwana i ponowiona. Musi wynosić od 2 do 15 sekund.

tagslist of stringsOpcjonalny

Tagi do kategoryzacji

overridesobjectOpcjonalny

Ustawienia nadpisania, które klient może ustawić podczas rozpoczynania rozmowy

Odpowiedź

Pomyślna odpowiedź

speech_engine_idstring

Identyfikator zasobu silnika mowy

namestring

Czytelna nazwa silnika mowy

speech_engineobject

Ustawienia połączenia WebSocket dla nadrzędnego serwera transkrypcji

asrobject

Konfiguracja automatycznego rozpoznawania mowy

ttsobject

Konfiguracja wyjściowa zamiany tekstu na mowę

turnobject

Konfiguracja wykrywania tury

vadobject

Konfiguracja wykrywania aktywności głosowej

conversationobject

Ustawienia na poziomie rozmowy, w tym zdarzenia klienta i limity czasu trwania

privacyobject

Ustawienia prywatności kontrolujące nagrywanie, retencję i obsługę PII

call_limitsobject

Limity równoległości i dzienne limity rozmów dla tego silnika mowy

languagestring

Kod języka ISO używany przez silnik mowy (np. „en”)

cascade_timeout_secondsdouble

Czas w sekundach oczekiwania na odpowiedź endpointu nadrzędnego silnika mowy, zanim próba zostanie przerwana i ponowiona. Musi wynosić od 2 do 15 sekund.

tagslist of strings

Dowolne tagi do kategoryzacji i filtrowania

overridesobject

Ustawienia nadpisania, które klient może ustawić podczas rozpoczynania rozmowy

metadataobject

Znaczniki czasu utworzenia i aktualizacji z informacją o źródle

access_infoobject or nullOpcjonalny

Informacje o dostępie użytkownika do silnika mowy

Błędy

422

Unprocessable Entity Error

Nagłówki

Żądanie

Odpowiedź

Błędy