doubao-open-tts
Installation
SKILL.md
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
- Ensure VOLCANO_TTS_APPID, VOLCANO_TTS_ACCESS_TOKEN, and VOLCANO_TTS_SECRET_KEY environment variables are set
- Supports mp3, pcm, and wav formats (mp3 by default)
- Speed range: 0.8-2.0 (1.0 is normal)
- Volume range: 0.1-3.0 (1.0 is normal)
- Voice types can be viewed using
--list-voices - Different clusters may support different voice types; default cluster is
volcano_tts - For non-Chinese text, use multilingual voices from "General-Multilingual" category
Related skills
More from xdrshjr/jr-openclaw-skills
volcengine-image-gen
使用火山引擎（豆包）Seedream 系列模型生成高质量图片。支持文生图、多种分辨率、多种比例。
41paper-review
Comprehensive peer review of academic papers for top-tier computer science conferences and journals. Supports PDF and LaTeX inputs, provides detailed reviews with scores, and generates improvement plans. Use when the user asks to review, evaluate, or provide feedback on academic papers.
27session-cleaner
Clean up and manage OpenClaw sessions - kill all sub-agents, clear context, and reset the system to a clean state. Use when user says "close all sessions", "clear context", "kill all agents", "clean up sessions", "reset everything", "关掉所有子agent", "清空上下文", "关闭所有session", or similar cleanup requests.
6project-indexer
Generate and use project index for quick codebase understanding in new Claude Code sessions. Scans project structure, extracts code symbols, and creates a navigable feature map.
2reference-finder
Automatically analyze research text, extract domains and key concepts, then generate comprehensive reference lists with summaries using Gemini AI. Use when users need to (1) Generate literature references from research descriptions, (2) Find relevant academic papers for a research topic, (3) Build bibliography for research proposals, (4) Discover key papers in specific research domains, or (5) Create structured reference documentation from free-form research text.
2auto-updater
Automatically update Clawdbot and all installed skills once daily. Runs via cron, checks for updates, applies them, and messages the user with a summary of what changed.
2