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 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 su transcripción	Continuamente mientras transmites 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. Las parciales posteriores sustituyen a las anteriores. También se envía como señal de mantenimiento: `text` estará vacío si el segmento no tiene texto sin confirmar, o repetirá la última parcial si lo tiene	Durante el procesamiento de audio, antes de realizar una confirmación. También se envía como señal de mantenimiento aproximadamente una vez por `keepalive_interval_ms` cuando se configura
`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 por 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
`redacted_transcript`	Segmento de transcripción confirmada con las entidades ocultadas sustituidas por marcadores, junto con el texto original confirmado	Se envía poco después de cada transcripción confirmada. Solo se recibe cuando se incluye `entity_redaction` en los parámetros de consulta
`edited_transcript`	Versión editada del segmento de transcripción confirmada, junto con el texto original confirmado	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 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 en la referencia de la API
`error`	Un error genérico del servidor. También se envía cuando falla la ocultación de entidades, antes de cerrar la conexión
`commit_throttled`	La confirmación se limitó debido a demasiadas solicitudes de confirmación realizadas 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`	Se ha limitado tu tasa de solicitudes. 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 nueva sesión 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