tiktok-tts

This package provides a simple way to generate text-to-speech audio files from TikTok's text-to-speech (TTS) API in Node.js.

Installation

npm i tiktok-tts

Usage

Basic example

const { config, createAudioFromText } = require('tiktok-tts')

config('Your TikTok sessionid here');
createAudioFromText('Text to be spoken goes here');

Custom filename example

const { config, createAudioFromText } = require('tiktok-tts')

config('Your TikTok sessionid here');
createAudioFromText('Text to be spoken goes here', 'myAudio');

Generated audio file will be saved as myAudio.mp3

Custom path example

const { config, createAudioFromText } = require('tiktok-tts')

config('Your TikTok sessionid here');
createAudioFromText('Text to be spoken goes here', './myDirectory/myAudio');

Generated audio file will be saved as myAudio.mp3 inside the myDirectory directory.

⚠️ Please keep in mind that myDirectory needs to be an existing directory.

Custom voice example

const { config, createAudioFromText } = require('tiktok-tts')

config('Your TikTok sessionid here');
createAudioFromText('Text to be spoken goes here', 'myAudio', 'en_us_stormtrooper');

Using await with the createAudioFromText() function

const { config, createAudioFromText } = require('tiktok-tts')

config('Your TikTok sessionid here');

async function yourFunction(){
    await createAudioFromText('Text that will be spoken');
    console.log("Audio file generated!");
}

yourFunction();

Get TikTok Session id 🍪

• Install Cookie Editor extension for your browser.
• Log in to TikTok Web
• While on TikTok web, open the extension and look for sessionid
• Copy the sessionid value. (It should be an alphanumeric value)

Available functions

config(tiktokSessionId, customBaseUrl)

Parameter	Description	Default	type
tiktokSessionId	Your TikTok sessionid	null	String
customBaseUrl	Custom TikTok API url optional	-	String

• By default https://api16-normal-c-useast1a.tiktokv.com/media/api/text/speech/invoke will be used if no customBaseUrl is specified.

List of known URLs (You can try these if the default url is not working on your region)

• https://api16-normal-c-useast1a.tiktokv.com/media/api/text/speech/invoke

• https://api16-core-c-useast1a.tiktokv.com/media/api/text/speech/invoke

• https://api16-normal-useast5.us.tiktokv.com/media/api/text/speech/invoke

• https://api16-core.tiktokv.com/media/api/text/speech/invoke

• https://api16-core-useast5.us.tiktokv.com/media/api/text/speech/invoke

• https://api19-core-c-useast1a.tiktokv.com/media/api/text/speech/invoke

• https://api-core.tiktokv.com/media/api/text/speech/invoke

• https://api-normal.tiktokv.com/media/api/text/speech/invoke

• https://api19-normal-c-useast1a.tiktokv.com/media/api/text/speech/invoke

• https://api16-core-c-alisg.tiktokv.com/media/api/text/speech/invoke

• https://api16-normal-c-alisg.tiktokv.com/media/api/text/speech/invoke

• https://api22-core-c-alisg.tiktokv.com/media/api/text/speech/invoke

• https://api16-normal-c-useast2a.tiktokv.com/media/api/text/speech/invoke

createAudioFromText(text, fileName, speaker)

Parameter	Description	Default	type
text	Text to be converted to audio	null	String
fileName	filename/path for the generated audio file optional	audio	String
speaker	TikTok speaker code optional	en_us_001	String

Speaker Codes

The following speaker codes are supported:

