Criar áudios com base em textos usando bibliotecas de cliente

Este guia de início rápido mostra como usar bibliotecas de cliente para fazer solicitações à Text-to-Speech, criando áudios com base em textos.

Para saber mais sobre os conceitos básicos da Text-to-Speech, confira Princípios básicos da Text-to-Speech. Para saber quais vozes sintéticas estão disponíveis no seu idioma, consulte a página de vozes e idiomas disponíveis.

Antes de começar

Antes de enviar uma solicitação à API Text-to-Speech, é preciso realizar as ações a seguir. Consulte a página Antes de começar para saber mais.

  • Ativar a Text-to-Speech em um projeto do Google Cloud .
  • Verificar se o faturamento está ativado para a Text-to-Speech.

  • Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando: 

    gcloud init

    Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

  • If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Instalar a biblioteca de cliente

Go

go get cloud.google.com/go/texttospeech/apiv1

Java

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

<dependencyManagement>   <dependencies>     <dependency>       <groupId>com.google.cloud</groupId>       <artifactId>libraries-bom</artifactId>       <version>26.70.0</version>       <type>pom</type>       <scope>import</scope>     </dependency>   </dependencies> </dependencyManagement>  <dependencies>   <dependency>     <groupId>com.google.cloud</groupId>     <artifactId>google-cloud-texttospeech</artifactId>   </dependency> </dependencies>

If you are using Gradle, add the following to your dependencies:

implementation 'com.google.cloud:google-cloud-texttospeech:2.78.0'

If you are using sbt, add the following to your dependencies:

libraryDependencies += "com.google.cloud" % "google-cloud-texttospeech" % "2.78.0"

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Node.js

Antes de instalar a biblioteca, verifique se você preparou o ambiente para o desenvolvimento em Node.js..

npm install @google-cloud/text-to-speech

Python

Antes de instalar a biblioteca, verifique se você preparou o ambiente para o desenvolvimento em Python.

pip install --upgrade google-cloud-texttospeech

Outras linguagens

C#: siga as instruções de configuração de C# na página das bibliotecas de cliente e, em seguida, acesse a documentação de referência da Text-to-Speech para .NET.

PHP: siga as instruções de configuração de PHP na página das bibliotecas de cliente e, em seguida, acesse a documentação de referência da Text-to-Speech para PHP.

Ruby: siga as instruções de configuração de Ruby na página das bibliotecas de cliente e, em seguida, acesse a documentação de referência da Text-to-Speech para Ruby.

Criar dados de áudio

Agora é possível usar a Text-to-Speech para criar arquivos de áudio de fala humana sintética. Use o código a seguir para enviar uma solicitação synthesize à API Text-to-Speech.

Go

 // Command quickstart generates an audio file with the content "Hello, World!". package main  import ( 	"context" 	"fmt" 	"log" 	"os"  	texttospeech "cloud.google.com/go/texttospeech/apiv1" 	"cloud.google.com/go/texttospeech/apiv1/texttospeechpb" )  func main() { 	// Instantiates a client. 	ctx := context.Background()  	client, err := texttospeech.NewClient(ctx) 	if err != nil { 		log.Fatal(err) 	} 	defer client.Close()  	// Perform the text-to-speech request on the text input with the selected 	// voice parameters and audio file type. 	req := texttospeechpb.SynthesizeSpeechRequest{ 		// Set the text input to be synthesized. 		Input: &texttospeechpb.SynthesisInput{ 			InputSource: &texttospeechpb.SynthesisInput_Text{Text: "Hello, World!"}, 		}, 		// Build the voice request, select the language code ("en-US") and the SSML 		// voice gender ("neutral"). 		Voice: &texttospeechpb.VoiceSelectionParams{ 			LanguageCode: "en-US", 			SsmlGender:   texttospeechpb.SsmlVoiceGender_NEUTRAL, 		}, 		// Select the type of audio file you want returned. 		AudioConfig: &texttospeechpb.AudioConfig{ 			AudioEncoding: texttospeechpb.AudioEncoding_MP3, 		}, 	}  	resp, err := client.SynthesizeSpeech(ctx, &req) 	if err != nil { 		log.Fatal(err) 	}  	// The resp's AudioContent is binary. 	filename := "output.mp3" 	err = os.WriteFile(filename, resp.AudioContent, 0644) 	if err != nil { 		log.Fatal(err) 	} 	fmt.Printf("Audio content written to file: %v\n", filename) }

