TencentCloud TTS

腾讯云语音合成(TTS)服务技能包。当用户需要将文本转换为语音文件时使用此技能，支持多种音频格式输出和灵活的配置选项。当用户提到语音合成、文本转语音、TTS服务、音频文件生成时，都应该考虑使用此技能。

Security Scan

The skill is internally consistent: it implements a Tencent Cloud TTS client, only asks for the expected Tencent Cloud credentials, makes HTTPS calls to the official TTS endpoint, and contains no surprising installs or external endpoints.

Purpose & Capability

Name/description (TencentCloud TTS) match the code and SKILL.md. The package only requires Tencent Cloud API keys and implements TextToSpeech functionality (synthesize) targeting tts.tencentcloudapi.com — all expected for this purpose.

Instruction Scope

SKILL.md instructs the agent to set TENCENTCLOUD_SECRET_ID/KEY and to call the synthesize API. Runtime instructions and code only read those credentials and write generated audio files; there are no instructions to read unrelated files, exfiltrate data to third-party endpoints, or perform wide-ranging system queries.

Install Mechanism

No install spec is provided (instruction-only skill). The repository includes Python scripts and examples; dependencies listed are dev/test tools and mostly optional. Nothing is downloaded from arbitrary URLs or added to the system automatically.

Credentials

The skill requests only Tencent Cloud credentials (TENCENTCLOUD_SECRET_ID and TENCENTCLOUD_SECRET_KEY) and references optional region/token vars in config templates. Those are proportionate to calling the Tencent Cloud TTS API and are declared in the documentation.

Persistence & Privilege

The skill does not request always:true and does not modify other skills or system-wide configs. It writes audio output files and generates local template/config/check scripts when run, which is expected for a local TTS client.

Assessment

This skill appears to do exactly what it claims: it signs and posts requests to Tencent Cloud's TTS API and saves the returned audio to disk. Before installing or running: 1) only provide Tencent Cloud keys that are scoped for TTS (follow least-privilege), rotate keys if possible, and don't hard-code them; 2) run the included tests/examples locally to verify behavior; 3) be aware the code will write generated audio files and will create .env.template and a check_config.py when running the config helper; and 4) ensure your environment/network allows outbound HTTPS to tts.tencentcloudapi.com. If you need higher assurance, review the signature and HTTP request code locally (scripts/tencent_tts.py) to confirm it matches your security expectations.

腾讯云语音合成(TTS)技能包

本技能包提供基于腾讯云语音合成服务的文本转语音功能，专注于基础单次合成需求。

功能特性

• 文本转语音: 将任意文本内容转换为高质量的语音文件
• 多格式支持: 支持MP3、WAV等常见音频格式
• 语音参数配置: 可配置语音类型、音频格式等参数
• 安全认证: 通过环境变量安全管理腾讯云API密钥

前置要求

在使用本技能前，请确保：

1. 腾讯云账号: 拥有有效的腾讯云账号
2. API密钥: 获取腾讯云API的SecretId和SecretKey
3. 服务开通: 已开通腾讯云语音合成(TTS)服务

配置说明

环境变量配置

将腾讯云API密钥配置为环境变量：

export TENCENTCLOUD_SECRET_ID="your-secret-id"
export TENCENTCLOUD_SECRET_KEY="your-secret-key"

技能参数说明

参数名	类型	必填	默认值	说明
text	string	是	-	要转换为语音的文本内容
voice_type	int	否	101001	语音类型（101001-101015）
codec	string	否	mp3	音频编码格式（mp3/wav）
output_file	string	否	output.mp3	输出音频文件名

使用示例

基本使用

# 使用默认参数合成语音
from tencent_tts import TextToSpeech

tts = TextToSpeech()
result = tts.synthesize("欢迎使用腾讯云语音合成服务")
print(f"音频文件已生成: {result['output_file']}")

自定义参数

# 使用自定义参数
from tencent_tts import TextToSpeech

tts = TextToSpeech()
result = tts.synthesize(
    text="这是一个自定义语音合成的示例",
    voice_type=101002,
    codec="wav",
    output_file="custom_voice.wav"
)
print(f"音频文件已生成: {result['output_file']}")

文件结构

tencent-tts/
├── SKILL.md (本文件)
├── scripts/
│   └── tencent_tts.py (主功能脚本)
└── examples/
    └── basic_usage.py (基础使用示例)

最佳实践

1. 密钥安全: 不要将API密钥硬编码在代码中
2. 文本长度: 单次合成文本建议不超过300字符
3. 频率控制: 避免高频调用，遵守服务限制
4. 文件管理: 定期清理生成的音频文件

技术支持

如遇问题，请参考：

• 腾讯云语音合成文档：https://cloud.tencent.com/document/product/1073
• API错误码说明：https://cloud.tencent.com/document/api/1073/37996