Doubao Open TTS

Text-to-Speech (TTS) service using Doubao (Volcano Engine) API V1 interface to convert text into natural-sounding speech.

Features

• 🎙️ 200+ Voice Options - Default: Shiny (灿灿) for general scenarios
• 🔊 Multiple Audio Formats - Supports mp3, pcm, wav
• ⚡ Adjustable Parameters - Speed and volume control
• 📦 Dual Interface - Command-line tool + Python API
• 🎯 Voice Categorization - Browse voices by category

Installation

cd skills/doubao-open-tts
pip install -r requirements.txt

Configuration

Method 1: Environment Variables

export VOLCANO_TTS_APPID="your_app_id"
export VOLCANO_TTS_ACCESS_TOKEN="your_access_token"
export VOLCANO_TTS_SECRET_KEY="your_secret_key"
export VOLCANO_TTS_VOICE_TYPE="zh_female_cancan_mars_bigtts"  # Optional: set default voice

Method 2: .env File

Copy .env.example.txt to .env and fill in your credentials:

cp .env.example.txt .env
# Edit the .env file with your credentials

Usage

Command Line

# Basic usage (uses default voice: Shiny)
python scripts/tts.py "Hello, this is a test of Doubao text-to-speech service"

# Specify output file and format
python scripts/tts.py "Welcome to use TTS" -o output.mp3 -e mp3

# Read text from file
python scripts/tts.py -f input.txt -o output.mp3

# Adjust parameters
python scripts/tts.py "Custom voice" --speed 1.2 --volume 0.8 -v zh_female_cancan_mars_bigtts

# List all available voices
python scripts/tts.py --list-voices

# List voices by category
python scripts/tts.py --list-voices --category "General-Multilingual"

# Use different cluster
python scripts/tts.py "Hello" --cluster volcano_tts

# Enable debug mode
python scripts/tts.py "Test" --debug

Python API

from scripts.tts import VolcanoTTS, VOICE_TYPES, VOICE_CATEGORIES

# Initialize client
tts = VolcanoTTS(
    app_id="your_app_id",
    access_token="your_access_token",
    secret_key="your_secret_key",
    voice_type="zh_female_cancan_mars_bigtts"  # Optional: set default voice
)

# List available voices
print("All voices:", tts.list_voices())
print("General voices:", tts.list_voices("General-Normal"))

# Change voice
tts.set_voice("zh_male_xudong_conversation_wvae_bigtts")  # Set to "Happy Xiaodong"

# Synthesize speech
output_path = tts.synthesize(
    text="Hello, this is Doubao text-to-speech",
    voice_type="zh_female_cancan_mars_bigtts",  # Optional: override default
    encoding="mp3",
    cluster="volcano_tts",
    speed=1.0,
    volume=1.0,
    output_file="output.mp3"
)
print(f"Audio saved to: {output_path}")

Available Voice Types

General Category (通用场景)

Voice Name	Voice Type	Description
Shiny (灿灿)	zh_female_cancan_mars_bigtts	Cheerful female voice, suitable for various scenarios
Lively Xiaoning (活泼小宁)	zh_female_wanwanxiaohe_mars_bigtts	Lively and playful female voice
Xiaomo (小莫)	zh_male_xiaomo_mars_bigtts	Warm and friendly male voice
Xiaoqi (小琪)	zh_female_xiaoqi_mars_bigtts	Professional female host
AISuper (AI超级大流利)	zh_female_gaolanfenqu_mars_bigtts	Super fluent female voice

Emotional Category (情感超自然人声)

Voice Name	Voice Type	Description
Happy Xiaodong (开心小东)	zh_male_xudong_conversation_wvae_bigtts	Cheerful and sunny male voice
Sad Xiaoliang (悲伤小亮)	zh_male_sadxiaoliang_sad_mars_bigtts	Melancholic male voice
Neutral Xiaoshuai (中性小帅)	zh_male_zhongxingxiaoshuai_speech_mars_bigtts	Neutral tone male voice
Happy Xiaomei (开心小美)	zh_female_gaoxiaomei_happy_mars_bigtts	Cheerful female voice
Angry Xiaotian (愤怒小甜)	zh_female_shengmoxiaotian_angry_mars_bigtts	Angry tone female voice