Language	Speaker	Speaker Code
English	Game On	en_male_jomboy
	Jessie	en_us_002
	Warm	es_mx_002
	Wacky	en_male_funny
	Scream	en_us_ghostface
	Empathetic	en_female_samc
	Serious	en_male_cody
	Beauty Guru	en_female_makeup
	Bestie	en_female_richgirl
	Trickster	en_male_grinch
	Joey	en_us_006
	Story Teller	en_male_narration
	Mr. GoodGuy	en_male_deadpool
	Narrator	en_uk_001
	Male English UK	en_uk_003
	Metro	en_au_001
	Alfred	en_male_jarvis
	ashmagic	en_male_ashmagic
	olantekkers	en_male_olantekkers
	Lord Cringe	en_male_ukneighbor
	Mr. Meticulous	en_male_ukbutler
	Debutante	en_female_shenna
	Varsity	en_female_pansino
	Marty	en_male_trevor
	Pop Lullaby	en_female_f08_twinkle
	Classic Electric	en_male_m03_classical
	Bae	en_female_betty
	Cupid	en_male_cupid
	Granny	en_female_grandma
	Cozy	en_male_m2_xhxs_m03_christmas
	Author	en_male_santa_narration
	Caroler	en_male_sing_deep_jingle
	Santa	en_male_santa_effect
	NYE 2023	en_female_ht_f08_newyear
	Magician	en_male_wizard
	Opera	en_female_ht_f08_halloween
	Euphoric	en_female_ht_f08_glorious
	Hypetrain	en_male_sing_funny_it_goes_up
	Melodrama	en_female_ht_f08_wonderful_world
	Quirky Time	en_male_m2_xhxs_m03_silly
	Peaceful	en_female_emotional
	Toon Beat	en_male_m03_sunshine_soon
	Open Mic	en_female_f08_warmy_breeze
	Jingle	en_male_m03_lobby
	Thanksgiving	en_male_sing_funny_thanksgiving
	Cottagecore	en_female_f08_salut_damour
	Professor	en_us_007
	Scientist	en_us_009
	Confidence	en_us_010
	Smooth	en_au_002
Disney	Ghost Face	en_us_ghostface
	Chewbacca	en_us_chewbacca
	C3PO	en_us_c3po
	Stitch	en_us_stitch
	Stormtrooper	en_us_stormtrooper
	Rocket	en_us_rocket
	Madame Leota	en_female_madam_leota
	Ghost Host	en_male_ghosthost
	Pirate	en_male_pirate
French	French - Male 1	fr_001
	French - Male 2	fr_002
Spanish	Spanish (Spain) - Male	es_002
	Spanish MX - Male	es_mx_002
Portuguese	Portuguese BR - Female 1	br_001
	Portuguese BR - Female 2	br_003
	Portuguese BR - Female 3	br_004
	Portuguese BR - Male	br_005
	Ivete Sangalo	bp_female_ivete
	Ludmilla	bp_female_ludmilla
	Lhays Macedo	pt_female_lhays
	Laizza	pt_female_laizza
	Galvão Bueno	pt_male_bueno
German	German - Female	de_001
	German - Male	de_002
Indonesian	Indonesian - Female	id_001
Japanese	Japanese - Female 1	jp_001
	Japanese - Female 2	jp_003
	Japanese - Female 3	jp_005
	Japanese - Male	jp_006
	りーさ	jp_female_fujicochan
	世羅鈴	jp_female_hasegawariona
	Morio’s Kitchen	jp_male_keiichinakano
	夏絵ココ	jp_female_oomaeaika
	低音ボイス	jp_male_yujinchigusa
	四郎	jp_female_shirou
	玉川寿紀	jp_male_tamawakazuki
	庄司果織	jp_female_kaorishoji
	八木沙季	jp_female_yagishaki
	ヒカキン	jp_male_hikakin
	丸山礼	jp_female_rei
	修一朗	jp_male_shuichiro
	マツダ家の日常	jp_male_matsudake
	まちこりーた	jp_female_machikoriiita
	モジャオ	jp_male_matsuo
	モリスケ	jp_male_osada
Korean	Korean - Male 1	kr_002
	Korean - Female	kr_003
	Korean - Male 2	kr_004
Vietnamese	Female	BV074_streaming
	Male	BV075_streaming
Other	Alto	en_female_f08_salut_damour
	Tenor	en_male_m03_lobby
	Sunshine Soon	en_male_m03_sunshine_soon
	Warmy Breeze	en_female_f08_warmy_breeze
	Glorious	en_female_ht_f08_glorious
	It Goes Up	en_male_sing_funny_it_goes_up
	Chipmunk	en_male_m2_xhxs_m03_silly
	Dramatic	en_female_ht_f08_wonderful_world