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`。