广州多卡证智能分类识别API调用限制是多少？

调用频率与并发限制

广州多卡证智能分类识别 API 旨在为开发者提供高效、稳定的证件识别服务，但为了防止资源滥用和保障服务稳定性，系统对 API 的调用频率和并发数设有严格限制，通常情况下，标准版用户的单用户并发请求数限制为每秒 10 次（QPS），这意味着在同一秒钟内，系统最多只能处理来自同一 API Key 的 10 个识别请求，若超出此限制，服务器将返回 HTTP 429 Too Many Requests 错误码，提示调用方需降低请求频率，对于高并发场景,建议采用异步队列机制或申请企业版专属的高并发配额。

单次请求数据大小限制

为了确保传输效率和识别准确率，API 对单次请求的数据包大小也有明确规范，上传图片或文件时，单个文件的大小不得超过 10MB，支持的文件格式包括 JPG、JPEG、PNG、BMP 以及 PDF（仅限单页），如果用户上传的文件超过 10MB，或者格式不在支持列表中，接口将直接拒绝处理并返回 HTTP 400 Bad Request 错误，建议开发者在上传前对图片进行压缩处理，确保图片清晰度满足 OCR 识别要求的同时，尽量减小文件体积,以提升响应速度。

每日调用总量配额

除了秒级频率限制外，系统还设定了每日调用总量配额，标准账户的每日免费调用次数为 1000 次，超出部分将按量计费或根据套餐包进行扣除，若用户未购买任何套餐包且免费额度用尽，后续请求将被拦截并返回 HTTP 403 Forbidden 错误，企业级用户可根据业务需求购买更大的月度或年度调用包，以获得更高的每日上限，建议开发者在应用中加入调用计数监控，当接近每日限额时触发预警机制,避免业务中断。

错误码与异常处理机制

在调用过程中，开发者可能会遇到各种异常情况,以下是常见的错误码及其含义：

性能优化建议

为了获得最佳的识别体验和系统稳定性，建议开发者在集成 API 时遵循以下优化策略，使用异步非阻塞 I/O 模型发起 HTTP 请求，避免主线程阻塞，实现本地缓存机制，对于重复识别同一证件的场景，可适当缓存结果以减少不必要的 API 调用，定期监控 API 的响应时间和成功率，若发现延迟增加，可考虑切换至就近的数据中心节点（若支持多区域部署）或联系服务商进行性能调优。

相关问题与解答

如果我的业务高峰期并发量超过每秒 10 次，应该如何解决？

解答： 若标准版的 QPS 限制无法满足业务需求，您可以采取以下措施：一是实施请求队列管理，将突发流量削峰填谷，确保平均请求速率在限制范围内；二是联系广州多卡证智能识别服务的客服或客户经理，申请升级至企业版或购买高并发专属套餐，以获得更高的 QPS 配额（如每秒 50 次或 100 次）；三是优化前端交互,避免用户短时间内重复提交相同证件图片。

识别结果不准确，返回的字段为空或乱码，可能是什么原因导致的？

解答： 识别结果异常通常由以下几个原因引起：检查上传的图片质量，确保证件图像清晰、无严重模糊、反光或遮挡，且文字方向正确（支持 0-360 度旋转识别，但极端角度可能影响精度）；确认图片格式和大小是否符合要求（JPG/PNG/BMP/PDF，<10MB）；检查请求参数中的字段映射是否正确，部分 API 版本可能需要指定特定的识别类型（如身份证、护照、驾驶证等）；若图片质量良好但仍识别失败，可能是服务器端算法对特定版本证件的支持滞后，此时可尝试上传更高分辨率的图片,或联系技术支持提供样本进行模型优化。