PHP如何调用旷视FaceAI_传图片数据识别人脸属性信息【指引】-php教程-PHP中文网

旷视 FaceAI API 要求 image 字段为无前缀的 Base64 字符串，Content-Type 必须为 application/json，且 Authorization 签名需严格按 secret_key+time_stamp+nonce_str+md5(http_body) SHA256 生成。

php如何调用旷视faceai_传图片数据识别人脸属性信息【指引】

旷视 FaceAI API 要求 base64 图片数据，不是文件路径或二进制流

旷视 FaceAI 的 detect 或 analyze 接口（如 https://api.megvii.com/face/v3/detect）只接受 image 字段为图片的 Base64 编码字符串，且必须去掉 Data URL 前缀（如 data:image/jpeg;base64,）。传 fopen 句柄、file_get_contents 未编码的原始字节、或者本地路径（如 /tmp/photo.jpg）都会返回 {"error_message":"invalid argument","error_code":100001}。

实操建议：

用 file_get_contents($path) 读取图片二进制内容，再用 base64_encode() 编码
务必检查图片是否真实存在、有读取权限，且大小不超过接口限制（通常 ≤ 5MB）
若从 HTTP 请求中接收上传文件，应使用 $_FILES['image']['tmp_name'] 而非 $_FILES['image']['name']

PHP cURL 调用需设置 Content-Type 为 application/json 并正确构造 JSON body

旷视 API 不支持 multipart/form-data，必须用 application/json 格式提交。常见错误是直接 json_encode($_POST) 或漏掉 Content-Type 头，导致返回 {"error_message":"invalid content type","error_code":100002}。

实操建议：

curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']) 必须显式设置
image 字段值是纯 Base64 字符串（不含前缀），image_type 必须匹配实际格式（"jpg"、"png" 或 "bmp"）
request_id 非必需，但建议生成唯一值便于排查（如 uniqid('face_')）

{
    "image": "base64_encoded_string_here",
    "image_type": "jpg",
    "face_attributes": ["gender", "age", "emotion", "race"]
}

签名（signature）生成依赖 secret_key + time_stamp + nonce_str + http_body，缺一不可

旷视要求所有请求带 Authorization 头，格式为 FACE ai_api_key:，其中 signature 是对 secret_key + time_stamp + nonce_str + md5(http_body) 做 SHA256 得到的十六进制小写字符串。漏掉 md5() 或时间戳偏差 > 300 秒都会返回 401 Unauthorized。

JSON Toolkit

JSON文件多功能工具。支持格式化、验证、压缩、键排序及点记法路径查询。零依赖。

下载

实操建议：

time_stamp 用 time()，不要用 date('U') 或字符串拼接
nonce_str 用 bin2hex(random_bytes(16))（PHP 7+），避免时间碰撞
http_body 必须是未格式化的紧凑 JSON 字符串（无空格、换行），且与发送内容完全一致

返回结果中的 face_list 是数组，属性在 face_list[0].attributes 下，不是顶层字段

调用成功后响应体是 JSON，但人脸属性（如 gender、age）不在根节点，而嵌套在 face_list 数组第一个元素的 attributes 对象里。直接 $res->gender 会报错或返回 null。

实操建议：

先检查 isset($res->faces) && count($res->faces) > 0，再取 $res->faces[0]->attributes
emotion 返回的是对象（含 type 和 probability），不是字符串；race 同理，含 type（如 "asian"）和置信度
注意 PHP json_decode($json, true) 会转成数组，用 -> 访问会失败；统一用对象模式或明确判断类型