eKYC Suite 身份核验套件

要解决的问题

远程开户、金融面签和合规审查中，工程师常需要让 AI Agent 处理图片或视频，判断是否同一人、是否活体、证件字段是什么、场景是否存在风险。纯文本问答无法处理图像证据，而直接调用 API 又容易在签名、参数正反面、异步查询和错误码解释上出错。eKYC Suite 把这些调用封装成可触发技能：输入是图片或视频，输出是结构化结果，并附带业务可读的解释。

技能如何工作

• 人脸与活体：支持人脸比对、照片活体、视频活体，返回 similarity、riskLevel、riskTag，用于反 deepfake 与反欺诈筛查。
• 证件 OCR：覆盖身份证、银行卡、驾驶证、行驶证，需要明确正反面或正副本，例如身份证 side=0/1、行驶证 side=1/2。
• 图像标签：对图片或视频检测口罩、帽子、多人同框、车内、酒店等标签，每次最多 5 个标签代码。
• 执行方式：调用 scripts/ekyc_api.py 子命令，KYC 与标签分别使用不同鉴权脚本；签名必须保持 40 位大写 SHA1，响应需同时检查顶层与 result 嵌套字段。
• 结果解读：不只返回数字，而是解释分数、风险等级、OCR 字段和标签命中含义。

适用边界

该技能只处理图片或视频文件，不接受姓名、身份证号、手机号等文本 PII；它支持业务判断，但不替代人工审核。正式调用前建议优先使用测试密钥，避免计费。驾驶证 OCR 仅支持正页，视频活体受大小和时长限制，图像标签为异步接口且默认并发较低。