free-tts · diff

v1.0.0 to v1.0.0

61 added, 60 removed. Audit A to A.

---
name: free-tts
version: 1.0.0
description: >
- 免费语音合成（edge-tts），无需 API Key 无需注册。将文本转为 mp3 音频文件。
- 当用户说"朗读""语音合成""文字转语音""TTS""生成音频""读一下"
- "读出来""念一下""听一下"或任何需要将文本转为语音播放的场景时触发。
+ Free text-to-speech (edge-tts), with no API key or registration required. Converts text to MP3 audio files.
+ Trigger this skill when the user says "read aloud," "text-to-speech," "TTS," "generate audio," "read it,"
+ "read it out loud," "say it," "play it," or in any scenario where text needs to be converted to speech for playback.
---
# Free TTS Skill
- 使用 `edge-tts`（Python 库）将文本转为语音 mp3 文件。底层调用微软 Edge 浏览器在线 TTS 接口，**完全免费、零注册、零配置、不限次数、国内直连**。
+ Use `edge-tts` (a Python library) to convert text to an MP3 audio file. It calls the Microsoft Edge browser's online TTS interface in the background. It is **completely free, requires no registration, needs no configuration, has unlimited usage, and connects directly from within China**.
- ## 环境依赖
+ ## Environment Dependencies
```sh
pip install edge-tts
```
- 无需任何 API Key、账号或 Token。
+ No API key, account, or token is required.
- ## 中文音色完整列表
+ ## Complete List of Chinese Voices
- | # | 音色 ID | 名称 | 性别 | 语言/风格 |
+ | # | Voice ID | Name | Gender | Language/Style |
|:-:|---------|------|:----:|-----------|
- | 1 | `zh-CN-XiaoxiaoNeural` | 晓晓 ⭐ | 女 | 普通话·温暖自然 |
- | 2 | `zh-CN-XiaoyiNeural` | 晓伊 | 女 | 普通话·活泼俏皮 |
- | 3 | `zh-CN-YunxiNeural` | 云希 | 男 | 普通话·阳光活力 |
- | 4 | `zh-CN-YunjianNeural` | 云健 | 男 | 普通话·激情有力 |
- | 5 | `zh-CN-YunyangNeural` | 云扬 | 男 | 普通话·专业可靠 |
- | 6 | `zh-CN-YunxiaNeural` | 云夏 | 男 | 普通话·可爱萌系 |
- | 7 | `zh-CN-liaoning-XiaobeiNeural` | 小蓓 | 女 | 东北话·幽默亲切 |
- | 8 | `zh-CN-shaanxi-XiaoniNeural` | 小妮 | 女 | 陕西话·明亮爽朗 |
- | 9 | `zh-HK-HiuGaaiNeural` | HiuGaai | 女 | 粤语·友好 |
- |10 | `zh-HK-HiuMaanNeural` | HiuMaan | 女 | 粤语·友好 |
- |11 | `zh-HK-WanLungNeural` | WanLung | 男 | 粤语·友好 |
- |12 | `zh-TW-HsiaoChenNeural` | HsiaoChen | 女 | 台普·友好 |
- |13 | `zh-TW-HsiaoYuNeural` | HsiaoYu | 女 | 台普·友好 |
- |14 | `zh-TW-YunJheNeural` | YunJhe | 男 | 台普·友好 |
+ | 1 | `zh-CN-XiaoxiaoNeural` | Xiaoxiao ⭐ | Female | Mandarin, warm and natural |
+ | 2 | `zh-CN-XiaoyiNeural` | Xiaoyi | Female | Mandarin, lively and playful |
+ | 3 | `zh-CN-YunxiNeural` | Yunxi | Male | Mandarin, cheerful and energetic |
+ | 4 | `zh-CN-YunjianNeural` | Yunjian | Male | Mandarin, passionate and powerful |
+ | 5 | `zh-CN-YunyangNeural` | Yunyang | Male | Mandarin, professional and reliable |
+ | 6 | `zh-CN-YunxiaNeural` | Yunxia | Male | Mandarin, cute and charming |
+ | 7 | `zh-CN-liaoning-XiaobeiNeural` | Xiaobei | Female | Northeastern Chinese, humorous and friendly |
+ | 8 | `zh-CN-shaanxi-XiaoniNeural` | Xiaoni | Female | Shaanxi dialect, bright and cheerful |
+ | 9 | `zh-HK-HiuGaaiNeural` | HiuGaai | Female | Cantonese, friendly |
+ |10 | `zh-HK-HiuMaanNeural` | HiuMaan | Female | Cantonese, friendly |
+ |11 | `zh-HK-WanLungNeural` | WanLung | Male | Cantonese, friendly |
+ |12 | `zh-TW-HsiaoChenNeural` | HsiaoChen | Female | Taiwan Mandarin, friendly |
+ |13 | `zh-TW-HsiaoYuNeural` | HsiaoYu | Female | Taiwan Mandarin, friendly |
+ |14 | `zh-TW-YunJheNeural` | YunJhe | Male | Taiwan Mandarin, friendly |
- 完整多语言音色列表请运行 `edge-tts --list-voices`。
+ To view the complete list of multilingual voices, run `edge-tts --list-voices`.
- ## 调用方式
+ ## Usage
```sh
- # 默认音色（晓晓）
- edge-tts --text "你好，欢迎使用免费语音合成。" --write-media /var/minis/workspace/output.mp3
+ # Default voice (Xiaoxiao)
+ edge-tts --text "Hello, and welcome to our free text-to-speech service." --write-media /var/minis/workspace/output.mp3
- # 指定音色
- edge-tts --voice zh-CN-XiaoyiNeural --text "今天天气真好" --write-media /var/minis/workspace/output.mp3
+ # Specify a voice
+ edge-tts --voice zh-CN-XiaoyiNeural --text "The weather is really nice today." --write-media /var/minis/workspace/output.mp3
- # 调节语速和音量（百分比，-50 ~ +100）
+ # Adjust speech rate and volume (percentage, -50 ~ +100)
edge-tts --voice zh-CN-XiaoxiaoNeural --rate=+20% --volume=+50% \
- --text "欢迎收听今天的新闻" --write-media /var/minis/workspace/output.mp3
+ --text "Welcome to today's news." --write-media /var/minis/workspace/output.mp3
```
- ### 参数说明
+ ### Parameter Description
- | 参数 | 说明 | 默认值 |
+ | Parameter | Description | Default Value |
|------|------|-------|
- | `--text` | 要合成的文本（必填） | — |
- | `--write-media` | 输出 mp3 文件路径（必填） | — |
- | `--voice` | 音色 ID | `zh-CN-XiaoxiaoNeural` |
- | `--rate` | 语速调整百分比 | `0%` |
- | `--volume` | 音量调整百分比 | `0%` |
- | `--pitch` | 音调调整 | `0Hz` |
+ | `--text` | Text to synthesize (required) | N/A |
+ | `--write-media` | Output MP3 file path (required) | N/A |
+ | `--voice` | Voice ID | `zh-CN-XiaoxiaoNeural` |
+ | `--rate` | Speech rate adjustment percentage | `0%` |
+ | `--volume` | Volume adjustment percentage | `0%` |
+ | `--pitch` | Pitch adjustment | `0Hz` |
- ## 输出格式
+ ## Output Format
- 返回 mp3 文件链接供用户点击播放，格式：
+ Return an MP3 file link that the user can click to play, in this format:
+
```
- ![音频](minis://workspace/free_tts_<timestamp>.mp3)
+ ![Audio](minis://workspace/free_tts_<timestamp>.mp3)
```
- ## 快捷指令
+ ## Shortcuts
- | 用户输入 | 行为 |
+ | User Input | Action |
|----------|------|
- | "读一下" / "朗读" | 默认音色（晓晓）合成并播放 |
- | "用男声" | 切换为 YunJhe（台普男声） |
- | "换一个" | 按列表轮换到下一个音色 |
- | "换方言" | 切换为 Xiaoni（陕西话） |
- | "换粤语" / "讲广东话" | 切换为 WanLung（粤语） |
- | "恢复默认" | 回到晓晓 |
+ | "Read it" / "Read aloud" | Synthesize and play using the default voice (Xiaoxiao) |
+ | "Use a male voice" | Switch to YunJhe (Taiwan Mandarin male voice) |
+ | "Change" | Cycle to the next voice in the list |
+ | "Switch to a dialect" | Switch to Xiaoni (Shaanxi dialect) |
+ | "Switch to Cantonese" / "Speak Cantonese" | Switch to WanLung (Cantonese) |
+ | "Restore default" | Return to Xiaoxiao |
- ## 完整工作流
+ ## Complete Workflow
- 1. 用户提出需要朗读文本，或说"读一下"
- 2. 确定目标音色（用户指定或使用当前默认）
- 3. 调用 `edge-tts` 合成 mp3 到 `/var/minis/workspace/free_tts_<timestamp>.mp3`
- 4. 返回音频链接供用户播放
+ 1. The user requests that text be read aloud or says "Read it"
+ 2. Determine the target voice (specified by the user or the current default)
+ 3. Call `edge-tts` to synthesize an MP3 at `/var/minis/workspace/free_tts_<timestamp>.mp3`
+ 4. Return an audio link for the user to play
- ## 注意事项
+ ## Notes
- - **合成速度**：一句话约 1-2 秒
- - **需联网**：云端合成，走微软 Edge TTS 在线接口
- - **零成本**：无需任何账号或付费
- - **输出格式**：24kHz 160kbps MP3
- - 英文等其他语言音色也可以说中文，但口音不标准，不推荐
+ - **Synthesis speed**: About 1 to 2 seconds per sentence
+ - **Internet connection required**: Cloud-based synthesis through the Microsoft Edge TTS online interface
+ - **Zero cost**: No account or payment required
+ - **Output format**: 24 kHz, 160 kbps MP3
+ - English and other non-Chinese voices can also speak Chinese, but their accents are not standard, so they are not recommended.