Referencia de eventos en tiempo real | ElevenLabs Documentation

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

Consulta la referencia de la API 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	Continuamente durante la transmisión de audio

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 establecer la conexión WebSocket
`partial_transcript`	Actualización en directo de la transcripción del segmento en curso. Las parciales posteriores sustituyen a las anteriores	Durante el procesamiento de audio, antes de realizar una confirmación
`committed_transcript`	Transcripción consolidada de un segmento. Es el texto final y estable del segmento y no cambiará	Tras una confirmación (manual o activada por VAD)
`committed_transcript_with_timestamps`	Transcripción confirmada con marcas de tiempo por palabra y el `language_code` detectado	Se envía después de la transcripción confirmada. Solo se recibe cuando se incluyen `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

Si se produce un error, se devolverá un mensaje de error antes de cerrar 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 que se realizaron demasiadas solicitudes de confirmación en un periodo breve
`unaccepted_terms`	No has aceptado los términos de 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 frecuencia. Reduce la cantidad de solicitudes realizadas en un periodo breve
`queue_overflow`	La cola de procesamiento está llena. Envía menos solicitudes en un periodo breve
`resource_exhausted`	Los recursos del servidor están al límite. Inténtalo de nuevo más tarde
`session_time_limit_exceeded`	Se ha alcanzado el tiempo máximo de 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