---
title: "身份证识别接口"
method: POST
path: "/idcard/recognize"
tags: ["OCR"]
---

# 身份证识别接口

`POST /idcard/recognize`

识别身份证图片中的文字信息，支持正反面识别。

## Request body

- object
  - `image` string, required — 支持图片URL或Base64编码图片，支持主流图片格式，如png/jpg/jpeg等
  - `model` string — 支持图片识别的模型，不传默认是免费的glm-4v-flash

## Response `200`

成功响应

- object
  - `name` string — 姓名
  - `sex` '男' | '女' — 性别
  - `nation` string — 民族
  - `birth` string, date — 出生日期
  - `address` string — 住址
  - `id` string — 身份证号码

## Other responses

- `400` — 请求参数错误
- `401` — 未授权
- `413` — 图片过大
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)