\TencentAIFace

detect()

detect(mixed  $image, boolean  $big = true) : mixed

人脸分析：识别上传图像上面的人脸信息.

检测给定图片中的所有人脸的位置 (x, y, w, h) 和相应的面部属性 包括性别 (gender),年龄, 表情 (expression), 魅力 (beauty), 眼镜 (glass) 和姿态 (pitch，roll，yaw).

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

multiDetect()

multiDetect(mixed  $image) : mixed

多人脸检测：识别上传图像上面的人脸位置，支持多人脸识别.

检测图片中的人脸位置，可以识别出一张图片上的多个人脸.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

compare()

compare(array  $images) : mixed

人脸对比：对请求图片进行人脸对比.

对请求图片的两个人脸进行对比，计算相似性以及五官相似度.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

detectCrossAge()

detectCrossAge(mixed  $source, mixed  $target) : array

跨年龄人脸识别.

对比两张图片，并找出相似度最高的两张人脸；支持多人合照、两张图片中的人处于不同年龄段的情况

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

shape()

shape(mixed  $image, boolean  $big = true) : mixed

五官检测：对请求图片进行五官定位.

计算构成人脸轮廓的 88 个点，包括眉毛（左右各 8 点）、眼睛（左右各 8 点）、鼻子（13 点）、嘴巴（22 点）、脸型轮廓（21 点）.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

identify()

identify(string  $group_id, mixed  $image, integer  $topon = 9) : mixed

人脸识别.

对于一个待识别的人脸图片，在一个组中识别出最相似的 N 个个体作为候选人返回，返回的 N 个个体按照相似度从大到小排列，N 由参数 topn 指定.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

verify()

verify(string  $person_id, mixed  $image) : mixed

人脸验证

根据提供的图片和个体 ID，返回图片和个体是否是同一个人的判断以及置信度.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

add()

add(string  $person_id, array  $images, string  $tag) : mixed

个体管理 => 增加人脸：将一个或一组人脸加入到一个个体中.

一个人脸只能被加入到一个个体中.一个个体最多允许包含 20 个人脸；加入几乎相同的人脸会返回错误.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

Examples

add('personID',[$image1],'example'); // 单个人脸 add('personID',[$image1,$image2],'example'); // 一组人脸 </pre>

** File not found : <pre> **

delete()

delete(string  $person_id, array  $face_ids) : mixed

个体管理 => 删除人脸：从一个个体中删除一个或一组人脸.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

getList()

getList(string  $person_id) : mixed

获取人脸列表.

获取一个个体下所有人脸 ID.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

getInfo()

getInfo(string  $face_id) : mixed

获取人脸信息.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

createPerson()

createPerson(array  $group_ids, string  $person_id, string  $person_name, mixed  $image, string  $tag) : mixed

人体创建(属于一个组，或多个组).

创建一个个体，并将个体放置到指定的组当中。一个组里面的个体总数上限为 20000 个。如果 ID 指定的组不存在，则会新建组并创建个体。

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

deletePerson()

deletePerson(string  $person_id) : mixed

删除个体.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

setPersonInfo()

setPersonInfo(string  $person_id, string  $person_name, string  $tag) : mixed

设置个体信息：设置个体的名字或备注.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

getPersonInfo()

getPersonInfo(string  $person_id) : mixed

获取个体信息.

获取一个个体的信息，包括 ID，名字，备注，相关的人脸 ID 列表，以及所属组 ID 列表.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

getGroupList()

getGroupList() : mixed

获取组列表.

获取一个 AppId 下所有组 ID.

Throws

\TencentAI\Error\TencentAIError

Returns

getPersonList()

getPersonList(string  $group_id) : mixed

获取人体列表.

获取一个组中的所有个体 ID.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

image()

image(string  $url,   $image, boolean  $isUrl = false) : mixed

图片公共方法.

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns

encode()

encode(mixed  $image) : string

对图片文件进行 base64 编码

传入本地路径或文件内容

Parameters

Throws

\TencentAI\Error\TencentAIError

Returns