01
申请访问
提交联系表单选择「API 接入」，我们开通文档访问与测试 Key（文档站需 JWT 鉴权）。
/contactAPI 接入
Developers · API
把牛脸识别接进你的系统
申请 Key → 下载文档 → 首调 register → 联调 recognize。RESTful API + Java / Python / Go SDK，几步完成接入。
OPENAPI · RESTful
快速接入，四步到位
Quick Start
02
下载文档
在 api.face.niujinjin.com/docs 查看 OpenAPI 描述与鉴权说明，按示例生成签名。
OpenAPI 3.1Bearer
03
首调 register
用 curl 或 SDK 调用 /api/v1/register 写入牛只身份，返回 512 维特征与唯一牛 ID。
POST /register≤3s
04
联调 recognize
接入活体与识别接口，在测试集上核对精度与响应时间，通过后切生产 Key。
POST /recognize≥95% Top-1
API ACCESS
- POST/api/v1/register注册牛只身份（写入 512 维特征）
- POST/api/v1/recognize识别 / 认证（含活体）
- GET/api/v1/cow/:id查询牛只档案
curl · bash
# 申请 Key 后，注册牛只身份
curl -X POST https://face.niujinjin.com/api/v1/register \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"cow_id": "CN-2026-0001",
"farm_id": "farm_wh_001",
"image_url": "https://.../cow_facing.jpg"
}'
# 识别 / 认证
curl -X POST https://face.niujinjin.com/api/v1/recognize \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://.../cow_facing.jpg",
"liveness": true
}'
# => { "code": 0, "cow_id": "CN-2026-0001", "confidence": 0.982, "liveness": "pass" }* 在线文档需先开通 Key（api.face.niujinjin.com/docs 鉴权访问）
多语言 SDK
SDKs
JAVA 8+
J · Java SDK
Spring Boot 兼容，同步/异步客户端，maven 坐标由开通文档提供。
PY 3.9+
P · Python SDK
pip 安装即用，类型标注完整，适合服务端与数据分析脚本。
GO 1.20+
G · Go SDK
并发安全的 http 客户端，低内存占用，适合边缘服务。
开发可信赖
Trust
SECURITY
合规与安全
TLS 1.3 全链路加密，JWT + RBAC 鉴权；文档站需先开通 Key。
PRECISION
精度可核
识别 Top-1 ≥95%、活体 >98%，指标口径见产品规格表。
开发者 FAQ
FAQ
FAQ
如何获得 API Key？
先在联系/报价表单选择「API 接入」提交申请，我们确认业务场景后开通访问权限与测试 Key。
文档站可以直接打开吗？
api.face.niujinjin.com/docs 当前启用鉴权，未开通 Key 的匿名访问会被拒绝；开通后即可正常查看与调试。
支持哪些语言 SDK？
目前提供 Java、Python、Go 三语言 SDK；其余语言可直接使用 RESTful API。
识别与注册是同步还是异步？
register 与 recognize 均为同步 HTTP 接口，单帧响应 <500ms（单帧均值口径）；高吞吐可用 Webhook 接收异步事件。