tencent-tts-podcast

Convert text to podcast audio using Tencent Cloud TTS. Supports both short and long text processing, generates up to 30-minute long audio with automatic chun...

Tencent TTS Podcast Generator

Convert text content to podcast audio files using Tencent Cloud TTS service.

Capabilities

What This Skill Can Do

• Short & Long Text Compatible: Intelligently detects text length, processes short text directly, auto-chunks long text
• Long Text to Speech: Supports generating podcasts up to 30 minutes long (~7200 characters)
• Concurrent Processing: Long texts are automatically split and processed in parallel for faster generation
• 26 Voices: Supports basic, featured, customer service, and Tencent featured voices
• Smart Chunking: Splits text at semantic boundaries (paragraph/sentence) for natural audio flow
• Duration Estimation: Automatically estimates generated audio duration
• Auto Retry: Automatically retries failed requests to improve success rate

Short & Long Text Processing Strategy

Note: Tencent Cloud TTS single request limit is ~150 characters. Texts exceeding this will be auto-chunked.

Text Type	Length Range	Processing Method	Concurrency	Timeout
Ultra Short	≤50 chars	Direct request	1	30s
Short	50-150 chars	Direct request	1	30s
Medium	150-500 chars	Auto-chunk (2-4 chunks)	2-3	60s
Long	500-2000 chars	Auto-chunk (4-14 chunks)	3-5	60s
Extra Long	2000-7200 chars	Auto-chunk (14-50 chunks)	3-5	60s

What This Skill Does NOT Do

• Does not generate mp3 format (wav only)
• Does not support background music or sound effects
• Does not auto-generate podcast scripts (user must provide)
• Does not support dual-speaker dialogue mode (single voice only)

---

File Structure

This Skill consists of the following files:

• tts_podcast.py Main entry script

  • Tencent Cloud TTS signature generation
  • Audio file generation
  • COS upload functionality

• tts_tool.py AgentScope tool interface wrapper

• SKILL.md This file, describing Skill capabilities, boundaries, and usage conventions

• requirements.txt Python dependency configuration

---

Input & Output Specifications

Input Parameters

Parameter	Description	Required	Default
Text	Text content to convert	Yes	-
VoiceType	Voice ID (see voice table below, either this or VoiceName)	No	502006
VoiceName	Voice name (see voice table below, either this or VoiceType)	No	-
secret_id	Tencent Cloud SecretId	Yes	-
secret_key	Tencent Cloud SecretKey	Yes	-
max_workers	Concurrent threads (3-5 for long text, 1 for short)	No	3
chunk_size	Chunk size in characters (long text optimization)	No	140
timeout	Request timeout in seconds	No	30/60
enable_retry	Enable automatic retry	No	true
max_retries	Max retry attempts	No	2
preserve_paragraphs	Preserve paragraph boundaries when chunking	No	true
cos_secret_id	Tencent Cloud COS SecretId (optional, defaults to TTS credentials)	No	-
cos_secret_key	Tencent Cloud COS SecretKey (optional, defaults to TTS credentials)	No	-
upload_cos	Whether to upload to COS, true/false (default false, local only)	No	false
bucket_name	COS Bucket name (default: ti-aoi)	No	ti-aoi
app_id	COS App ID (default: 1257195185)	No	1257195185
region	COS region (default: ap-guangzhou)	No	ap-guangzhou

Output

{
  "Code": 0,
  "Msg": "success",
  "AudioUrl": "https://xxx.cos.ap-guangzhou.myqcloud.com/xxx.wav"
}

---

Usage

Environment Requirements

• Python 3.8+
• tencentcloud-sdk-python
• cos-python-sdk-v5
• requests

Install Dependencies

pip install -r requirements.txt

Basic Usage

from tts_podcast import main

result = main({
    "Text": "Hello, welcome to today's podcast.",
    "VoiceType": 502006,
    "secret_id": "YOUR_SECRET_ID",
    "secret_key": "YOUR_SECRET_KEY"
})

print(result)
# {'Code': 0, 'Msg': 'success', 'AudioUrl': 'https://...'}

Short Text Optimized Usage

# Short text (<150 chars) - Use single thread for fast response
result = main({
    "Text": "Hello, this is a short message.",
    "VoiceType": 502006,
    "secret_id": "YOUR_SECRET_ID",
    "secret_key": "YOUR_SECRET_KEY",
    "max_workers": 1,      # Single thread is sufficient
    "timeout": 30,         # 30 second timeout
    "enable_retry": True   # Enable retry
})

Long Text Optimized Usage

# Long text (>150 chars) - Use concurrency for speed
long_text = """Chapter 1: The Origin of AI

The concept of artificial intelligence can be traced back to ancient Greek mythology..."""

result = main({
    "Text": long_text,
    "VoiceType": 502007,
    "secret_id": "YOUR_SECRET_ID",
    "secret_key": "YOUR_SECRET_KEY",
    "max_workers": 5,          # Concurrent processing
    "chunk_size": 140,         # 140 chars per chunk
    "timeout": 60,             # 60 second timeout
    "preserve_paragraphs": True  # Preserve paragraph boundaries
})

---

Voice Reference

VoiceType	Voice Name	Characteristics
0	普通女声	Standard female
1	普通男声	Standard male
5	情感女声	Emotional female
6	情感男声	Emotional male
1000	智障少女	Lively cute
1001	阳光少年	Bright youthful
1002	温柔淑女	Gentle female
1003	成熟青年	Mature male
1004	严厉管事	Stern female
1005	亲和女声	Friendly female
1006	甜美女声	Sweet female
1007	磁性男声	Magnetic male
1008	播音主播	Broadcast anchor
101001	客服女声	Customer service
101005	售前客服	Pre-sales service
101007	售后客服	After-sales service
101008	亲和客服	Friendly service
502006	小旭	Tencent voice
502007	小巴	Tencent voice
502008	思驰	Tencent voice
502009	思佳	Tencent voice
502010	思悦	Tencent voice
502011	小宁	Tencent voice
502012	小杨	Tencent voice
502013	云扬	Tencent voice
502014	云飞	Tencent voice

---

Technical Architecture

tts_podcast.py

• TTS: Uses Tencent Cloud TTS API signature v3
• Upload: Uses Tencent Cloud COS SDK for audio file upload
• Auth: Supports credentials from parameters or environment variables
• Short & Long Text Compatible:
  • Short text (≤150 chars): Direct single request, fast response
  • Long text (>150 chars): Smart chunking + concurrent processing + auto-merge

Text Chunking Strategy

1. Paragraph Priority: Try to preserve paragraph integrity, split at paragraph boundaries
2. Sentence Boundaries: When paragraphs are too long, split at sentence ending punctuation (。！？；)
3. Semantic Protection: Avoid truncating in the middle of words, ensure semantic coherence
4. Length Control: Each chunk does not exceed 150 characters (Tencent Cloud API limit)

---

License

MIT