Agent Skills
返回列表
腾讯云身份证识别

腾讯云身份证识别

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @tencent-adm/tencentcloud-ocr-idcard。

技能介绍

问题场景

当业务需要从身份证图片中提取姓名、证件号、有效期等字段，同时需要判断复印件、翻拍、PS、临时身份证等风险时，单独处理图像、OCR 和告警逻辑容易重复。@tencent-adm/tencentcloud-ocr-idcard 面向这类开发场景，调用腾讯云 OCR 身份证识别接口，把识别、裁剪和告警检测集中在一个技能中。

工作方式

该技能通过 scripts/main.py 封装请求，支持两种图片输入：ImageBase64 与 ImageUrl。调用时可指定 CardSide 为 FRONT 或 BACK，不填则自动判断。核心能力包括：

  • 人像面：姓名、性别、民族、出生日期、住址、公民身份证号
  • 国徽面：签发机关、证件有效期
  • 附加处理：身份证照片或人像照片裁剪
  • 风险告警：复印件、翻拍、PS、临时身份证、反光、有效期异常等

请求参数中的 Config 是 JSON 字符串，用于开启告警与处理开关；CardWarnType 可切换 Basic 或 Advanced 告警算法等级。若需要返回 WarnInfos，必须在 Config 中显式开启至少一个告警项。

边界与注意点

该技能依赖腾讯云 API 密钥，需要配置 TENCENTCLOUD_SECRET_ID 与 TENCENTCLOUD_SECRET_KEY。图片输入有大小限制，Base64 不超过 10MB。告警检测不是默认全开，用户提到“检测 PS”“检测翻拍”等需求时，应主动确认是否开启相应 Config 开关。输出以 JSON 返回，适合接入表单预填、身份材料审核辅助流程，但不应仅凭告警码替代完整合规审核。

使用场景

  • 用户提交身份证照片后，在入会审核接口中提取姓名、证件号和有效期，减少人工录入。
  • 对上传的证件图片做复印件、翻拍或 PS 检测，返回告警码供审核流程判断风险。
  • 批量处理身份证材料时，自动裁剪证件照片或人像照片，便于后续存储与展示。
  • 根据图片 URL 或 Base64 调用识别接口，在内部系统中预填表单字段。

适合人员

  • 接入入会审核的后端工程师，需要从身份证图片自动提取字段并写入业务表单。
  • 负责证照风险检测的风控工程师，需要判断复印件、翻拍、PS 和临时身份证等告警。
  • 处理批量证件材料的 Python 开发者，需要调用腾讯云 OCR 并整理返回的 JSON 结果。
  • 搭建材料预审流程的产品工程师，需要把识别结果用于表单预填和风险标记。