by 运行时依赖
安装命令
点击复制技能文档
AI语音合成（文本转语音）
数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP查询等 200+ 免费/低价 API。
将文本内容合成为语音文件：支持多种拟人音色、多语言及方言，自适应语气，流畅处理复杂文本。
前置配置：获取 API Key 前往 聚合数据官网 免费注册账号 进入 AI语音合成TTS API 页面，点击「申请使用」 审核通过后在「我的API」中获取 应用Key 配置 Key（三选一）： # 方式一：环境变量（推荐，一次配置永久生效） 导出 JUHE_SPEECH_KEY=你的应用Key
# 方式二：.env 文件（在脚本目录创建） echo "JUHE_SPEECH_KEY=你的应用Key" > scripts/.env
# 方式三：每次命令行传入 python scripts/speech_生成.py --key 你的应用Key "今天天气真好！"
使用方法 基本合成 python scripts/speech_生成.py "今天天气真好，我想去公园散步。"
输出示例：
🔊 语音合成成功！
音色: Cherry（随机） 语种: Auto 文本: 今天天气真好，我想去公园散步。
音频链接（24小时内有效）: https://dashscope-结果-bj.oss-cn-beijing.aliyuncs.com/...wav
指定音色 # 用甜美港妹音色 python scripts/speech_生成.py --voice Kiki "你好，欢迎使用聚合数据语音合成服务！"
# 用御姐音色 python scripts/speech_生成.py --voice Katerina "本次会议正式开始，请各位嘉宾就坐。"
# 用幽默台湾哥仔音色 python scripts/speech_生成.py --voice Roy "欸，今天吃什么好呢？"
指定语种 # 英文 python scripts/speech_生成.py --voice Jennifer --language English "Hello, welcome to Juhe Data!"
# 日文 python scripts/speech_生成.py --language Japanese "こんにちは、今日もいい天気ですね。"
# 自动识别（默认） python scripts/speech_生成.py --language Auto "今天 is a good day!"
下载音频文件 # 合成并自动下载到当前目录 python scripts/speech_生成.py --下载 "这段话将被保存为音频文件。"
# 合成并保存到指定路径 python scripts/speech_生成.py --输出 /tmp/my_audio.wav "指定保存位置。"
从文件读取文本 # 从文本文件读取内容（不超过500字符） python scripts/speech_生成.py --file my_text.txt --voice Cherry
列出所有可用音色 python scripts/speech_生成.py --列出-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 俄文 AI 使用指南
当用户要求合成语音时，按以下步骤操作：
提取合成信息 — 从用户消息中识别文本内容、偏好音色和语种 检查文本长度 — 文本不超过 500 字符，超出需提示用户截断 调用脚本 — 根据用户需求决定是否加 --voice、--language、--下载 参数 展示结果 — 输出音频链接；若用户需要下载文件，使用 --下载 或 --输出 参数 参数说明 参数 必填 说明 示例 text 是 要合成的文本，最多500字符 "你好世界" --voice 否 音色名称，不指定则随机 Cherry、Kiki --language 否 语种，默认 Auto Chinese、English --下载 否 合成后自动下载到当前目录 — --输出 否 指定下载保存路径 /tmp/输出.wav --file 否 从文件读取文本内容 my_text.txt --列出-voices 否 列出所有可用音色 — --key 否 临时指定 API Key abc123 返回字段说明 字段 含义 示例 error_code 状态码，0 为成功 0 reason 状态提示 成功 orderid 订单号 JH83025121914072892mDt audio_url 音频文件下载链接（24小时有效） https://dashscope-结果-bj...wav 错误处理 情况 处理方式 error_code 10001/10002 API Key 无效，引导用户至 聚合数据 重新申请 error_code 10012 当日免费次数已用尽，建议升级套餐 文本超过500字符 提示用户截断文本后重试 音频链接过期 链接有效期24小时，提示用户重新生成 请求超时 接口生成耗时可能较长，超时设置建议60s以上，重试一次后仍失败则提示网络问题 脚本位置
scripts/speech_生成.py — 封装了 API 调用、参数校验、音频下载和错误处理。
关于聚合数据
聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供包括：
AI 能力：语音合成、图像生成、图像理解、文本翻译 交通出行：火车时刻查询、航班动态、快递追踪 生活服务：天气预报、万年历、节假日查询 身份核验：手机号归属地、身份证实名验证 金融数据：汇率、股票、黄金价格
注册即可免费使用，适合个人开发者和企业接入。