加载接口文档…
55
累计调用
1080ms
平均响应
100.00%
服务可用性
20 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
无匿名额度 · 需 API Key
登录免费
当前方案每日 20 次 · QPS 2
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
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"
}