Intelligent Customer Service (智能客服)

Voice Name	Voice Type	Description
Customer Service Xiaowen (客服小文)	zh_male_jingyixiaowen_mars_bigtts	Professional customer service male voice
Customer Service Xiaorou (客服小柔)	zh_female_xiaorou_customer_service_mars_bigtts	Gentle customer service female voice

Documentary (纪录片)

Voice Name	Voice Type	Description
Classic Xiaoming (经典小明)	zh_male_jingdianxiaoming_mars_bigtts	Classic documentary male voice
Narration Xiaoran (旁白小然)	zh_female_xiaoran_narration_mars_bigtts	Documentary narration female voice

Audio Novels (有声小说)

Voice Name	Voice Type	Description
Storytelling Xiaotao (讲书小桃)	zh_female_jiangshuxiaotao_mars_bigtts	Storytelling female voice
Warm Xiaochen (温暖小晨)	zh_male_wennuanxiaochen_mars_bigtts	Warm novel reading male voice

News Broadcasting (新闻播报)

Voice Name	Voice Type	Description
News Xiaozhi (新闻小志)	zh_male_xinwenxiaozhi_mars_bigtts	Standard news broadcasting male voice
News Xiaojing (新闻小静)	zh_female_xinwenxiaojing_mars_bigtts	Professional news broadcasting female voice
Cantonese News (粤语新闻)	zh_male_yueyuxiaowu_mars_bigtts	Cantonese news male voice
Amoy News (闽南语新闻)	zh_female_minnanxiaoyue_mars_bigtts	Amoy dialect news female voice

General-Multilingual (通用多语言)

Voice Name	Voice Type	Description
English Gentle (英语男声-柔和)	en_male_mars_bigtts	Gentle English male voice
English Lively (英语女声-活泼)	en_female_mars_bigtts	Lively English female voice
Japanese Male (日语男声)	ja_male_mars_bigtts	Japanese male voice
Japanese Female (日语女声)	ja_female_mars_bigtts	Japanese female voice
Korean Male (韩语男声)	ko_male_mars_bigtts	Korean male voice
Korean Female (韩语女声)	ko_female_mars_bigtts	Korean female voice
French Male (法语男声)	fr_male_mars_bigtts	French male voice
French Female (法语女声)	fr_female_mars_bigtts	French female voice
German Male (德语男声)	de_male_mars_bigtts	German male voice
German Female (德语女声)	de_female_mars_bigtts	German female voice
Spanish Male (西班牙语男声)	es_male_mars_bigtts	Spanish male voice
Spanish Female (西班牙语女声)	es_female_mars_bigtts	Spanish female voice
Russian Male (俄语男声)	ru_male_mars_bigtts	Russian male voice
Russian Female (俄语女声)	ru_female_mars_bigtts	Russian female voice
Portuguese Male (葡萄牙语男声)	pt_male_mars_bigtts	Portuguese male voice
Portuguese Female (葡萄牙语女声)	pt_female_mars_bigtts	Portuguese female voice
Italian Male (意大利语男声)	it_male_mars_bigtts	Italian male voice
Italian Female (意大利语女声)	it_female_mars_bigtts	Italian female voice
Arabic Male (阿拉伯语男声)	ar_male_mars_bigtts	Arabic male voice
Arabic Female (阿拉伯语女声)	ar_female_mars_bigtts	Arabic female voice
Hindi Male (印地语男声)	hi_male_mars_bigtts	Hindi male voice
Hindi Female (印地语女声)	hi_female_mars_bigtts	Hindi female voice
Thai Male (泰语男声)	th_male_mars_bigtts	Thai male voice
Thai Female (泰语女声)	th_female_mars_bigtts	Thai female voice
Vietnamese Male (越南语男声)	vi_male_mars_bigtts	Vietnamese male voice
Vietnamese Female (越南语女声)	vi_female_mars_bigtts	Vietnamese female voice
Indonesian Male (印尼语男声)	id_male_mars_bigtts	Indonesian male voice
Indonesian Female (印尼语女声)	id_female_mars_bigtts	Indonesian female voice
Malay Male (马来语男声)	ms_male_mars_bigtts	Malay male voice
Malay Female (马来语女声)	ms_female_mars_bigtts	Malay female voice
Filipino Male (菲律宾语男声)	fil_male_mars_bigtts	Filipino male voice
Filipino Female (菲律宾语女声)	fil_female_mars_bigtts	Filipino female voice
Turkish Male (土耳其语男声)	tr_male_mars_bigtts	Turkish male voice
Turkish Female (土耳其语女声)	tr_female_mars_bigtts	Turkish female voice
Dutch Male (荷兰语男声)	nl_male_mars_bigtts	Dutch male voice
Dutch Female (荷兰语女声)	nl_female_mars_bigtts	Dutch female voice
Polish Male (波兰语男声)	pl_male_mars_bigtts	Polish male voice
Polish Female (波兰语女声)	pl_female_mars_bigtts	Polish female voice
Ukrainian Male (乌克兰语男声)	uk_male_mars_bigtts	Ukrainian male voice
Ukrainian Female (乌克兰语女声)	uk_female_mars_bigtts	Ukrainian female voice
Hebrew Male (希伯来语男声)	he_male_mars_bigtts	Hebrew male voice
Hebrew Female (希伯来语女声)	he_female_mars_bigtts	Hebrew female voice

