身份证OCR识别API正反面信息提取
问题一：你们的身份证OCR识别API支持哪些证件类型？是否涵盖新版和旧版身份证？
我们的API服务全面覆盖中华人民共和国居民身份证的正反面信息提取。无论是早期签发的15位号码旧版身份证，还是目前通用的18位号码新版身份证，均能精准识别。此外，对于身份证在自然光、室内光等常见光照条件下形成的影像，以及因卡片弯曲、塑封造成的轻微形变，我们的识别引擎都具备良好的兼容性。在接入前，建议您通过我们提供的测试工具，上传不同类型、版本的样本图片进行实际验证，以确保其完全符合您的业务场景需求。
问题二：识别精度如何保证？对于照片模糊、有反光或倾斜拍摄的身份证图片怎么办？
识别精度是OCR服务的核心。我们通过采用深度神经网络与海量真实场景训练数据相结合的方式，使模型对图像质量不佳的情况具备强大的鲁棒性。具体解决方案如下：
1. 预处理增强：建议您在调用API前，先对用户上传的图片进行基础预处理。例如，利用开源库进行简单的亮度、对比度调整，或轻微的锐化处理，这能显著提升后续识别成功率。
2. 清晰度引导：在您的产品前端，明确提示用户“确保身份证边框完整、文字清晰、避免强光反光”。一个简单的提示可以极大地降低低质量图片的上传比例。
3. 分段识别与校验：我们的API在提取关键字段（如身份证号码、姓名）后，会内置逻辑校验规则（如校验码验证、地址合理性判断），对识别结果进行交叉验证，从而自动修正部分识别误差。
4. 人工复核兜底：对于金融、政务等超高精度要求的场景，我们建议将API识别结果与人工复核流程相结合。当系统置信度低于您设定的阈值时，自动流转至人工后台进行审核，形成“机审+人审”的双重保障。
问题三：提取身份证正反面具体能返回哪些结构化字段？
对于身份证正面（人像面），API返回的结构化数据通常包括：姓名、性别、民族、出生日期、住址（完整的行政区划及详细地址）、公民身份号码。对于身份证背面（国徽面），返回的关键信息是：签发机关、有效期限（包括起始日期与截止日期）。所有日期字段均会标准化为YYYY-MM-DD格式，便于您直接存入数据库或进行后续计算。此外，API还会返回识别出的证件整体位置坐标，便于您进行视觉标注或其他处理。
问题四：API的调用流程和接入步骤是怎样的？技术小白能否快速上手？
我们的设计理念就是简化接入流程，即使是非技术人员也能参照文档快速完成测试。实操步骤如下：
步骤一：注册与获取密钥。前往开发者中心注册账号，创建应用后即可获得唯一的API Key和Secret。
步骤二：阅读接口文档。重点查看“身份证识别”接口的请求URL、支持格式（通常为JPG/PNG）、HTTP方法（一般为POST）以及最重要的请求参数与返回字段说明。
步骤三：发起API调用。您可以使用任何熟悉的编程语言（如Python、Java、PHP）或工具（如Postman）发起请求。核心是将身份证图片文件（或图片的Base64编码）与您的API密钥一同通过multipart/form-data方式提交至指定端点。
步骤四：解析返回结果。API会返回一个JSON格式的响应，其中包含“code”（状态码）、“msg”（消息）和核心的“data”字段（即结构化识别结果）。您只需解析这个JSON，提取所需数据即可。
问题五：如何处理用户隐私和数据安全问题？图片数据会被保存吗？
数据安全与隐私保护是我们服务的首要前提。我们采取多重措施保障安全：
1. 传输加密：所有API请求均要求通过HTTPS协议进行，确保传输过程中数据不被窃取。
2. 瞬时处理：我们的服务器在处理完您的识别请求、生成并返回结果后，通常会在设定的极短时间内（如24小时内）自动删除您上传的原始图像文件，不会用于任何其他目的或长期存储。
3. 隐私协议：我们提供明确的数据处理协议，承诺不会对您的用户数据进行分享、转售或用于任何模型训练（除非获得您的明确授权）。
4. 建议措施：从您的业务侧，我们强烈建议在客户端完成识别后，立即删除服务器上的原始图片缓存，仅存储必要的结构化文本结果，并将此写入您的隐私政策告知用户，以建立信任。
问题六：识别速度如何？是否支持高并发场景下的稳定调用？
单次识别请求的响应时间通常在1秒以内，这确保了终端用户的操作流畅性。对于高并发场景（如节假日活动、批量上传处理），我们建议您采取以下策略以保证稳定性：
1. 服务分级：了解我们提供的不同服务等级协议（SLA），根据业务重要性选择相应套餐，高级别套餐享有更高的并发配额和稳定性保障。
2. 异步与队列：不要在前端页面同步等待识别结果。对于非实时场景，可采用“上传图片->返回任务ID->后端异步处理->通过回调或轮询获取结果”的模式，避免请求阻塞。
3. 客户端限流：在您的应用端实现简单的请求队列或延迟重试机制，避免在瞬间爆发式地发送大量请求，以平滑访问压力。
4. 监控与告警：接入我们的服务状态监控，并设置您自身的接口调用成功率、延迟告警，以便在出现波动时及时介入。
问题七：返回的地址信息是完整的一个字段，如何拆分成省、市、区、详细地址？
API默认返回的是证件上印刷的完整住址字符串。若您需要将其拆解为独立的行政区划单元，您可以在收到结果后，在后端进行“二次智能解析”。具体方法是：
1. 建立地址词库：维护或接入一个最新的全国行政区划数据库（精确到县区级）。
2. 模糊匹配算法：将返回的完整地址字符串，与您的行政区划库进行最长前缀匹配或正则表达式匹配。通常顺序为“省->市->区/县”，剩余部分即为详细地址。
3. 使用第三方库：市面上已有成熟的地址解析开源组件或商业服务，您可以直接集成，它们能处理更复杂的地址表述和新旧名称变更问题。这步操作由您的业务服务器完成，不依赖于OCR API本身。
问题八：如果识别失败或字段有误，最常见的排查步骤是什么？
遇到识别问题，请按以下步骤有序排查：
1. 检查图片质量：这是最常见的原因。请确认图片是否过度模糊、有遮挡、光线过暗或过曝、倾斜角度过大。
2. 验证API请求：检查您的请求格式是否正确，特别是图片文件是否成功上传，API密钥是否有权限且未过期，网络连接是否正常。
3. 分析错误代码：仔细阅读API返回的“code”和“msg”字段。常见的错误码如“参数错误”、“图片解码失败”、“配额不足”等，消息会给出明确指引。
4. 提交工单复现：如果以上均无问题，请将出错的图片样本（请脱敏处理）、您的请求时间、Request ID（如有）一并提交给技术支持。我们能根据具体样本分析模型识别瓶颈，并持续优化。
问题九：除了标准API调用，是否提供SDK或离线部署方案？
为满足多样化的部署需求，我们提供以下方案：
1. 云端API：即开即用，免维护，适合绝大多数SaaS、Web及移动应用。
2. 多种语言SDK：我们提供了Java、Python、C++、PHP等主流语言的SDK包，封装了复杂的网络请求和身份验证逻辑，让您只需几行代码即可完成集成，大幅降低开发成本。
3. 私有化离线部署：对于数据敏感、网络隔离或要求完全内网环境的客户（如政府机关、部分金融机构），我们提供将识别引擎部署在您本地服务器的解决方案。您需要联系我们商务团队，根据您的服务器配置和预计QPS进行定制化报价和部署实施。
问题十：收费标准如何？有没有免费的额度用于测试和开发？
我们采用灵活透明的按量计费模式，通常按照成功识别次数计费。为了帮助您无缝体验和测试，我们为每位注册开发者提供了免费的调用额度包，足够完成产品开发阶段的集成测试与评估。在正式上线前，请务必根据您的业务量预估，在管理后台选购合适的套餐包或开通后付费模式。所有价格详情和计费逻辑均可在官网“价格”页面清晰查阅，过程中不会产生任何隐性费用。我们建议您在开发初期就关注控制台的调用量统计，以便合理规划预算。