身份证识别

API

上传身份证正面或反面图片（URL 或 base64），自动识别并结构化返回姓名、身份证号、性别、民族、出生日期、地址、签发机关、有效期等 10 个字段。支持正反面自动判断，适用于实名认证、用户信息录入、KYC 核验辅助等场景。需要登录后使用，保护用户隐私。

接入文档

由极数本源提供·更新于 4 天前

先试用，再接接口

不用写代码。打开工具页跑一遍身份证识别，看清结果再来订阅。

打开身份证识别

累计调用

1824ms

平均响应

100.00%

服务可用性

20 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案升级套餐

QPS 2

今日已用 … / 20 次/日…

登录并携带 API Key 可使用上方免费额度；会员额度见下方各档

无 Key 调用

无匿名额度 · 需 API Key

登录免费

当前方案

每日 20 次 · QPS 2

黄金会员

每日 50,000 次 · QPS 10

企业会员

会员免费不限次（未配置日上限）

AI 文档

把这个地址发给 AI，就能生成调用代码

https://apizero.cn/aidocs/ocr-idcard/raw.md

打开文档

接入文档

打开

在线工具

打开身份证识别

接口请求地址

https://v1.apizero.cn/api/ocr-idcard

接口请求方式

POST

请求参数格式

APPLICATION/JSON

接口返回格式

APPLICATION/JSON

接口请求示例

https://v1.apizero.cn/api/ocr-idcard

接口信息备注

需要 API Key（Authorization: Bearer <key>）。登录用户每日 20 次免费，不支持匿名调用。

请求参数说明

名称	类型	说明
input_type	string	必填 · 图片传入方式 · 默认 url · 示例：url
input_data	string	必填 · 图片 URL 或 base64 编码字符串（jpg/png，base64 最大 10 MB） · 示例：https://example.com/idcard-front.jpg

请求头说明

名称	类型	说明
Authorization	string	可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。
Content-Type	string	必填 · 请求体格式

返回字段说明

名称	类型	说明
side	number\|null	正反面：1=正面（姓名页），0=反面（国徽页）
identity_name	string\|null	姓名
identity_code	string\|null	身份证号码（18 位）
gender	string\|null	性别
race	string\|null	民族
birth	string\|null	出生日期
address	string\|null	住址
issued_by	string\|null	签发机关（反面有效）
valid_date_start	string\|null	有效期起始（反面有效）
valid_date_end	string\|null	有效期截止（反面有效，长期则为"长期"）
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "side": 1,
    "identity_name": "张三",
    "identity_code": "310101199001011234",
    "gender": "男",
    "race": "汉",
    "birth": "1990-01-01",
    "address": "上海市浦东新区某某路123号",
    "issued_by": null,
    "valid_date_start": null,
    "valid_date_end": null
  },
  "request_id": "req_abc123",
  "tips": "极数本源 · https://apizero.cn"
}

加载接口文档…

名称

类型

说明

input_type

string

必填 · 图片传入方式 · 默认 url · 示例：url

input_data

string

必填 · 图片 URL 或 base64 编码字符串（jpg/png，base64 最大 10 MB） · 示例：https://example.com/idcard-front.jpg

名称

类型

说明

Authorization

string

可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

Content-Type

string

必填 · 请求体格式

名称

类型

说明

side

number|null

正反面：1=正面（姓名页），0=反面（国徽页）

identity_name

string|null

姓名

identity_code

string|null

身份证号码（18 位）

gender

string|null

性别

race

string|null

民族

birth

string|null

出生日期

address

string|null

住址

issued_by

string|null

签发机关（反面有效）

valid_date_start

string|null

有效期起始（反面有效）

valid_date_end

string|null

有效期截止（反面有效，长期则为"长期"）

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{ "code": 0, "msg": "成功", "data": { "side": 1, "identity_name": "张三", "identity_code": "310101199001011234", "gender": "男", "race": "汉", "birth": "1990-01-01", "address": "上海市浦东新区某某路123号", "issued_by": null, "valid_date_start": null, "valid_date_end": null }, "request_id": "req_abc123", "tips": "极数本源 · https://apizero.cn" }