Actualizar motor de voz

PATCH

/v1/speech-engine/:speech_engine_id

PATCH

/v1/speech-engine/:speech_engine_id

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

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

Actualiza un recurso de Motor de Voz (actualización parcial)

Parámetros de ruta

speech_engine_idstringRequerido

El ID del motor de voz (acepta el prefijo seng_ o agent_).

Solicitud

This endpoint expects an object.

namestring or nullOpcional

speech_engineobject or nullOpcional

asrobject or nullOpcional

ttsobject or nullOpcional

turnobject or nullOpcional

vadobject or nullOpcional

conversationobject or nullOpcional

privacyobject or nullOpcional

call_limitsobject or nullOpcional

languagestring or nullOpcional

cascade_timeout_secondsdouble or nullOpcional2-15

Tiempo en segundos que se espera la respuesta de la ruta de API del motor de voz ascendente antes de abandonar el intento y volver a intentarlo. Debe estar entre 2 y 15 segundos.

tagslist of strings or nullOpcional

overridesobject or nullOpcional

Respuesta

Respuesta correcta.

speech_engine_idstring

El ID del recurso del motor de voz.

namestring

Nombre legible para humanos del motor de voz

speech_engineobject

Ajustes de conexión WebSocket para el servidor de transcripciones ascendente

asrobject

Configuración del reconocimiento automático de voz

ttsobject

Configuración de salida de texto a voz.

turnobject

Configuración de detección de turnos

vadobject

Configuración de la detección de actividad de voz

conversationobject

Configuración a nivel de conversación, incluidos los eventos del cliente y los límites de duración

privacyobject

Configuración de privacidad que controla la grabación, la retención y el tratamiento de información personal identificable

call_limitsobject

Límites de simultaneidad y de conversaciones diarias para este motor de voz

languagestring

Código de idioma ISO usado por el motor de voz (por ejemplo, «en»)

cascade_timeout_secondsdouble

Tiempo en segundos que se espera la respuesta de la ruta de API del motor de voz ascendente antes de abandonar el intento y volver a intentarlo. Debe estar entre 2 y 15 segundos.

tagslist of strings

Etiquetas arbitrarias para categorizar y filtrar

overridesobject

Configuración que el cliente puede anular al iniciar la conversación

metadataobject

Marcas de tiempo de creación y actualización con información del origen

access_infoobject or nullOpcional

La información de acceso del motor de voz para el usuario.

Errores

422

Unprocessable Entity Error

Parámetros de ruta

Encabezados

Solicitud

Respuesta

Errores