> 数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP查询等 200+ 免费/低价 API。
将文本内容合成为语音文件：支持多种拟人音色、多语言及方言，自适应语气，流畅处理复杂文本。
# 方式一：环境变量（推荐，一次配置永久生效）
export JUHE_SPEECH_KEY=你的AppKey
# 方式二：.env 文件（在脚本目录创建）
echo "JUHE_SPEECH_KEY=你的AppKey" > scripts/.env
# 方式三：每次命令行传入
python scripts/speech_generate.py --key 你的AppKey "今天天气真好！"
python scripts/speech_generate.py "今天天气真好，我想去公园散步。"
输出示例：
🔊 语音合成成功！
音色: Cherry（随机）
语种: Auto
文本: 今天天气真好，我想去公园散步。
音频链接（24小时内有效）:
https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/...wav
# 用甜美港妹音色
python scripts/speech_generate.py --voice Kiki "你好，欢迎使用聚合数据语音合成服务！"
# 用御姐音色
python scripts/speech_generate.py --voice Katerina "本次会议正式开始，请各位嘉宾就坐。"
# 用幽默台湾哥仔音色
python scripts/speech_generate.py --voice Roy "欸，今天吃什么好呢？"
# 英文
python scripts/speech_generate.py --voice Jennifer --language English "Hello, welcome to Juhe Data!"
# 日文
python scripts/speech_generate.py --language Japanese "こんにちは、今日もいい天気ですね。"
# 自动识别（默认）
python scripts/speech_generate.py --language Auto "今天 is a good day!"
# 合成并自动下载到当前目录
python scripts/speech_generate.py --download "这段话将被保存为音频文件。"
# 合成并保存到指定路径
python scripts/speech_generate.py --output /tmp/my_audio.wav "指定保存位置。"
# 从文本文件读取内容（不超过500字符）
python scripts/speech_generate.py --file my_text.txt --voice Cherry
python scripts/speech_generate.py --list-voices
| 音色名 | 风格描述 | 适用场景 |
|---|---|---|
| ------------ | ---------------------------------- | ------------------ |
| Cherry | 阳光积极、亲切自然小姐姐 | 客服、播报、通用 |
| Ethan | 标准普通话，阳光温暖，北方口音 | 新闻播报、教育 |
| Nofish | 不会翘舌音的设计师 | 创意内容、趣味 |
| Jennifer | 品牌级电影质感美语女声 | 英文内容、品牌 |
| Ryan | 节奏拉满，戏感炸裂 | 短视频、广告 |
| Katerina | 御姐音色，韵律回味十足 | 高端品牌、旁白 |
| Elias | 严谨学术，知识叙事 | 教育、科普 |
| Jada | 风风火火的沪上阿姐 | 上海方言、趣味 |
| Dylan | 北京胡同里长大的少年 | 北京话、青春感 |
| Sunny | 甜到你心里的川妹子 | 四川方言、萌系 |
| Li | 耐心的瑜伽老师 | 冥想、养生、舒缓 |
| Marcus | 面宽话短，心实声沉，老陕的味道 | 陕西味、质朴感 |
| Roy | 诙谐直爽、市井活泼的台湾哥仔 | 台湾腔、娱乐 |
| Peter | 天津相声，专业捧哏 | 天津话、搞笑 |
| Rocky | 幽默风趣的阿强，在线陪聊 | 陪伴、娱乐 |
| Kiki | 甜美的港妹闺蜜 | 粤语、甜系 |
| Eric | 跳脱市井的四川成都男子 | 成都话、潮流感 |
| 语种代码 | 说明 |
|---|---|
| ------------- | ------------- |
| Auto | 自动识别（默认） |
| Chinese | 中文 |
| English | 英文 |
| German | 德文 |
| Italian | 意大利文 |
| Portuguese | 葡萄牙文 |
| Spanish | 西班牙文 |
| Japanese | 日文 |
| Korean | 韩文 |
| French | 法文 |
| Russian | 俄文 |
当用户要求合成语音时，按以下步骤操作：
--voice、--language、--download 参数--download 或 --output 参数| 参数 | 必填 | 说明 | 示例 |
|---|---|---|---|
| ---------------- | ------ | --------------------------------------- | ----------------------- |
text | 是 | 要合成的文本，最多500字符 | "你好世界" |
--voice | 否 | 音色名称，不指定则随机 | Cherry、Kiki |
--language | 否 | 语种，默认 Auto | Chinese、English |
--download | 否 | 合成后自动下载到当前目录 | — |
--output | 否 | 指定下载保存路径 | /tmp/output.wav |
--file | 否 | 从文件读取文本内容 | my_text.txt |
--list-voices | 否 | 列出所有可用音色 | — |
--key | 否 | 临时指定 API Key | abc123 |
| 字段 | 含义 | 示例 |
|---|---|---|
| -------------- | ----------------------------------- | ----------------------------------- |
error_code | 状态码，0 为成功 | 0 |
reason | 状态提示 | 成功 |
orderid | 订单号 | JH83025121914072892mDt |
audio_url | 音频文件下载链接（24小时有效） | https://dashscope-result-bj...wav |
| 情况 | 处理方式 |
|---|---|
| ------------------------- | ------------------------------------------------------------------------------ |
error_code 10001/10002 | API Key 无效，引导用户至 聚合数据 重新申请 |
error_code 10012 | 当日免费次数已用尽，建议升级套餐 |
| 文本超过500字符 | 提示用户截断文本后重试 |
| 音频链接过期 | 链接有效期24小时，提示用户重新生成 |
| 请求超时 | 接口生成耗时可能较长，超时设置建议60s以上，重试一次后仍失败则提示网络问题 |
scripts/speech_generate.py — 封装了 API 调用、参数校验、音频下载和错误处理。
聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供包括：
注册即可免费使用，适合个人开发者和企业接入。
共 1 个版本