Antes de começar

O Text-to-Speech é uma API desenvolvida com a tecnologia de inteligência artificial (IA) do Google. Envie os dados da transcrição para o Text-to-Speech em uma chamada de API e, em seguida, receba fala humana sintética e com som natural como áudio para reprodução. Para mais informações sobre como o Text-to-Speech funciona, consulte a página Noções básicas.

Fornecemos amostras de código que mostram como fazer uma solicitação para a API e receber uma resposta. Saiba como usar essas amostras seguindo os guias de início rápido e os guias de instruções do Text-to-Speech.

Neste guia, você verá as etapas necessárias para começar a enviar solicitações para a API Text-to-Speech.

Visão geral

Antes de começar a usar o Text-to-Speech, você precisa ativar a API no Console do Google Cloud Platform. As etapas abaixo mostram como executar as ações a seguir:

  • Ativar o Text-to-Speech em um projeto.
    1. Verificar se o faturamento está ativado para o Text-to-Speech.
    2. Verificar se o projeto tem pelo menos uma conta de serviço.
    3. Fazer o download de uma chave de credencial da conta de serviço.
  • Definir sua variável de ambiente de autenticação.

Como configurar seu projeto do Google Cloud Platform

  1. Fazer login no Console do Cloud

  2. Acessar a página do seletor de projetos

    É possível escolher um projeto existente ou criar um novo. Para mais detalhes sobre a criação de um projeto, consulte a documentação do Google Cloud Platform.

  3. Se você criar um novo projeto, será solicitado que vincule uma conta de faturamento a esse projeto. Se você estiver usando um projeto atual, verifique se o faturamento está ativado.

    Saiba como confirmar se o faturamento está ativado para o projeto

  4. Depois de selecionar um projeto e vinculá-lo a uma conta de faturamento, é possível ativar a API Text-to-Speech. Acesse a barra Pesquisar produtos e recursos na parte superior da página e digite "speech". Selecione a API Cloud Text-to-Speech na lista de resultados.

  5. Para testar o Text-to-Speech sem vinculá-lo ao projeto, escolha a opção TESTAR ESTA API. Para ativar a API Text-to-Speech para uso com o projeto, clique em ATIVAR.

  6. Agora você precisa vincular uma ou mais contas de serviço à API Text-to-Speech. Clique no link Credenciais no lado esquerdo da página da API Text-to-Speech:

    Se você não tiver contas de serviço associadas a este projeto, crie uma seguindo as instruções na seção Como criar uma nova conta de serviço.

    Se você tiver contas de serviço criadas anteriormente associadas a este projeto, elas aparecerão nesta página. Verifique se você tem acesso a uma chave JSON transferida por download associada à conta de serviço que você quer usar para fazer a autenticação com o Text-to-Speech. As chaves de contas de serviço só podem ser baixadas uma vez, no momento em que são criadas. Se a conta de serviço tiver uma chave, mas não for possível localizar o arquivo .json baixado, você precisará criar uma nova chave para essa conta de serviço e fazer o download do arquivo .json. Para instruções sobre como criar uma nova chave em uma conta de serviço existente, siga as instruções na seção Como criar uma chave JSON.

    Se você já tiver uma conta de serviço e a chave JSON dela, poderá definir a variável de ambiente de autenticação.

Como criar uma nova conta de serviço

  1. Crie uma nova conta de serviço se o projeto ainda não tiver uma. É preciso criar uma conta de serviço para usar o Text-to-Speech.

    Acesse "Criar conta de serviço"

    Na caixa Nome da conta de serviço, digite um nome exclusivo para a nova conta de serviço. Sua entrada é preenchida automaticamente na caixa ID da conta de serviço. A caixa Descrição da conta de serviço é opcional, mas recomendada se você planeja associar várias contas de serviço ao projeto. Digite uma breve descrição da conta de serviço nessa caixa e clique em CRIAR E CONTINUAR.

  2. Recomendamos que você atribua um dos papéis básicos do IAM à conta de serviço. Também é possível atribuir vários papéis a uma única conta de serviço, se necessário. Consulte Papéis do IAM para ver detalhes sobre os papéis disponíveis e as permissões permitidas para cada um. Clique no menu suspenso Selecionar um papel e role até Básico. É possível escolher um papel para essa conta de serviço entre as opções exibidas na coluna à direita. Clique em CONTINUAR.

  3. Na etapa final, é possível permitir que outras entidades (indivíduos, grupos do Google etc.) acessem sua conta de serviço. Se você não precisar conceder acesso adicional, clique em CONCLUÍDO sem inserir informações.

  4. A conta de serviço agora aparece na página Contas de serviço. É possível alterar as permissões da conta de serviço, adicionar ou gerar novas chaves e conceder acesso a qualquer momento.

Como criar uma chave JSON para a conta de serviço

  1. A conta de serviço recém-criada aparece na página de contas de serviço. Crie uma chave privada que será associada a essa conta. Você precisa usar essa chave privada durante o processo de autenticação ao enviar uma solicitação para o Text-to-Speech. Se você optar por não criar uma chave agora, poderá gerar uma chave e/ou alterar informações individuais do usuário a qualquer momento acessando a conta de serviço na opção IAM e administrador -> Contas de serviço no menu de navegação principal.

    Para criar uma chave, clique na conta de serviço e selecione CHAVES. Clique em ADICIONAR CHAVE -> Criar nova chave. Recomendamos que você crie uma chave no formato JSON.

  2. Uma nova chave no formato de sua escolha será baixada automaticamente. Armazene esse arquivo em um local seguro e anote o caminho do arquivo. Você precisará apontar a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para esse arquivo ao passar pelo processo de autenticação no início de cada nova sessão do Text-to-Speech. Essa é uma etapa essencial para autenticar solicitações para o Text-to-Speech. O ID exclusivo da chave é exibido ao lado do nome da conta de serviço.

Definir sua variável de ambiente de autenticação

Para definir o GOOGLE_APPLICATION_CREDENTIALS, você precisa ter uma conta de serviço associada ao projeto e ter acesso à chave JSON da conta de serviço.

Forneça credenciais de autenticação ao código do aplicativo definindo a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS. Essa variável se aplica somente à sessão de shell atual. Se você quiser que a variável seja aplicada em sessões de shell futuras, defina a variável no arquivo de inicialização de shell, por exemplo, no arquivo ~/.bashrc ou ~/.profile.

Linux ou macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Substitua KEY_PATH pelo caminho do arquivo JSON que contém a chave da conta de serviço.

Exemplo:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Windows

Para PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Substitua KEY_PATH pelo caminho do arquivo JSON que contém a chave da conta de serviço.

Exemplo:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

Para prompt de comando:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

Substitua KEY_PATH pelo caminho do arquivo JSON que contém a chave da conta de serviço.

Para mais informações, consulte a documentação de autenticação do Google Cloud Platform.

Como desativar a API Text-to-Speech

Para desativar a API Text-to-Speech, navegue até o painel do Google Cloud Platform e clique no link Ir para a visão geral das APIs na caixa APIs. Clique na API Text-to-Speech e selecione o botão DESATIVAR API na parte superior da página.

A seguir

Saiba como enviar uma solicitação de transcrição à API Text-to-Speech usando as bibliotecas de cliente ou a linha de comando.