不能原生调用,必须走HTTPS请求+签名认证,用curl或file_get_contents发送带X-Sdk-Date和Authorization头的POST请求;华为云无PHP SDK,需手动实现SHA256-HMAC签名,严格遵循UTC时间、小写host、精确content-type等规范。

php怎么调用华为云AI语音合成
直接结论:不能原生调用,必须走 HTTPS 请求 + 签名认证,用 curl 或 file_get_contents 发送带 X-Sdk-Date 和 Authorization 头的 POST 请求。华为云不提供 PHP SDK,官方只维护 Python/Java/Go 等语言的 SDK,PHP 得自己拼签名。
签名生成太容易出错
华为云 API 要求严格的时间戳(UTC 格式)、SHA256-HMAC 签名、拼接规范字符串,少一个空格或换行都会返回 InvalidSignature 错误。很多人卡在这一步,以为是 AK/SK 写错了,其实是 X-Sdk-Date 和签名里用的 date 不一致,或者没转成 UTC。
-
X-Sdk-Date必须是 ISO8601 UTC 时间,例如20240520T081234Z,不能用date('Ymd\THis\Z')—— 它默认本地时区 - 签名密钥需用
hash_hmac('sha256', 'SDK' . $sk, $date, true)逐层计算,不是简单哈希 - 规范请求字符串里,
host必须小写,content-type必须精确为application/json(多空格或大小写错误都失败)
语音合成接口实际请求要点
目标地址是 https://tts.cn-north-4.myhuaweicloud.com/v1/{project_id}/tts,其中 {project_id} 是你在对应区域控制台看到的十六进制 ID,不是账号 ID,也不是 IAM 用户 ID。请求体是 JSON,字段名大小写敏感,比如必须是 text,不是 Text 或 content。
-
text最长支持 300 字符,超长会返回InvalidParameter.text -
voice_name必须从文档列表里选,如zhiyu_emo(中文情感女声),填错返回UnsupportedVoice -
sample_rate推荐用16000,填22050可能被静默降采样,但不报错 - 响应是 base64 编码的
wav数据,别直接 echo,要用base64_decode()后再输出或保存
常见错误现象和绕过方式
最常遇到的是 401 Unauthorized 和 400 Bad Request,前者基本是签名或时间问题,后者大概率是 JSON 字段名/值格式不对。没有「调试模式」,只能靠日志比对规范字符串。
- 用
curl -v抓包看真实请求头,对比华为云签名工具生成的参考值(官网有在线签名调试页) - 先用 Postman 手动构造一次成功请求,再反推 PHP 里哪一步漏了
trim()或strtoupper() - 不要用
json_encode($arr, JSON_UNESCAPED_UNICODE)以外的选项,否则中文会变 \uXXXX,API 不认 - 如果用
file_get_contents,记得设stream_context_create带完整 header,curl更可控
签名逻辑本身不难,但每一步的格式容错率极低;哪怕 X-Sdk-Date 里多了一个空格,或者 host 头写了 TTS.CN-NORTH-4.MYHUAWEICLOUD.COM(大写),都会失败。建议把签名函数单独抽成一个类,每次只改参数,不碰签名核心。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











