如何在 PHP 中实现简单的人脸识别接口_调用百度或阿里 AI 云服务

直接调用百度或阿里云人脸识别API需处理鉴权、图片编码、HTTP请求及错误响应；百度需用client_id/client_secret换取access_token并缓存2500秒，阿里云须用AccessKey按RFC3986签名；传图需Base64编码且设对image_type，大图限2MB；阿里云CompareFace返回success=false多因图片URL不可达、格式不符或非正脸。

直接调用百度或阿里云的人脸识别 API 是可行的，但“简单”不等于“零配置”——你必须处理鉴权、图片编码、HTTP 请求结构和错误响应，漏掉任一环都会返回 invalid_request 或 access_token invalid 这类模糊错误。

怎么拿到有效的 access_token（百度）或 access_key（阿里）

百度 AI 开放平台不支持用固定密钥直连，每次请求前必须先用 client_id 和 client_secret 换取临时 access_token；这个 token 有效期只有 30 天，但官方 SDK 默认缓存 5 分钟，实际建议自己加 Redis 缓存并设 TTL 为 2500 秒，避免高频刷新触发限流。

阿里云则用 AccessKeyID + AccessKeySecret 签名，必须按 RFC 3986 对参数排序+编码，手写容易出错。强烈建议用官方 aliyun-openapi-php-sdk，否则连 Authorization 头都拼不对，返回 InvalidSignature。

• 百度：https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET
• 阿里：不要硬编码签名逻辑，AlibabaCloud\Tea\Exception\TeaError 报错时大概率是 timestamp 或 signature base string 生成错了

PHP 怎么传图给百度人脸检测接口（/rest/2.0/face/v3/detect）

百度要求图片必须 Base64 编码后作为 image 字段提交，且 image_type 必须是 BASE64、URL 或 FACE_TOKEN 三者之一——填错任意一个就会返回 pic not exists，哪怕图片明明存在。

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

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

注意：file_get_contents() 读二进制文件后要 base64_encode()，别忘了 trim() 掉换行符；如果图来自表单上传，直接用 $_FILES[photo][tmp_name] 读取，别用 $_POST[image] 去接 Base64 字符串（前端没做 encode 就传，后端 decode 会失败）。

• 必须带 Content-Type: application/json 请求头
• access_token 要拼在 URL 后： https://aip.baidubce.com/rest/2.0/face/v3/detect?access_token=xxx
• 大图（>4MB）会返回 image size error，PHP 默认 post_max_size 是 8M，但百度实际限制更严，建议前端压缩到 2MB 内再传

阿里云人脸比对（CompareFace）返回 success=false 怎么排查

阿里云的 CompareFace 接口返回 success=false 时不报具体原因，只给 data.similarity 为 null —— 这通常不是算法问题，而是输入不合规。

最常见三个坑：ImageURL 必须是公网可访问的 HTTPS 地址（不能是本地路径或内网地址）；两张图必须都是人脸正脸、无遮挡、分辨率 ≥ 100×100；若用 ImageObject 方式传图，Body 必须是原始二进制流，不能是 Base64 字符串（这点和百度相反）。

• 测试时先用两个已知清晰的证件照 URL，排除图片质量干扰
• 用 curl -v 抓包看响应 header 是否含 x-acs-request-id，没有说明请求根本没进阿里云网关
• 如果返回 InvalidParameter.ImageNotReadable，大概率是图片格式不被支持（阿里云不支持 WebP，只认 JPG/PNG/BMP）

真正卡住人的从来不是“怎么调通”，而是 token 过期没刷新、图片编码方式和文档写得不一致、或者错误码对应的实际原因藏在文档犄角旮旯里。留心 response body 里的 error_msg 和 log_id，比反复改代码有用得多。