按键精灵如何调用身份证OCR接口做实名录入自动化（带完整脚本代码）

作为应用最广泛的自动化脚本工具之一，按键精灵让许多业务人员通过简单的脚本即可完成自动点击与数据采集。但在涉及证件实名录入时，传统按键精灵只能靠预置的图片字库（类似大漠伪OCR的方式），既依赖已训练库，又无法直接做到高结构化的身份证信息抽离。

借助石榴智能身份证OCR识别系统，按键精灵脚本可以从身份证照片或摄像头直接提取姓名、身份证号、住址、签发机关等完整信息，并实现翻拍检测与人脸头像提取，且完全不需要维护OCR字库。

一、为什么按键精灵离不开身份证OCR API？

身份证OCR API可以从身份证图片中一键提取所有文本字段，完全取代（伪）点阵字库和找图拼数据的做法。在按键精灵中接入身份证OCR之后，可以完成：

游戏/平台实名制认证：自动读取上传的身份证，完成注册认证流程
批量信息采集：批量录入员工证件资料，为OA、财务系统快速建档
政务在线身份自动录入：对接身份数据匹配后台，提升数据录入率

二、按键精灵接入身份证OCR的基本流程

截图或选择图片 ：按键精灵调用SnapShot截取身份证图片并保存为本地文件。
Base64编码：按键精灵本身不带Base64转换脚本，可通过封装JavaScript(Command)，或借助内置网络库将图片读为Base64（也可用拓展插件完成）。
发送HTTP请求 ：调用按键精灵的Url.HttpPost指令向石榴智能身份证OCR地址发送POST请求。
获取结构数据：API返回结构化JSON。
业务落地：将字段写入数据库，或调用后续验证API。

三、石榴智能身份证OCR核心亮点

99.9%+识别准确率：统一结构化输出，误填率可降至零
复印/翻拍检测：识别证件是实体原件，还是复印件或翻拍屏幕
头像提取：返回裁切好的人像Base64，方便换底色/合成等制作证件照
正反面自动判别：一张API接口同时支持人像面和国徽面的识别
自带完整度判断：自动检测缺角、遮挡、反光等问题，返回评分

四、按键精灵完整调用代码示例

以下为按键精灵Android版调用石榴智能身份证OCR API的脚本模板：

按键精灵-电脑版本：

vbscript 复制代码

# ==============================================================================
# API文档完整开发文档和代码示例：https://market.shiliuai.com/doc/id-card-ocr
# 支持免费在线体验
# API文档清晰，提供多种接入语言示例（如python、js、C#、java、php等），以及自动化脚本语言（如天诺、懒人精灵、按键精灵、易语言、EasyClick、触动精灵等）
# ==============================================================================


Import "Encrypt.dll"
VBSBegin
Function Base64Encode(filePath)
    Set inStream = CreateObject("ADODB.Stream")
    inStream.Type = 1
    inStream.Open
    inStream.LoadFromFile filePath
    inStream.Position = 0
    Set dom = CreateObject("MSXML2.DOMDocument")
    Set elem = dom.createElement("tmp")
    elem.dataType = "bin.base64"
    elem.nodeTypedValue = inStream.Read
    Base64Encode = elem.Text
    inStream.Close
End Function

Function ocr_easy(appcode, imgPath)
    url = "https://ocr-api.shiliuai.com/api/id_card_ocr/v2"
    jsonBody = "{""image_base64"":""" & Base64Encode(imgPath) & """}"
    Set http = CreateObject("MSXML2.XMLHTTP")
    http.Open "POST", url, False
    http.setRequestHeader "Authorization", "APPCODE " & appcode
    http.setRequestHeader "Content-Type", "application/json"
    http.send jsonBody
    ocr_easy = http.responseText
End Function
VBSEnd

appcode = "你的APPCODE"
res = ocr_easy(appcode, "你的图片路径.jpg")
TracePrint res

按键精灵-手机版本：

vbscript 复制代码

# ==============================================================================
# API文档完整开发文档和代码示例：https://market.shiliuai.com/doc/id-card-ocr
# 支持免费在线体验
# API文档清晰，提供多种接入语言示例（如python、js、C#、java、php等），以及自动化脚本语言（如天诺、懒人精灵、按键精灵、易语言、EasyClick、触动精灵等）
# ==============================================================================

Import "yd.luae"
Import "zm.luae"

Dim imagePath = "/sdcard/Pictures/test.png"
SnapShotEx imagePath

Function ocr_easy(appcode, imagePath)
    Dim url = "https://ocr-api.shiliuai.com/api/id_card_ocr/v2"
    Dim body = "{""image_base64"":""" & yd.Base64EncodeFile(imagePath) & """}"
    Dim headers = {null}
    headers["Authorization"] = "APPCODE " & appcode
    headers["Content-Type"] = "application/json"
    Dim res = yd.HttpPost(url, body, headers)
    ocr_easy = yd.JsonDecode(res)
End Function

Dim appcode = "你的 APPCODE"
Dim t1 = TickCount()
Dim res = ocr_easy(appcode, imagePath)
Dim t2 = TickCount()
TracePrint res["success"]

支持免费在线体验，API文档清晰，提供多种接入语言示例（如python、js、C#、java、php等），以及自动化脚本语言（如天诺、懒人精灵、按键精灵、易语言、EasyClick、触动精灵等）

API完整文档：https://market.shiliuai.com/doc/id-card-ocr

五、常见问题与解决方法

JSON转义错误 ：按键精灵中手动拼接JSON时，双引号必须转义为""或\"，可以使用插件中的JSON封装库协助拼接。
网络超时 ：建议增加Delay，同时检测网络状态。大图或弱网环境下可适当延长请求超时时间。
返回值解析失败：确保Android版插件支持JSON解析。如果不支持，可以将返回文本传给其他解析函数/JavaScript。

六、总结

通过接入石榴智能身份证OCR API，按键精灵可立刻实现身份证信息的自动化提取和人脸图像返回，全面赋能脚本自动录入、数据采集和实名认证。相比传统"伪OCR"字库，石榴智能身份证OCR省去大量字库训练时间，并支持合规检测与头像返回，更好地保障实人比对合规和精确性。

📌 欢迎访问石榴智能官方市场，免费体验身份证OCR在线工具，获取配套示例代码。所有接入API均赠送免费调用额度，企业和个人开发者均能快速上手。

#按键精灵 #身份证OCR #脚本自动化 #安卓免Root #石榴智能