简介
本文档提供关于人脸识别的 API 概览以及 SDK 示例代码。
| API | 操作描述 |
| 人脸检测 | 人脸检测功能为同步请求方式，您可以通过本接口检测图片中的人脸位置 |
| 人脸特效 | 人脸特效支持人脸美颜、人脸性别变换、人脸年龄变化、人像分割的特效功能，适用于社交娱乐、广告营销、互动传播等场景 |
人脸检测
功能说明
检测图片中的人脸位置。
方法原型
func (s *CIService) DetectFace(ctx context.Context, key string, opt *DetectFaceOptions) (*DetectFaceResult, *Response, error)
请求示例
obj := "pic/face.jpeg"opt := &cos.DetectFaceOptions{ MaxFaceNum: 2,}res, _, err := c.CI.DetectFace(context.Background(), obj, opt)
参数说明
type DetectFaceOptions struct { MaxFaceNum int `url:"max-face-num,omitempty"`}
| 参数名称 | 参数描述 | 是否必选 |
| key | 对象键（Key）是对象在存储桶中的唯一标识。例如，在对象的访问域名examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/pic/pic.jpg中，对象键为 pic/pic.jpg |
是 |
| MaxFaceNum | 最多处理的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快 | 否 |
结果说明
type DetectFaceResult struct { XMLName xml.Name `xml:"Response"` ImageWidth int `xml:"ImageWidth,omitempty"` ImageHeight int `xml:"ImageHeight,omitempty"` FaceModelVersion string `xml:"FaceModelVersion,omitempty"` RequestId string `xml:"RequestId,omitempty"` FaceInfos []FaceInfos `xml:"FaceInfos,omitempty"`}
type FaceInfos struct { X int `xml:"X,omitempty"` Y int `xml:"Y,omitempty"` Width int `xml:"Width,omitempty"` Height int `xml:"Height,omitempty"`}
| 参数名称 | 参数描述 |
| ImageWidth | 请求的图片宽度 |
| ImageHeight | 请求的图片高度 |
| FaceModelVersion | 人脸识别所用的算法模型版本 |
| RequestId | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId |
| FaceInfos | 人脸信息列表。包含人脸坐标信息 |
| X | 人脸框左上角横坐标。人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值 |
| Y | 人脸框左上角纵坐标。人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值 |
| Width | 人脸框宽度 |
| Height | 人脸框高度 |
人脸特效
功能说明
人脸特效支持人脸美颜、人脸性别变换、人脸年龄变化、人像分割的特效功能。
方法原型
func (s *CIService) FaceEffect(ctx context.Context, obj string, opt *FaceEffectOptions) (*FaceEffectResult, *Response, error)
请求示例
obj := "pic/self.jpeg"opt := &cos.FaceEffectOptions{ Type: "face-segmentation", Whitening: 50,}res, _, err := c.CI.FaceEffect(context.Background(), obj, opt)
参数说明
type FaceEffectOptions struct { Type string `url:"type,omitempty"` Whitening int `url:"whitening,omitempty"` Smoothing int `url:"smoothing,omitempty"` FaceLifting int `url:"faceLifting,omitempty"` EyeEnlarging int `url:"eyeEnlarging,omitempty"` Gender int `url:"gender,omitempty"` Age int `url:"age,omitempty"`}
| 参数名称 | 参数描述 | 是否必选 |
| key | 对象键（Key）是对象在存储桶中的唯一标识。例如，在对象的访问域名examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/pic/pic.jpg中，对象键为 pic/pic.jpg |
是 |
| Type | 人脸特效相关选项人脸特效类型。人脸美颜：face-beautify；人脸性别转换：face-gender-transformation；人脸年龄变化：face-age-transformation；人像分割：face-segmentation | 是 |
| Whitening | type 为 face-beautify 时生效，美白程度，取值范围[0,100]。0表示不美白，100表示最高程度。默认值30 | 否 |
| Smoothing | type 为 face-beautify 时生效，磨皮程度，取值范围[0,100]。0表示不磨皮，100表示最高程度。默认值10 | 否 |
| FaceLifting | type 为 face-beautify 时生效，瘦脸程度，取值范围[0,100]。0表示不瘦脸，100表示最高程度。默认值70 | 否 |
| EyeEnlarging | type 为 face-beautify 时生效，大眼程度，取值范围[0,100]。0表示不大眼，100表示最高程度。默认值70 | 否 |
| Gender | type 为 face-gender-transformation 时生效，选择转换方向，0表示男变女，1表示女变男。无默认值。注意：仅对图片中面积最大的人脸进行转换 | 否 |
| Age | type 为 face-age-transformation 时生效，变化到的人脸年龄，范围为[10,80]，无默认值。注意：仅对图片中面积最大的人脸进行转换 | 否 |
结果说明
type FaceEffectResult struct { XMLName xml.Name `xml:"Response"` ResultImage string `xml:"ResultImage,omitempty"` ResultMask string `xml:"ResultMask,omitempty"`}
| 参数名称 | 参数描述 |
| ResultImage | 处理后的图片 base64 数据 |
| ResultMask | 人像分割输出参数，一个通过 Base64 编码的文件，解码后文件由 Float 型浮点数组成。这些浮点数代表原图从左上角开始的每一行的每一个像素点，每一个浮点数的值是原图相应像素点位于人体轮廓内的置信度（0-1）转化的灰度值（0-255） |
对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/145635.html
