# Face Service — 人脸识别服务

## 概述

基于 InsightFace (buffalo_l) 的人脸检测与识别服务，部署于 GPU 服务器，提供人脸检测、特征提取、1:1 比对、1:N 识别 API。

## 模型

- InsightFace buffalo_l (检测 + 识别)
- 检测尺寸: 640×640
- 特征维度: 512

## API

| 端点 | 方法 | 说明 |
|------|------|------|
| /api/status | GET | 服务状态和模型信息 |
| /api/detect | POST | 人脸检测 (返回 bbox + 关键点) |
| /api/recognize | POST | 人脸识别 (返回特征向量 + 匹配身份) |
| /api/compare | POST | 1:1 比对 (两张人脸 → 相似度) |
| /api/face-detect | POST | 别名: 同 /api/detect |
| /api/face-recognize | POST | 别名: 同 /api/recognize |
| /api/face-compare | POST | 别名: 同 /api/compare |

## 部署

```bash
cd /data/ymq/face-service
bash build.sh
sudo systemctl restart face-service
```

## 端口

9091