Referencia de eventos en tiempo real | ElevenLabs Documentation

Referencia · Enumera todos los eventos enviados a la API WebSocket de Voz a Texto en Tiempo Real y recibidos de ella.

Consulta la referencia de la API de Voz a Texto en Tiempo Real para obtener más información sobre la API y sus opciones.

committed_transcript es el evento final y estable de cada segmento. La API pública no emite un evento final_transcript independiente.

Eventos enviados

Evento	Descripción	Cuándo usarlo
`input_audio_chunk`	Envía datos de audio para transcribir	De forma continua durante la transmisión de audio

Eventos recibidos

Evento	Descripción	Cuándo se recibe
`session_started`	Confirma la conexión y devuelve la configuración de la sesión	Inmediatamente después de establecerse la conexión WebSocket
`partial_transcript`	Actualización de la transcripción en directo del segmento en curso. Los parciales posteriores sustituyen a los anteriores. También se envía como mensaje de mantenimiento: `text` vacío si el segmento no tiene texto sin confirmar, o una repetición del último parcial si lo tiene	Durante el procesamiento de audio, antes de realizar una confirmación. También se envía como mensaje de mantenimiento aproximadamente una vez por `keepalive_interval_ms` cuando está configurado
`committed_transcript`	Transcripción consolidada de un segmento. Es el texto final y estable del segmento, y no cambiará	Después de una confirmación (manual o activada por VAD)
`committed_transcript_with_timestamps`	Transcripción confirmada con marcas de tiempo a nivel de palabra y el `language_code` detectado	Se envía después de la transcripción confirmada. Solo se recibe cuando se incluye `include_timestamps=true` o `include_language_detection=true` en los parámetros de consulta
`committed_transcript_entities`	Entidades detectadas en el segmento de transcripción confirmada, con desplazamientos de caracteres	Se envía poco después de cada transcripción confirmada. Solo se recibe cuando se incluye `entity_detection` en los parámetros de consulta
`edited_transcript`	Versión editada del segmento de transcripción confirmada, junto con el texto confirmado original	Se envía poco después de cada transcripción confirmada. Solo se recibe cuando se incluye `transcript_edit` en los parámetros de consulta

Gestión de errores

Si ocurre un error, se devolverá un mensaje de error antes de que se cierre la conexión WebSocket.

Tipo de error	Descripción
`auth_error`	Se produjo un error al autenticar la solicitud. Comprueba de nuevo tu clave de API
`quota_exceeded`	Has superado tu cuota de uso
`transcriber_error`	Se produjo un error al transcribir el audio.
`input_error`	Se produjo un error al procesar el fragmento de audio. Probablemente se deba a un formato de entrada o parámetros no válidos
`invalid_request`	Se rechazaron los parámetros de conexión. Comprueba los parámetros de consulta con la referencia de la API
`error`	Un error genérico del servidor
`commit_throttled`	La confirmación se limitó debido a demasiadas solicitudes de confirmación realizadas en un breve periodo de tiempo
`unaccepted_terms`	No has aceptado las condiciones del servicio para usar Scribe. Revisa y acepta los términos y condiciones en el panel de ElevenLabs
`rate_limited`	Has alcanzado el límite de solicitudes. Reduce la cantidad de solicitudes realizadas en un breve periodo de tiempo
`queue_overflow`	La cola de procesamiento está llena. Envía menos solicitudes en un breve periodo de tiempo
`resource_exhausted`	Los recursos del servidor están al límite. Vuelve a intentarlo más tarde
`session_time_limit_exceeded`	Se ha alcanzado la duración máxima de la sesión. Inicia una sesión nueva o mejora tu suscripción
`chunk_size_exceeded`	El tamaño del fragmento de audio es demasiado grande. Reduce el tamaño del fragmento
`insufficient_audio_activity`	No has enviado suficiente actividad de audio para mantener la conexión