> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Transcripciones y estrategias de confirmación > **Note** > > **Guía práctica** · Da por hecho que has completado la guía de > [streaming del lado del cliente](/docs/es/eleven-api/guides/how-to/speech-to-text/realtime/client-side-streaming) o de > [streaming del lado del servidor](/docs/es/eleven-api/guides/how-to/speech-to-text/realtime/server-side-streaming). ## Descripción general Al transcribir audio, recibirás transcripciones parciales y confirmadas. * **Transcripciones parciales**: resultados provisionales de la transcripción. * **Transcripciones confirmadas**: resultados finales del segmento de transcripción que se envían al recibir un mensaje de "confirmación". Una sesión puede tener varias transcripciones confirmadas. La transcripción confirmada puede incluir opcionalmente marcas de tiempo a nivel de palabra. Solo se recibe cuando la opción "incluir marcas de tiempo" está configurada como `true`. ```python # Initialize the connection connection = await elevenlabs.speech_to_text.realtime.connect(RealtimeUrlOptions( model_id="scribe_v2_realtime", include_timestamps=True, # Include this to receive the RealtimeEvents.COMMITTED_TRANSCRIPT_WITH_TIMESTAMPS event with word-level timestamps )) ``` ```typescript // Initialize the connection const connection = await elevenlabs.speechToText.realtime.connect({ modelId: "scribe_v2_realtime", includeTimestamps: true, // Include this to receive the RealtimeEvents.COMMITTED_TRANSCRIPT_WITH_TIMESTAMPS event with word-level timestamps }); ``` **`React`** ```typescript title="React" const connection = useScribe({ modelId: "scribe_v2_realtime", // Configuring this callback will automatically set the `includeTimestamps` option to `true` onCommittedTranscriptWithTimestamps: (data) => { console.log("Committed with timestamps:", data.text); console.log("Timestamps:", data.words); }, }); ``` **`JavaScript`** ```typescript title="JavaScript" const connection = Scribe.connect({ modelId: "scribe_v2_realtime", includeTimestamps: true, // Include this to receive the RealtimeEvents.COMMITTED_TRANSCRIPT_WITH_TIMESTAMPS event with word-level timestamps }); ``` ## Estrategias de confirmación Al enviar fragmentos de audio a través de WebSocket, los segmentos de transcripción se pueden confirmar de dos formas: confirmación manual o detección de actividad de voz (VAD). ### Confirmación manual Con la estrategia de confirmación manual, tú controlas cuándo confirmar los segmentos de transcripción. Esta es la estrategia que se usa de forma predeterminada. Al confirmar un segmento, se borra la transcripción acumulada procesada y se inicia un nuevo segmento sin perder el contexto. Confirmar cada 20-30 segundos es una buena práctica para mejorar la latencia. Aunque no confirmes manualmente, el modelo confirma automáticamente tras aproximadamente 36 segundos de audio acumulado. Para obtener los mejores resultados, confirma durante periodos de silencio o en otro punto lógico, como un cambio de turno en la conversación. > **Info** > > El procesamiento de la transcripción comienza después de enviar los primeros 2 segundos de audio. ```python await connection.send({ "audio_base_64": audio_base_64, "sample_rate": 16000, }) # When ready to finalize the segment await connection.commit() ``` ```typescript connection.send({ audioBase64: audioBase64, sampleRate: 16000, }); // When ready to finalize the segment connection.commit(); ``` > **Warning** > > Confirmar manualmente varias veces en una secuencia corta puede empeorar el rendimiento del modelo. #### Enviar contexto de texto previo Al enviar audio para transcribir, puedes enviar contexto de texto previo junto con el primer fragmento de audio para ayudar al modelo a entender el contexto de la voz. Esto resulta útil en algunos casos: * Texto del agente para casos de uso de IA conversacional: permite al modelo entender más fácilmente el contexto de la conversación y generar mejores transcripciones. * Reconexión tras un error de red: permite al modelo seguir transcribiendo y usar el texto anterior como guía. * Información contextual general: una breve descripción de qué tratará la transcripción ayuda al modelo a entender el contexto. > **Warning** > > Enviar contexto `previous_text` solo es posible al enviar el primer fragmento de audio mediante > `connection.send()`. Enviarlo en fragmentos posteriores provocará un error. El texto previo funciona > mejor cuando tiene menos de *50* caracteres. ```python await connection.send({ "audio_base_64": audio_base_64, "previous_text": "The previous text context", }) ``` ```typescript connection.send({ audioBase64: audioBase64, previousText: "The previous text context", }); ``` ### Detección de actividad de voz (VAD) Con la estrategia VAD, el motor de transcripción detecta automáticamente los segmentos de voz y silencio. Cuando se alcanza un umbral de silencio, el motor de transcripción confirma automáticamente el segmento de transcripción. Al transcribir audio del micrófono en la [integración del lado del cliente](/docs/es/eleven-api/guides/how-to/speech-to-text/realtime/client-side-streaming), se recomienda usar la estrategia VAD. **`Cliente`** ```typescript title="Cliente" import { Scribe, AudioFormat, CommitStrategy } from "@elevenlabs/client"; const connection = Scribe.connect({ token: "sutkn_1234567890", modelId: "scribe_v2_realtime", audioFormat: AudioFormat.PCM_16000, commitStrategy: CommitStrategy.VAD, vadSilenceThresholdSecs: 1.5, vadThreshold: 0.4, minSpeechDurationMs: 100, minSilenceDurationMs: 100, }); ``` ```python from dotenv import load_dotenv from elevenlabs import AudioFormat, CommitStrategy, ElevenLabs, RealtimeAudioOptions load_dotenv() elevenlabs = ElevenLabs(api_key=os.getenv("ELEVENLABS_API_KEY")) connection = await elevenlabs.speech_to_text.realtime.connect( RealtimeAudioOptions( model_id="scribe_v2_realtime", audio_format=AudioFormat.PCM_16000, commit_strategy=CommitStrategy.VAD, vad_silence_threshold_secs=1.5, vad_threshold=0.4, min_speech_duration_ms=100, min_silence_duration_ms=100, ) ) ``` **`TypeScript`** ```typescript title="TypeScript" import { ElevenLabsClient, AudioFormat, CommitStrategy } from '@elevenlabs/elevenlabs-js'; const elevenlabs = new ElevenLabsClient(); const connection = await elevenlabs.speechToText.realtime.connect({ modelId: "scribe_v2_realtime", audioFormat: AudioFormat.PCM_16000, commitStrategy: CommitStrategy.VAD, vadSilenceThresholdSecs: 1.5, vadThreshold: 0.4, minSpeechDurationMs: 100, minSilenceDurationMs: 100, }); ``` ## Mantener la conexión activa durante el silencio Los SDK oficiales no interrumpen la conexión cuando no llegan mensajes, así que la mayoría de integraciones no lo necesitan. Si tu propio cliente de WebSocket, o un proxy o equilibrador de carga intermedio, cierra la conexión cuando no llegan tramas durante un tiempo, pasa el parámetro de consulta opcional `keepalive_interval_ms` al conectarte. Esto es importante durante periodos largos de silencio, por ejemplo, en una llamada telefónica con pausas de 10-15 segundos. Aproximadamente una vez por intervalo, el servidor envía una `partial_transcript` de mantenimiento: vacía (`text: ""`) si el segmento actual no tiene texto sin confirmar, o una repetición del último texto parcial si lo tiene. > **Warning** > > Los mensajes de mantenimiento no son un ping continuo: debes seguir transmitiendo audio (las tramas de silencio sirven). > Si dejas de enviar audio, no se enviarán mensajes de mantenimiento y el servidor cerrará la conexión después de 15 > segundos sin ningún mensaje del cliente. Este límite del servidor no se puede configurar. * Acepta un número entero entre `500` y `10000` (milisegundos). Está desactivado de forma predeterminada; omite el parámetro para mantener el comportamiento actual. * Los valores fuera de rango o no enteros hacen que el servidor envíe un error `invalid_request` y cierre la conexión. * Los mensajes de mantenimiento se activan porque el modelo procesa realmente el audio silencioso que envías, no mediante un temporizador continuo, por lo que también confirman que la ruta de transcripción está activa. * El audio se procesa en fragmentos de aproximadamente 1 segundo, así que los mensajes de mantenimiento llegan aproximadamente una vez por intervalo, ajustados a esa cadencia (por ejemplo, `1000` se activa aproximadamente una vez por segundo y `3000` aproximadamente cada 3 segundos). El primer mensaje de mantenimiento de una sesión llega unos 2 segundos después de iniciarla, ya que el servidor almacena en búfer los primeros \~2 segundos de audio antes de transcribir. Configura el intervalo como máximo en torno a un tercio de tu propio tiempo de espera de lectura para dejar margen. * El `text` de un mensaje de mantenimiento solo está vacío cuando el segmento actual todavía no tiene texto sin confirmar. Si se produce una pausa después de hablar pero antes de confirmar —más visible con `filter_background_audio=true` o en modo de confirmación manual sin confirmar—, el mensaje de mantenimiento repite el último texto parcial, por lo que nunca borra el texto provisional. Tras una confirmación, los mensajes de mantenimiento vuelven a estar vacíos hasta que llegue nueva voz. * Funciona tanto con `commit_strategy=manual` como con `commit_strategy=vad`, y con `filter_background_audio=true`. No afecta a la facturación más allá del audio que ya estás transmitiendo. * La `config` del mensaje `session_started` devuelve `keepalive_interval_ms` (`null` cuando está desactivado). > **Info** > > Una `partial_transcript` vacía (`text: ""`) significa "no hay voz en el segmento actual". Una > `partial_transcript` repetida e idéntica durante una pausa también es un mensaje de mantenimiento: los clientes deben mostrar > los parciales como ya lo hacen, sin tratar la repetición como un caso especial. Añade el parámetro a la URL de WebSocket: ```text wss://api.elevenlabs.io/v1/speech-to-text/realtime?model_id=scribe_v2_realtime&commit_strategy=vad&keepalive_interval_ms=1000 ``` ## Formatos de audio compatibles | Formato | Frecuencia de muestreo | Descripción | | --------- | ---------------------- | ------------------------------------------- | | pcm_8000 | 8 kHz | PCM de 16 bits, little-endian | | pcm_16000 | 16 kHz | PCM de 16 bits, little-endian (recomendado) | | pcm_22050 | 22,05 kHz | PCM de 16 bits, little-endian | | pcm_24000 | 24 kHz | PCM de 16 bits, little-endian | | pcm_44100 | 44,1 kHz | PCM de 16 bits, little-endian | | pcm_48000 | 48 kHz | PCM de 16 bits, little-endian | | ulaw_8000 | 8 kHz | Codificación μ-law de 8 bits | ## Buenas prácticas ### Calidad de audio * Para obtener los mejores resultados, usa una frecuencia de muestreo de 16 kHz para lograr un equilibrio óptimo entre calidad y ancho de banda. * Asegúrate de que la entrada de audio sea limpia y tenga el mínimo ruido de fondo. * Usa una ganancia de micrófono adecuada para evitar la saturación. * Por el momento, solo se admite audio mono. ### Tamaño de los fragmentos * Envía fragmentos de audio de entre 0,1 y 1 segundo para una transmisión fluida. * Los fragmentos más pequeños reducen la latencia, pero generan más sobrecarga. * Los fragmentos más grandes son más eficientes, pero pueden introducir latencia. ## Próximos pasos #### [Streaming del lado del servidor](/docs/es/eleven-api/guides/how-to/speech-to-text/realtime/server-side-streaming) Configura la transcripción de audio del lado del servidor con la API de WebSocket. #### [Referencia de eventos](/docs/es/eleven-api/guides/how-to/speech-to-text/realtime/event-reference) Lista completa de eventos y tipos de error de la API de STT en tiempo real.