Sintetiza la voz con transmisión bidireccional

En este documento, se explica el proceso de sintetizar audio con la transmisión bidireccional.

La transmisión bidireccional te permite enviar entradas de texto y recibir datos de audio de forma simultánea. Esto significa que puedes empezar a sintetizar la voz antes de que se envíe el texto de entrada completo, lo que reduce la latencia y habilita interacciones en tiempo real. Los asistentes por voz y los juegos interactivos usan la transmisión bidireccional para crear aplicaciones más dinámicas y responsivas.

Para obtener más información sobre los conceptos básicos de Text-to-Speech, consulta los conceptos básicos de Text-to-Speech.

Antes de comenzar

Antes de enviar una solicitud a la API de Text-to-Speech, debes haber realizado las siguientes acciones. Consulta la página Antes de comenzar para obtener más detalles.

  • Habilita Text-to-Speech en un proyecto de Google Cloud .
    1. Asegúrate de que la facturación esté habilitada para Text-to-Speech.

  • Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando: 

    gcloud init

    Si usas un proveedor de identidad (IdP) externo, primero debes Acceder a gcloud CLI con tu identidad federada.

Sintetiza la voz con transmisión bidireccional

Instala la biblioteca cliente

Python

Antes de instalar la biblioteca, asegúrate de haber preparado tu entorno para el desarrollo en Python.

pip install --upgrade google-cloud-texttospeech

Envía una transmisión de texto y recibe una transmisión de audio

La API acepta una transmisión de solicitudes con el tipo StreamingSynthesizeRequest, que contiene StreamingSynthesisInput o StreamingSynthesizeConfig.

Antes de enviar una transmisión StreamingSynthesizeRequest con StreamingSynthesisInput, que proporciona una entrada de texto, envía exactamente un StreamingSynthesizeRequest con un StreamingSynthesizeConfig.

Transmitir Text-to-Speech solo es compatible con Chirp 3: Voces en HD.

Python

Antes de ejecutar el ejemplo, asegúrate de haber preparado tu entorno para el desarrollo en Python.

#!/usr/bin/env python
# Copyright 2024 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#

"""Google Cloud Text-To-Speech API streaming sample application .

Example usage:
    python streaming_tts_quickstart.py
"""


def run_streaming_tts_quickstart():
    """Synthesizes speech from a stream of input text."""
    from google.cloud import texttospeech

    client = texttospeech.TextToSpeechClient()

    # See https://cloud.google.com/text-to-speech/docs/voices for all voices.
    streaming_config = texttospeech.StreamingSynthesizeConfig(
        voice=texttospeech.VoiceSelectionParams(
            name="en-US-Chirp3-HD-Charon",
            language_code="en-US",
        )
    )

    # Set the config for your stream. The first request must contain your config, and then each subsequent request must contain text.
    config_request = texttospeech.StreamingSynthesizeRequest(
        streaming_config=streaming_config
    )

    text_iterator = [
        "Hello there. ",
        "How are you ",
        "today? It's ",
        "such nice weather outside.",
    ]

    # Request generator. Consider using Gemini or another LLM with output streaming as a generator.
    def request_generator():
        yield config_request
        for text in text_iterator:
            yield texttospeech.StreamingSynthesizeRequest(
                input=texttospeech.StreamingSynthesisInput(text=text)
            )

    streaming_responses = client.streaming_synthesize(request_generator())

    for response in streaming_responses:
        print(f"Audio content size in bytes is: {len(response.audio_content)}")


if __name__ == "__main__":
    run_streaming_tts_quickstart()

Limpia

Si quieres evitar cargos innecesarios de Google Cloud, usa Google Cloud console para borrar el proyecto si no lo necesitas.

¿Qué sigue?