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:

• - INLINECODE0

Main entry script - Tencent Cloud TTS signature generation - Audio file generation - COS upload functionality

• - INLINECODE1

AgentScope tool interface wrapper

• - INLINECODE2

This file, describing Skill capabilities, boundaries, and usage conventions

• - INLINECODE3

Python dependency configuration

---

Input & Output Specifications

Input Parameters

Parameter	Description	Required	Default
INLINECODE4	Text content to convert	Yes	-
INLINECODE5

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

CODEBLOCK0

---

Usage

Environment Requirements

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

Install Dependencies

CODEBLOCK1

Basic Usage

CODEBLOCK2

Short Text Optimized Usage

CODEBLOCK3

Long Text Optimized Usage

CODEBLOCK4

---

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. 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