身份证识别

识别身份证正反面全部字段，正面包括姓名、性别、民族、出生日期、住址，反面包括签发机关、有效期限。支持自动判断正反面，识别速度快、准确率高

调用单价

¥0.0250

QPS限制

响应时间

<500ms

接口说明

识别身份证正反面全部字段，正面包括姓名、性别、民族、出生日期、住址，反面包括签发机关、有效期限。支持自动判断正反面，识别速度快、准确率高。

平台提供稳定可靠的身份证识别服务，支持高并发调用，返回JSON格式数据。接口采用RESTful风格设计，接入简单，响应迅速，适用于各类业务场景的快速集成。

适用场景

🔐 实名认证：快速核验用户身份信息

🏦 金融开户：银行/证券开户身份信息录入

🏨 酒店入住：旅客身份信息自动登记

📦 物流寄件：寄件人身份信息快速采集

请求参数

参数名	类型	必填	说明
api_key	string	是	用户的API密钥，在个人中心获取
api	string	是	接口标识，本接口为 `ocr.idcard`
image	string	是	图片Base64编码字符串
text	string	否	文本内容（文本类接口需要）

返回参数

参数名	类型	说明
code	int	状态码，200表示成功
message	string	状态描述
data	object	业务数据
cost	string	本次调用费用
balance	string	调用后账户余额

请求示例（PHP）

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, '/index.php?c=ApiGateway&a=call');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'api_key' => 'your_api_key',
    'api' => 'ocr.idcard',
    'image' => base64_encode(file_get_contents('test.jpg'))
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;

返回示例

{
    "code": 200,
    "message": "success",
    "data": {
        "words_result": [
            {"words": "识别结果第一行"},
            {"words": "识别结果第二行"}
        ]
    },
    "cost": "0.03",
    "balance": "99.97"
}

错误码说明

错误码	说明	处理建议
400	请求参数错误	检查必填参数是否完整
401	API Key无效	检查密钥是否正确
402	余额不足	请先充值
404	接口不存在	检查api参数
500	服务器错误	稍后重试