旷视 FaceAI API 要求 image 字段为无前缀的 Base64 字符串，Content-Type 必须为 application/json，且 Authorization 签名需严格按 secret_key+time_stamp+nonce_str+md5(http_body) SHA256 生成。
旷视 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。
实操建议：
-
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)会转成数组，用->访问会失败；统一用对象模式或明确判断类型
