# facepp-go

**Repository Path**: sofun/facepp-go

## Basic Information

- **Project Name**: facepp-go
- **Description**: 旷视人脸检测、搜索golang接口实现
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-09-10
- **Last Updated**: 2025-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# facepp-go

一个用于调用 Face++ API 的 Go 语言封装库，支持人脸检测、搜索以及人脸集合管理等功能。

## 功能特性

- **人脸检测**：支持通过图片 URL、本地图片文件或 Base64 编码进行人脸检测。
- **人脸搜索**：支持通过图片 URL、本地图片文件、Base64 编码或 FaceToken 在指定人脸集合中搜索相似人脸。
- **人脸集合管理**：支持创建、查询详情、删除人脸集合，以及向集合中添加人脸。
- **用户 ID 设置**：支持为检测到的人脸设置用户 ID。

## 安装

确保你已经安装了 Go 环境，然后运行以下命令：

```bash
go get github.com/sofun/facepp-go
```

## 使用示例

### 初始化

```go
import "github.com/sofun/facepp-go"

facepp := facepp.NewFacePP("your_api_key", "your_api_secret")
```

### 人脸检测

```go
resp, err := facepp.FaceDetectByImageFile("path/to/image.jpg", "0", "0")
```

### 人脸搜索

```go
resp, err := facepp.FaceSearchByImageFile("path/to/image.jpg", "faceset_token", "outer_id", "1")
```

### 创建人脸集合

```go
resp, err := facepp.CreateFaceset("MyFaceSet", "my_outer_id", "tags", "user_data")
```

### 获取人脸集合详情

```go
resp, err := facepp.FacesetDetail("faceset_token", "outer_id")
```

### 删除人脸集合

```go
resp, err := facepp.FacesetDelete("faceset_token", "outer_id", "1")
```

### 添加人脸到集合

```go
resp, err := facepp.FaceAdd("faceset_token", "outer_id", "face_token")
```

### 设置人脸用户 ID

```go
resp, err := facepp.SetUserId("face_token", "user_id")
```

## 示例图片

项目中的 `examples/face1.jpg` 和 `examples/image.png` 可用于测试人脸检测和搜索功能。

## 许可证

本项目基于 MIT 许可证发布。详情请查看 [LICENSE](LICENSE) 文件。

## 贡献

欢迎提交 Pull Request 或提出 Issue 来帮助改进本项目。