GUIA

Texto para fala no Google Sheets: cada linha em um MP3

Uma planilha é o lugar natural para muitos textos curtos: nomes de produtos, vocabulário, avisos, falas para um jogo ou um curso. O Google Sheets não lê esses textos em voz alta sozinho, mas o Apps Script, a linguagem de scripts embutida em toda planilha do Google, pode chamar uma API de texto para fala e salvar o áudio no Google Drive.

Este guia mostra como fazer isso com a API de voz da SuperClonica: um script curto converte a linha selecionada, salva um MP3 e escreve o link ao lado do texto.

Obter uma chave de API grátis Escolher uma voz Ou converter a planilha offline

O que você precisa

Uma conta Google e uma chave de API da SuperClonica. Entre na SuperClonica com Google ou GitHub e crie a chave na seção de API do seu espaço de trabalho; o plano gratuito dá um minuto de áudio por dia, o bastante para testar algumas linhas.

  • A coluna A tem os textos; na coluna B o script escreve os links dos áudios.
  • Na planilha, abra Extensões → Apps Script.
  • Em Configurações do projeto → Propriedades do script, adicione SUPERCLONICA_KEY com a sua chave, para que ela nunca fique no código.

O script

Cole esta função no editor do Apps Script e salve. Ela lê o texto da linha selecionada, envia para a API, salva o MP3 no seu Drive e coloca o link do arquivo na coluna B:

function voiceRow() { const sheet = SpreadsheetApp.getActiveSheet(); const row = sheet.getActiveCell().getRow(); const text = sheet.getRange(row, 1).getValue(); const key = PropertiesService.getScriptProperties().getProperty("SUPERCLONICA_KEY"); const answer = UrlFetchApp.fetch("https://superclonica.com/api/v1/speech", { method: "post", contentType: "application/json", headers: { Authorization: "Bearer " + key, "Idempotency-Key": "row-" + row }, payload: JSON.stringify({ text: text, voice: "F1", language: "pt", format: "mp3" }), muteHttpExceptions: true }); if (answer.getResponseCode() !== 200) throw new Error(answer.getContentText()); const file = DriveApp.createFile(answer.getBlob().setName("row-" + row + ".mp3")); sheet.getRange(row, 2).setValue(file.getUrl()); }

Execute uma vez pelo editor para autorizar o acesso à planilha, ao Drive e a solicitações externas; depois selecione uma linha e execute voiceRow. O Idempotency-Key faz uma execução repetida para a mesma linha esperar o mesmo áudio em vez de gerá-lo duas vezes.

Muitas linhas de uma vez

Para converter uma coluna inteira, percorra as linhas num laço e pule as que já têm link. Uma execução do Apps Script tem limite de tempo, então converta algumas dezenas de linhas por execução e rode de novo para o resto. Se a API responder 429, a janela de 10 minutos do seu plano acabou: o cabeçalho Retry-After diz em quantos segundos continuar. Escolha a voz no catálogo da SuperClonica: num plano pago, qualquer voz do catálogo funciona pelo ID, mostrado na página da voz em «Pela API».

Custo e privacidade

O plano gratuito dá um minuto de áudio por dia; o plano Inicial de US$ 5 dá 3 minutos a cada 10 minutos, até 216 horas por mês usado sem pausas. Pela API o texto vai para os servidores da SuperClonica e o áudio para o seu Google Drive. Para textos que precisam ficar no seu computador, rode o motor gratuito da SuperClonica localmente.