📢 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).

!@sefinek/google-tts-api.png
!@sefinek/google-tts-api.png
!@sefinek/google-tts-api.png

📥 Installation

``bash
$ 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 | |
| getAllAudioUrls | lang, slow, host, splitPunct | { shortText: string; url: string; }[] | ✅ |
| getAllAudioBase64 | lang, slow, host, timeout, splitPunct | Promise<{ shortText: string; base64: string; }[]> | ✅ |

$3

| 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

$3

`js
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?...
`

$3

`js
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

`js
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: '...' },
// ...
// ];
`

$3

`js
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