PHP切换TTS音色需正确设置第三方API的voice（阿里云）、per（百度）、VoiceType（腾讯云）等参数，拼写、参数位置、鉴权及SDK版本均影响生效。

PHP 本身不直接支持语音合成（TTS），所谓“调用听书插件”实际是调用第三方 TTS 服务的 HTTP API（如阿里云语音合成、百度语音、腾讯云 TTS 等），音色切换完全取决于该服务提供的 voice 或 speaker 参数，PHP

确认你用的是哪个 TTS 服务商的 API

不同厂商的参数名、可用音色列表、鉴权方式完全不同，不能混用。常见情况：

• 阿里云智能语音交互（Intelligent Speech Interaction）：参数为 voice，值如 zhitian_emo、xiaoyun、siyue
• 百度语音合成（Text to Speech）：参数为 per（person），值如 111（度小美）、106（度博文）、112（度小宇）
• 腾讯云语音合成（TTS）：参数为 VoiceType，值如 2001（云希）、2002（云磊）、2004（云扬）
• 本地部署的 eSpeak / Piper / Coqui TTS：需通过命令行或 HTTP 封装服务，音色由模型文件决定，参数通常是 model 或 speaker_id

PHP 中切换音色的关键是正确设置请求参数

以阿里云为例，音色由 voice 字段控制；若你传了 voice=zhiyan 却听到女声，大概率是拼写错误（正确应为 zhiyan 还是 zhiyan_emo？查官方文档）。常见错误：

• 参数名写错：比如把 voice 写成 voice_id 或 speaker
• 音色 code 不存在：如传 voice=xiaoguang，但阿里云当前不提供该音色
• 未刷新 AccessKey 或 Signature：参数改了但签名没重算，API 返回 403 或默认音色
• 请求体格式错误：JSON 请求中 voice 没放在 audio 对象里（阿里云要求嵌套在 config 下）

{
  "text": "今天天气不错",
  "config": {
    "voice": "xiaoyun",
    "format": "mp3",
    "sample_rate": 16000
  }
}

如何验证音色是否生效

不要只看 HTTP 状态码 200 —— 它只表示请求被接收，不代表音色已切换。必须：

立即学习“PHP免费学习笔记（深入）”；

• 下载返回的音频文件，本地播放确认人声性别/语调/口音是否符合预期
• 对比不同 voice 值生成的音频时长和文件大小（同一文本下，不同音色可能有微小差异）
• 查看响应头或响应体中的调试字段（如阿里云返回 X-Voice-Used header，腾讯云返回 voice_type 字段）
• 在服务商控制台「语音合成调试」页面手动测试相同参数，排除 PHP 侧编码问题

注意 SDK 版本与音色兼容性

旧版 SDK（如阿里云 aliyun-openapi-php-sdk v1.x）可能不支持新上线的音色（如 2025 年新增的 siyue），即使你在请求里写了也自动降级为默认音色。解决方法：

• 升级到最新版 SDK（如阿里云推荐用 alibabacloud/pop-core + alibabacloud/alisydney-20190729）
• 绕过 SDK，手写 curl 请求，确保参数透传无损
• 检查服务商文档的「音色列表更新时间」，确认你要用的音色已全量开放

音色不是 PHP 的配置项，它藏在每次请求的 payload 里；漏掉一个下划线、少一个 header、签名过期，都会让切换失效——最稳妥的方式是先用 Postman 调通，再把 working request 复制进 PHP。