01
牛脸检测
在画面中定位牛脸区域，支持多牛同检与部分遮挡。
牛脸识别 · 输出唯一牛 ID 与相似度
每头牛，一张
可核验的数字身份证
拍摄牛只正脸照片，输出唯一牛 ID 与相似度判定结论；结果经 REST 接口返回，可对接保单核验、押品盘点与养殖档案系统。
Built for
curl · 04 步
30 秒跑通
- 01
读在线文档
统一 API 文档（www.niujinjin.com/api）与字段级接口页（api.face.niujinjin.com/docs）均公开可读，先看鉴权、点数口径与字段。
- 02
自助创建 API Key
在开放平台控制台（user.niujinjin.com）用手机号自助注册并创建 API Key，无需等待开通。
- 03
首调 register
写入一张正面牛脸，建立档案并返回唯一牛 ID。
- 04
联调 recognize
接入活体与识别接口，在测试集上核对相似度分布后切换生产。
curl · 注册 + 识别
# 1) 注册牛只身份（multipart：写入牛只档案）
curl -X POST https://api.face.niujinjin.com/api/v1/recognition/register \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-F "file=@cow_facing.jpg" \
-F "cowId=CN-2026-0001" \
-F "farmId=farm_wh_001"
# 2) 识别 / 认证（JSON，photoUrl）
curl -X POST https://api.face.niujinjin.com/api/v1/recognition/recognize \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{ "photoUrl": "https://api.face.niujinjin.com/uploads/xxx/cow_facing.jpg" }'
# => { "code": 0, "isMatch": true, "cowId": "CN-2026-0001", "similarity": 0.83 }返回体为 JSON · 相似度按阈值判定 · 阈值可按业务调整
能力清单
每项能力均标注它在身份核验流程中的位置。
02
特征提取
为每头牛建立唯一身份标识，支持库内比对与身份核验。
03
活体检测
判断采集对象是否为真实活体，拦截照片打印、屏幕翻拍与面具类欺骗尝试。
04
身份绑定
唯一牛 ID 关联档案、保单、抵押信息，全生命周期管理。
05
体征监测
结合 IoT 设备监测体温、活动量，异常自动告警（可选方案）。
06
API 接入
标准 RESTful API，Java / Python / Go 多语言 SDK。
应用场景
身份核验在放款、承保与交易三类业务环节中承担不同职责。
01
活体抵押
银行 · 融资租赁：放款前确认标的权属，贷后按周期盘点核验存栏，押品记录可审计。
02
保险理赔
财险 · 养殖险：承保验标逐头建档，出险查勘时用牛脸 ID 锁定标的，防止重复索赔。
03
交易核验
活牛交易市场：交易与调运环节核验个体身份，来源可溯，记录按次留痕。
接入之后，得到什么
输出物：唯一牛 ID、相似度与阈值判定、活体检测结论；交付形态：REST API / 独立子站 / 小程序。
THE RESULT
- 唯一牛 ID，取代易丢耳标
- 拒照片/视频/3D 面具假体
- 保单-抵押-档案一次绑定
- RESTful API 即接业务系统
EVALUATION · 评测与方法
不报数字，讲清楚怎么测的
评测方法与已知局限公开可查。标定使用真实农场采集的影像与同期实测称重记录，按统一流程完成验证与迭代。
01 · DATASET
数据集与切分
数据来自真实牧场采集的正面牛脸影像，覆盖不同毛色、年龄与饲养条件；评估数据与标定数据独立切分，避免同一头牛同时出现在两侧。
02 · METRICS
指标定义
- SIMILARITY
- 待识别个体与档案的相似度，用于排序与阈值判定。
- LIVENESS
- 活体检测结论（pass / fail），用于拦截翻拍与面具类欺骗尝试。
- FALSE ACCEPT
- 把不同个体判为同一头的比例，随阈值升高而下降。
- FALSE REJECT
- 把同一个体判为不同头的比例，随阈值升高而上升。
03 · THRESHOLD
阈值权衡
识别结果按相似度阈值判定：阈值调高减少误接受、调低减少误拒绝，可按业务风险偏好调整。
- 识别结果按相似度阈值判定：阈值调高减少误接受、调低减少误拒绝。
- 金融押品、保险理赔等强审计场景建议取较高阈值并保留人工复核。
- 交易核验、出入库盘点等场景可在压降误拒绝的前提下放宽阈值。
- 阈值调整需在测试集上重新核对误接受 / 误拒绝曲线后再上生产。
04 · LIMITATIONS
已知局限
- 同品种、同色系个体之间的区分难度高于跨品种个体；阈值需在误接受与误拒绝之间按业务取舍。
- 极端光照、严重遮挡、镜头污损与运动模糊会显著影响输出质量。
- 跨场比对、跨季节毛色变化与生长带来的面部变化会降低相似度。
- 极端角度（超出 ±45°）与严重遮挡的影像会被直接拒绝而非强行输出。
合规可核，接口即接
COMPLIANCE
数据合规与安全
TLS 1.3 加密传输 + JWT/RBAC 权限 + 多租户隔离，支持私有化部署。
EVALUATION
评测口径公开
评测方法、指标定义、阈值权衡与已知局限在开发者页公开可查。
* 适用边界与局限随产品文档一并说明
常见问题
FAQ
NiuFace 适用于哪些牛品种？
目前覆盖西门塔尔、安格斯、荷斯坦、夏洛莱等常见肉牛与奶牛品种。同品种、同色系个体之间的区分难度高于跨品种个体，阈值需按业务场景调整。
牛脸识别需要什么样的照片？
需要牛只正面面部照片，光线充足、面部无严重遮挡。使用手机或监控摄像头均可，系统会自动定位牛脸区域并完成建档。
如何防止照片和视频欺骗？
内置活体检测，用于拦截照片打印、屏幕翻拍和 3D 面具等欺骗尝试；防御强度可通过阈值调节，代价是误拒率上升，需按业务风险取舍。
数据安全如何保障？
数据采用 TLS 1.3 加密传输、加密存储；支持私有化部署，数据可完全留在您的服务器上。通过 JWT + RBAC 实现多租户数据隔离。
如何接入 NiuFace？
提供标准 RESTful API。文档分两层：统一文档（www.niujinjin.com/api，讲鉴权/点数/示例）与字段级接口页（api.face.niujinjin.com/docs，含 OpenAPI 描述）。联调只需在开放平台控制台自助注册、创建 API Key（X-API-Key），无需等待开通。