@sefinek/google-tts-api

📢 Google TTS API

Google TTS (Text-To-Speech) for Node.js. For free without any API keys!

This is a fork of zlargon/google-tts with updated dependencies (the old versions had vulnerabilities).

📥 Installation

$ npm install --save google-tts-api
$ npm install -D typescript @types/node # Only for TypeScript

🤔 Usage

Method	Options (all optional)	Return Type	Handle Long Text
getAudioUrl	lang, slow, host	string
getAudioBase64	lang, slow, host, timeout	Promise<string>
getAllAudioUrls	lang, slow, host, splitPunct	{ shortText: string; url: string; }[]	✅
getAllAudioBase64	lang, slow, host, timeout, splitPunct	Promise<{ shortText: string; base64: string; }[]>	✅

Options (all optional)

Option	Type	Default	Description
lang	string	en	See all available language code at https://cloud.google.com/speech/docs/languages
slow	boolean	false	Use the slow audio speed if set slow to true
host	string	https://translate.google.com	You can change the host if the default host could not work in your region (e.g. https://translate.google.com.cn).
timeout	number	10000 (ms)	(Only for getAudioBase64 and getAllAudioBase64) Set timeout for the HTTP request.
splitPunct	string		(Only for getAllAudioUrls and getAllAudioBase64) Set the punctuation to split the long text to short text. (e.g. "，、。")

💻 Examples

1. getAudioUrl(text, [option])

import * as googleTTS from '@sefinek/google-tts-api'; // ES6 or TypeScript
const googleTTS = require('@sefinek/google-tts-api'); // CommonJS

// Get audio URL
const url = googleTTS.getAudioUrl('Hello world!', {
  lang: 'en',
  slow: false,
  host: 'https://translate.google.com',
});
console.log(url); // https://translate.google.com/translate_tts?...

2. getAudioBase64(text, [option])

import * as googleTTS from '@sefinek/google-tts-api'; // ES6 or TypeScript
const googleTTS = require('@sefinek/google-tts-api'); // CommonJS

// Get base64 text
googleTTS
  .getAudioBase64('Hello world!', {
    lang: 'en',
    slow: false,
    host: 'https://translate.google.com',
    timeout: 10000,
  })
  .then(console.log) // base64 text
  .catch(console.error);

3. getAllAudioUrls(text, [option]) (For text longer than 200 characters)

import * as googleTTS from '@sefinek/google-tts-api'; // ES6 or TypeScript
const googleTTS = require('@sefinek/google-tts-api'); // CommonJS

const results = googleTTS.getAllAudioUrls('LONG_TEXT_...', {
  lang: 'en',
  slow: false,
  host: 'https://translate.google.com',
  splitPunct: ',.?',
});
console.log(results);
// [
//   { shortText: '...', url: '...' },
//   { shortText: '...', url: '...' },
//   ...
// ];

4. getAllAudioBase64(text, [option]) (For text longer than 200 characters)

import * as googleTTS from '@sefinek/google-tts-api'; // ES6 or TypeScript
const googleTTS = require('@sefinek/google-tts-api'); // CommonJS

googleTTS
  .getAllAudioBase64('LONG_TEXT_...', {
    lang: 'en',
    slow: false,
    host: 'https://translate.google.com',
    timeout: 10000,
    splitPunct: ',.?',
  })
  .then(console.log)
  // [
  //   { shortText: '...', base64: '...' },
  //   { shortText: '...', base64: '...' },
  //   ...
  // ];
  .catch(console.error);

More examples

📑 License

MIT