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
  },
  "auth": {
    "enable_auth": false
  },
  "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

authobject or nullOpcional

Quién puede iniciar una conversación con este motor de voz.

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

authobject

Quién puede iniciar una conversación con 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