身份证OCR
识别服务 SLA 99.95%累计调用 0 次
身份证OCR识别，正反面识别并提取字段。
识别身份证正反面，自动提取姓名、性别、民族、出生日期、住址、身份证号、签发机关等信息。
收费标准
按量计费
¥0.1000/次
每次调用扣费
QPS 限制
50
每秒最大并发
响应时间
10s
超时上限
对接文档
Request Description · 请求说明
请求方式 POST，参数 image 为身份证图片URL或Base64，side 为正/反面(front/back)。
Endpoint · 接口地址
Request Params · 请求参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |
|---|---|---|---|---|---|
| appkey | string | 必填 | - | 用户API密钥 | ak_xxx |
| num | string | 必填 | - | 快递单号 | SF12345678 |
| callback_url | string | 必填 | - | 回调地址 | https://your.com/cb |
Request Example · 请求示例
curl -X POST https://api.cli.cc/v1/idcard/ocr -H "Content-Type: application/json" -d '{"appkey":"ak_xxx","image":"https://example.com/idcard.jpg","side":"front"}'Response Fields · 响应字段说明
{"code":"业务码","msg":"提示","data":{"name":"姓名","sex":"性别","nation":"民族","birthday":"生日","address":"住址","id_card":"身份证号"}}
Response Example · 响应示例
{"code":0,"msg":"ok","data":{"name":"张三","sex":"男","nation":"汉","birthday":"1990-01-01","address":"广东省深圳市福田区","id_card":"440301199001011234"}}Error Codes · 错误码说明
| 错误码 | 说明 |
|---|---|
| 0 | 成功 |
| 20001 | 参数错误 |
| 20017 | 未识别到身份证 |