Obter mecanismo de fala

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

Recupere um recurso do Speech Engine

Parâmetros de caminho

speech_engine_idstringObrigatório

O ID do mecanismo de fala (aceita o prefixo seng_ ou agent_)

Resposta

Resposta bem-sucedida

speech_engine_idstring

O ID do recurso do mecanismo de fala

namestring

Nome legível para humanos do mecanismo de fala

speech_engineobject

Configurações de conexão WebSocket para o servidor de transcrição upstream

asrobject

Configuração de reconhecimento automático de fala

ttsobject

Configuração de saída de Text to Speech

turnobject

Configuração de detecção de turno

vadobject

Configuração para detecção de atividade de voz

conversationobject

Configurações de nível de conversa, incluindo eventos do cliente e limites de duração

privacyobject

Configurações de privacidade que controlam a gravação, a retenção e o tratamento de PII

call_limitsobject

Limites de simultaneidade e de conversas diárias para este mecanismo de fala

languagestring

Código de idioma ISO usado pelo mecanismo de fala (por exemplo, ‘en’)

cascade_timeout_secondsdouble

Tempo em segundos de espera pela resposta do endpoint do mecanismo de voz upstream antes de abandonar e tentar novamente. Deve estar entre 2 e 15 segundos.

tagslist of strings

Tags arbitrárias para categorização e filtragem

overridesobject

Configurações de substituição que o cliente pode definir durante o início da conversa

metadataobject

Timestamps de criação e atualização com informações da origem

access_infoobject or nullOpcional

As informações de acesso do mecanismo de fala para o usuário

Erros

422

Unprocessable Entity Error

Parâmetros de caminho

Cabeçalhos

Resposta

Erros