Dialect Category (方言场景)

Voice Name	Voice Type	Description
Cantonese Male (粤语男声)	zh_male_yueyuzhongxing_mars_bigtts	Cantonese male voice
Cantonese Female (粤语女声)	zh_female_yueyumars_mars_bigtts	Cantonese female voice
Amoy Male (闽南语男声)	zh_male_taiminmars_mars_bigtts	Amoy dialect male voice
Amoy Female (闽南语女声)	zh_female_minnanAImars_mars_bigtts	Amoy dialect female voice
Sichuanese (四川话)	zh_male_sichuanmars_mars_bigtts	Sichuan dialect male voice
Shanghainese (上海话)	zh_female_shanghaihuamars_mars_bigtts	Shanghainese female voice
Wuhan Dialect (武汉话)	zh_male_wuhanmars_mars_bigtts	Wuhan dialect male voice
Hunan Dialect (湖南话)	zh_male_hunanmars_mars_bigtts	Hunan dialect male voice
Henan Dialect (河南话)	zh_female_henanmars_mars_bigtts	Henan dialect female voice
Northeastern Dialect (东北话)	zh_male_dongbeimars_mars_bigtts	Northeastern dialect male voice
Shandong Dialect (山东话)	zh_male_shandongmars_mars_bigtts	Shandong dialect male voice
Tianjin Dialect (天津话)	zh_female_tianjinmars_mars_bigtts	Tianjin dialect female voice

Special Categories

Voice Name	Voice Type	Description
Audiobook Xiaoyu (有声小予)	zh_female_xiaoyujingxisanguo_mars_bigtts	Three Kingdoms audiobook voice
Animation Xiaohua (动漫小花)	zh_female_xiaohuadongman_mars_bigtts	Anime style voice
Rap Xiaoqiang (Rap小蔷)	zh_female_xiaoqiangrap_mars_bigtts	Rap style female voice
RAP General (Rap大将)	zh_male_rapgeneral_mars_bigtts	Rap style male voice
Wise Voice (智慧的声音)	zh_male_jinyumars_mars_bigtts	Wise and mature voice
Chattering (唠唠叨叨)	zh_female_laolaodaodao_chat_mars_bigtts	Chatty female voice
Talking Beijing (讲话北京)	zh_male_jianghuabeijing_speech_mars_bigtts	Beijing accent
Host Xiaoyang (主播小羊)	zh_female_xiaoyang_host_mars_bigtts	Streamer host style

Output

The generated audio file will be saved to the specified output path (default: output.mp3 in current directory).

Notes

1. Ensure VOLCANO_TTS_APPID, VOLCANO_TTS_ACCESS_TOKEN, and VOLCANO_TTS_SECRET_KEY environment variables are set
2. Supports mp3, pcm, and wav formats (mp3 by default)
3. Speed range: 0.8-2.0 (1.0 is normal)
4. Volume range: 0.1-3.0 (1.0 is normal)
5. Voice types can be viewed using --list-voices
6. Different clusters may support different voice types; default cluster is volcano_tts
7. For non-Chinese text, use multilingual voices from "General-Multilingual" category