AIAPIZZ

人脸实名核验

GET/POST 按次计费

姓名、身份证号与人脸照片三项比对，返回比对分值与核验结果。

调用地址 http://api.aiapizz.com/api/v4/facehy
当前单价 ¥0.20 / 次，未登录按默认分组。价格分组与会员权益在详情页一起看。
价格分组与详情

认证

请求头带 X-App-Id 与 X-App-Key；来源 IP 必须已经在密钥白名单里。每次成功调用按会员价扣费，上游失败自动退回。

请求头
X-App-Id: 你的 AppID
X-App-Key: 你的 AppKey

也可以放在地址参数里（appid / appkey），方便临时调试。AppKey 在创建时只显示一次。公共请求格式与错误码见 开发文档。

请求参数

参数类型必填说明
namestring必填姓名，与身份证上一致。
idcardstring必填18 位身份证号，末位可以是 X。
file_urlstring必填人脸照片地址，需第三方能直接访问，图片不超过 2MB。

返回参数

下面是 data 里面的字段，外面还包着 code / msg / data / trace / cost / balance。

字段类型说明
scoreint比对分值，0 到 100，越高越像。
verifyint核验结果：1 一致，0 不一致。
messagestring结果说明。

错误码

code说明
400name、idcard 或 file_url 缺失或格式不对
402余额不足（含信用额度）
403来源 IP 不在白名单
502上游服务暂不可用，本次不扣费
503接口暂不可用或尚未定价

其余错误码见 公共说明。

调用示例

把 AppID、AppKey 换成自己的，参数换成真实值。

cURL
curl -X POST 'http://api.aiapizz.com/api/v4/facehy' \
  -H 'X-App-Id: 你的AppID' \
  -H 'X-App-Key: 你的AppKey' \
  --data-urlencode 'name=张三' \
  --data-urlencode 'idcard=110101199001011234' \
  --data-urlencode 'file_url=https://example.com/face.jpg'
PHP
<?php
$ch = curl_init('http://api.aiapizz.com/api/v4/facehy');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'X-App-Id: 你的AppID',
        'X-App-Key: 你的AppKey',
    ],
    CURLOPT_POSTFIELDS => http_build_query([
            'name' => '张三',
            'idcard' => '110101199001011234',
            'file_url' => 'https://example.com/face.jpg',
    ]),
]);
$raw = curl_exec($ch);
curl_close($ch);
$res = json_decode($raw, true);
if (($res['code'] ?? 0) === 200) {
    print_r($res['data']);
} else {
    echo $res['msg'];
}