tiktok-tts

1.1.16 • Public • Published

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.

example workflow downloads

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)

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

Package Sidebar

Install

npm i tiktok-tts

Weekly Downloads

41

Version

1.1.16

License

MIT

Unpacked Size

20.5 kB

Total Files

7

Last publish

Collaborators

  • steve0929