Pobierz silnik mowy

GET

/v1/speech-engine/:speech_engine_id

GET

/v1/speech-engine/:speech_engine_id

curl https://api.elevenlabs.io/v1/speech-engine/seng_3701k3ttaq12ewp8b7qv5rfyszkz

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

Pobierz zasób Speech Engine

Parametry ścieżki

speech_engine_idstringWymagany

Identyfikator silnika mowy (akceptuje prefiks seng_ lub agent_)

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

Parametry ścieżki

Nagłówki

Odpowiedź

Błędy