Java

// Imports the Google Cloud client library import com.google.cloud.texttospeech.v1.AudioConfig; import com.google.cloud.texttospeech.v1.AudioEncoding; import com.google.cloud.texttospeech.v1.SsmlVoiceGender; import com.google.cloud.texttospeech.v1.SynthesisInput; import com.google.cloud.texttospeech.v1.SynthesizeSpeechResponse; import com.google.cloud.texttospeech.v1.TextToSpeechClient; import com.google.cloud.texttospeech.v1.VoiceSelectionParams; import com.google.protobuf.ByteString; import java.io.FileOutputStream; import java.io.OutputStream;  /**  * Google Cloud TextToSpeech API sample application. Example usage: mvn package exec:java  * -Dexec.mainClass='com.example.texttospeech.QuickstartSample'  */ public class QuickstartSample {    /** Demonstrates using the Text-to-Speech API. */   public static void main(String... args) throws Exception {     // Instantiates a client     try (TextToSpeechClient textToSpeechClient = TextToSpeechClient.create()) {       // Set the text input to be synthesized       SynthesisInput input = SynthesisInput.newBuilder().setText("Hello, World!").build();        // Build the voice request, select the language code ("en-US") and the ssml voice gender       // ("neutral")       VoiceSelectionParams voice =           VoiceSelectionParams.newBuilder()               .setLanguageCode("en-US")               .setSsmlGender(SsmlVoiceGender.NEUTRAL)               .build();        // Select the type of audio file you want returned       AudioConfig audioConfig =           AudioConfig.newBuilder().setAudioEncoding(AudioEncoding.MP3).build();        // Perform the text-to-speech request on the text input with the selected voice parameters and       // audio file type       SynthesizeSpeechResponse response =           textToSpeechClient.synthesizeSpeech(input, voice, audioConfig);        // Get the audio contents from the response       ByteString audioContents = response.getAudioContent();        // Write the response to the output file.       try (OutputStream out = new FileOutputStream("output.mp3")) {         out.write(audioContents.toByteArray());         System.out.println("Audio content written to file \"output.mp3\"");       }     }   } }

Node.js

Antes de executar o exemplo, verifique se você preparou o ambiente para o desenvolvimento em Node.js.

// Imports the Google Cloud client library const textToSpeech = require('@google-cloud/text-to-speech');  // Import other required libraries const {writeFile} = require('node:fs/promises');  // Creates a client const client = new textToSpeech.TextToSpeechClient();  async function quickStart() {   // The text to synthesize   const text = 'hello, world!';    // Construct the request   const request = {     input: {text: text},     // Select the language and SSML voice gender (optional)     voice: {languageCode: 'en-US', ssmlGender: 'NEUTRAL'},     // select the type of audio encoding     audioConfig: {audioEncoding: 'MP3'},   };    // Performs the text-to-speech request   const [response] = await client.synthesizeSpeech(request);    // Save the generated binary audio content to a local file   await writeFile('output.mp3', response.audioContent, 'binary');   console.log('Audio content written to file: output.mp3'); }  await quickStart();

Python

Antes de executar o exemplo, verifique se você preparou o ambiente para o desenvolvimento em Python.

"""Synthesizes speech from the input string of text or ssml. Make sure to be working in a virtual environment.  Note: ssml must be well-formed according to:     https://www.w3.org/TR/speech-synthesis/ """ from google.cloud import texttospeech  # Instantiates a client client = texttospeech.TextToSpeechClient()  # Set the text input to be synthesized synthesis_input = texttospeech.SynthesisInput(text="Hello, World!")  # Build the voice request, select the language code ("en-US") and the ssml # voice gender ("neutral") voice = texttospeech.VoiceSelectionParams(     language_code="en-US", ssml_gender=texttospeech.SsmlVoiceGender.NEUTRAL )  # Select the type of audio file you want returned audio_config = texttospeech.AudioConfig(     audio_encoding=texttospeech.AudioEncoding.MP3 )  # Perform the text-to-speech request on the text input with the selected # voice parameters and audio file type response = client.synthesize_speech(     input=synthesis_input, voice=voice, audio_config=audio_config )  # The response's audio_content is binary. with open("output.mp3", "wb") as out:     # Write the response to the output file.     out.write(response.audio_content)     print('Audio content written to file "output.mp3"')

Parabéns! Você enviou sua primeira solicitação para o Text-to-Speech.

Como foi?

Limpeza

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

A seguir