上一篇
广州多卡证智能识别API怎么用？多卡证识别接口怎么接入
广州多卡证智能分类识别 API 是一款基于深度学习与计算机视觉技术的高精度接口服务，该接口能够自动识别用户上传图像中的证件类型（如身份证、驾驶证、行驶证、护照、银行卡等），并针对识别出的具体证件类型，提取关键信息字段，该服务广泛应用于金融开户、实名认证、物流寄件、政务办理等需要高效处理多类证件场景的业务流程中。
核心功能特性
- 多证合一：支持一次性识别多种常见证件，无需针对每种证件单独调用不同接口，降低开发复杂度。
- 高精度提取：采用先进的 OCR 技术，对模糊、倾斜、反光等复杂场景下的证件文字进行高精度还原。
- 结构化输出：返回结果均为标准的 JSON 格式，包含证件类型、置信度及各项关键信息字段，便于直接集成至业务系统。
- 实时响应：接口响应速度快，通常在毫秒级完成识别与返回，满足高并发业务需求。
请求参数说明
调用该 API 时，需通过 HTTP POST 方法发送请求，主要参数如下表所示：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| image | String | 是 | 图片的 Base64 编码字符串，或图片的 URL 地址（视具体服务商配置而定，通常支持 Base64） |
| image_type | String | 是 | 图片格式，如 JPG, PNG, BMP 等 |
| access_token | String | 是 | 用户唯一身份验证凭证，需提前在控制台申请获取 |
| config | Object | 否 | 可选配置项，如 detect_direction（是否检测朝向）等，默认为标准模式 |
返回结果示例
接口成功调用后,将返回 JSON 格式的数据，以下是一个识别结果为“身份证”的典型返回示例：
{ "error_code": 0, "error_msg": "SUCCESS", "log_id": 1234567890, "data": { "card_type": "ID_CARD", "confidence": 0.98, "fields": { "name": "张三", "gender": "男", "nation": "汉", "birth": "1990-01-01", "address": "广州市天河区XX路XX号", "id_number": "440106199001011234" } } }
若识别为其他证件,card_type 字段将变为对应的类型标识（如 DRIVING_LICENSE、PASSPORT 等），且 fields 中的键值对会根据证件类型动态变化。
错误码说明
在调用过程中可能遇到的常见错误码如下表所示：
| 错误码 | 错误信息 | 含义及建议处理方式 |
|---|---|---|
| 0 | SUCCESS | 接口调用成功 |
| 1 | INVALID_PARAM | 参数错误，请检查 access_token 或图片格式是否正确 |
| 2 | IMAGE_ERROR | 图片解析失败，请检查图片是否损坏、格式不支持或 Base64 编码是否正确 |
| 3 | NO_CARD_FOUND | 图片中未检测到证件，请确保图片清晰且证件完整 |
| 4 | AUTH_FAILED | 认证失败，请检查 access_token 是否过期或无效 |
| 5 | SERVER_ERROR | 服务器内部错误，建议稍后重试或联系技术支持 |
注意事项
- 图片质量要求：建议上传分辨率不低于 200dpi 的图片，确保证件边缘清晰、文字无遮挡、无严重反光或阴影。
- 图片大小限制：单张图片大小通常限制在 4MB 以内，具体限制请参考服务商最新文档。
- 隐私合规：请确保在获取用户授权的前提下收集和处理证件信息，严格遵守《个人信息保护法》及相关数据安全法规。
- 频率限制：免费试用账号通常有 QPS（每秒查询率）限制，企业级账号可根据需求申请更高配额。
相关问题与解答
问题 1：如果用户上传的图片中包含多张证件，API 会如何处理？
解答：
当前版本的广州多卡证智能分类识别 API 主要针对单张证件进行识别，如果图片中包含多张证件，接口通常只会识别并返回其中面积最大、最清晰或位于图片中心位置的那一张证件信息，其余证件将被忽略，为了确保识别准确率，建议在业务前端增加预处理逻辑，引导用户每次仅上传一张证件，或在后端对图片进行裁剪，确保每张请求只包含一张完整的证件图像。
问题 2：当识别结果中的置信度（confidence）较低时，业务系统应如何设计容错机制？
解答：
置信度反映了模型对识别结果准确性的评估概率，建议业务系统设置一个置信度阈值（0.85），当返回的置信度低于该阈值时，系统不应直接采信自动识别结果，而应采取以下容错措施：
- 人工复核：将低置信度的图片及识别结果转交给人工客服或审核人员进行二次确认。
- 引导重传：在前端提示用户“识别清晰度不足”，并引导用户重新拍摄或上传更清晰的证件照片。
- 字段校验：结合其他已知信息（如用户手动输入的姓名、身份证号）进行交叉验证，若自动提取字段与手动输入字段不一致且置信度低，则以人工复核结果为准。
