# Face Recognition

> 人脸识别技能，提供人脸注册、人脸搜索、用户信息查询、用户列表获取、删除用户等人脸库管理能力，适用于考勤签到、活动签到等需要人脸身份验证的场景

- Skill: `qq5855144/face-recognition` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add qq5855144/face-recognition`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qq5855144/face-recognition/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: qq5855144 (https://skillmd.com/u/qq5855144)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qq5855144/face-recognition

---


## 能力概述

本 Skill 封装百度 AI 人脸识别平台（`app-bo4w33bsdqm9-api-l9nZz8ro7Bl9-gateway.appmiaoda.com`）的五个核心接口，通过 API Gateway 统一鉴权（platform_managed）对外暴露。

| 接口 | Endpoint | Method | 是否计费 |
|------|----------|--------|---------|
| 人脸注册 | `POST /rest/2.0/face/v3/faceset/user/add` | POST | 是（¥0.15/次） |
| 人脸搜索 | `POST /rest/2.0/face/v3/search` | POST | 是（¥0.15/次） |
| 用户信息查询 | `POST /rest/2.0/face/v3/faceset/user/get` | POST | 否 |
| 用户列表获取 | `POST /rest/2.0/face/v3/faceset/group/getusers` | POST | 否 |
| 删除用户 | `POST /rest/2.0/face/v3/faceset/user/delete` | POST | 否 |

- 认证模式：`platform_managed`，密钥由平台注入（`INTEGRATIONS_API_KEY`），Header 统一使用 `X-Gateway-Authorization: Bearer <key>`
- 支持平台：Web、MiniProgram
- 所有接口均返回 JSON，响应中 `error_code: 0` 表示成功

## 生成期用法（Agent 直接调用）

直接在脚本中调用各接口，密钥从环境变量读取。各接口的完整参数、TypeScript 示例代码详见对应 references 文件：

- 人脸注册：详见 `references/user-add-api.md`
- 人脸搜索：详见 `references/face-search-api.md`
- 用户信息查询：详见 `references/user-get-api.md`
- 用户列表获取：详见 `references/group-getusers-api.md`
- 删除用户：详见 `references/user-delete-api.md`

## 生成后用法（应用内通过 Edge Function 调用）

在应用中为每个接口单独部署一个 Supabase Edge Function，前端通过 `supabase.functions.invoke` 调用。各接口的完整 Edge Function 代码、前端调用代码、注意事项详见对应 references 文件：

| 接口 | Edge Function 文件名 | 参考文档 |
|------|---------------------|---------|
| 人脸注册 | `face-user-add` | `references/user-add-api.md` |
| 人脸搜索 | `face-search` | `references/face-search-api.md` |
| 用户信息查询 | `face-user-get` | `references/user-get-api.md` |
| 用户列表获取 | `face-group-getusers` | `references/group-getusers-api.md` |
| 删除用户 | `face-user-delete` | `references/user-delete-api.md` |

**平台差异说明：** 所有接口均返回 JSON 数据，Web 和 MiniProgram 共用同一套 Edge Function；前端调用方式相同，均使用 `supabase.functions.invoke`。