本地OCR开放API

纯本地识别 · 数据不出服务器 · 支持通用文字/车牌/身份证/营业执照

使用说明：所有接口需在请求头携带 X-API-Key。完整交互式文档请访问 /docs（Swagger UI），可在线调试。

接口列表

POST /api/v1/ocr/text 通用文字识别

请求参数（三选一）

参数	类型	说明
file	file	图片文件上传
image_base64	string	图片Base64编码
image_url	string	图片网络URL

返回示例

{"code":0,"msg":"success","data":{"text":"识别出的完整文字","lines":[{"text":"第一行","confidence":0.99}],"cost_ms":280},"request_id":"req_xxx"}

POST /api/v1/ocr/plate 车牌识别（号码+颜色）

返回示例

{"code":0,"msg":"success","data":{"plates":[{"plate_no":"京A12345","color":"蓝色","confidence":98.5}],"count":1,"cost_ms":320},"request_id":"req_xxx"}

POST /api/v1/ocr/idcard 身份证识别（自动判断正反面）

返回字段

字段	说明
side	人像面 / 国徽面
name	姓名
gender	性别
nation	民族
birth	出生日期
address	住址
id_number	身份证号
authority	签发机关（国徽面）
valid_period	有效期限（国徽面）

POST /api/v1/ocr/license 营业执照识别

返回字段

字段	说明
credit_code	统一社会信用代码
company_name	企业名称
company_type	类型
legal_person	法定代表人
registered_capital	注册资本
establish_date	成立日期
business_term	营业期限
address	住所
business_scope	经营范围

调用示例（curl）

curl -X POST "https://doc.lxphp.com/api/v1/ocr/plate" \
  -H "X-API-Key: 平台密钥" \
  -F "file=@car.jpg"

调用示例（Python）

import requests
url = "https://doc.lxphp.com/api/v1/ocr/text"
headers = {"X-API-Key": "平台密钥"}
files = {"file": open("test.jpg", "rb")}
resp = requests.post(url, headers=headers, files=files)
print(resp.json())

调用示例（PHP）

 true,
    CURLOPT_HTTPHEADER => ["X-API-Key: 平台密钥"],
    CURLOPT_POSTFIELDS => ["file" => new CURLFile("idcard.jpg")],
    CURLOPT_RETURNTRANSFER => true
]);
$result = curl_exec($ch);
curl_close($ch);
print_r(json_decode($result, true));

错误码说明

code	说明
0	成功
400	请求参数错误（图片格式不对、URL下载失败等）
401	缺少API Key
403	API Key无效
429	请求过于频繁（单IP每分钟60次）
500	服务器内部识别异常