在构建智能门禁或考勤系统时，技术团队常面临一个抉择：直接调用云端免费人脸API，还是集成离线人脸识别API、SDK？两者的核心差异在于人脸检测与人脸分析的算力分配。云端API适合验证原型，但受限于网络延迟与QPS配额；本地SDK前期接入成本高，却能在200ms内完成1:N比对。

核心参数对比：从检测到特征提取

以南宁先创科技实测数据为例，某开源免费人脸API在正面无遮挡下检出率约98.2%，但侧脸30°时骤降至74%。而商用级SDK通过人脸分析算法优化，同场景下仍能维持93%的召回率。若项目涉及活体检测，需关注SDK是否支持RGB单目或IR双目。

• 检测速度：API平均往返120-400ms；SDK本地推理约15-50ms
• 特征维度：主流人脸识别API、SDK输出512维或128维向量
• 并发上限：免费API通常限2QPS，SDK取决于CPU/GPU

接入步骤与避坑要点

接入免费人脸API时，先用Postman测试Base64图片流是否触发尺寸限制（多数要求<2MB）。若选用本地人脸识别API、SDK，注意模型文件需与运行时库版本对齐，否则会出现libonnxruntime符号缺失错误。

关键注意：人脸检测返回的bbox坐标需做归一化处理，否则不同分辨率下绘制框会偏移。另外，人脸分析中的年龄/性别属性仅建议用于统计场景，不可作为身份核验依据。

常见问题

Q：免费人脸API能商用吗？
多数免费层禁止商用或限制调用量，需仔细阅读条款。建议先用免费API验证业务流程，再切换至付费SDK。

Q：SDK在ARM盒子上的帧率如何？
瑞芯微RK3588实测：640×480分辨率下，人脸检测可达45fps，同时跑人脸分析会降至22fps。

选型没有绝对优劣——日调用量低于5000次且网络稳定，免费人脸API是低成本起点；若追求毫秒级响应与数据隐私，本地人脸识别API、SDK才是长期方案。建议用同一批测试集分别跑通两条链路，用误识率与通过率数据做最终决策。