图片要求

1. 图片格式：JPG、JPEG、PNG、BMP等常见格式，建议使用JPG格式。
2. 图片文件大小：最大 5 MB。
3. 图片分辨率最大2000 x 2000像素。

接口地址

https://visual.volcengineapi.com

请求方式

POST

Content-Type

application/json

X-Date

String

是

使用UTC时间，精确到秒。请使用格式：YYYYMMDD'T'HHMMSS'Z' ，例如：20201103T104027Z

Authorization

String

是

HMAC-SHA256：签名方法
-Credential为签名凭证，其中:
-AccessKeyId为访问密钥ID，可在 访问密钥（Access Key） 获取；
-ShortDate为请求的短时间，使用UTC时间，精确到日。请使用格式：YYYYMMDD，例如：20180201；
-Region为请求地区，国内一般为为cn-north-1；
-Service为请求的服务，一般为cv；
-SignedHeaders为参与签名计算的头部信息，content-type 和 host 为必选头部；
-Signature为签名，可在 签名方法 获取。
注：我们提供了SDK及签名示例供您实现服务快速接入，具体可参考 快速接入
例如：HMAC-SHA256 Credential={AccessKeyId}/{ShortDate}/{Region}/{Service}/request, SignedHeaders={SignedHeaders}, Signature={Signature}

X-Security-Token

String

否

指安全令牌服务（Security Token Service，STS） 颁发的临时安全凭证中的SessionToken，使用长期密钥时无需填写该参数。

Action

必选

string

接口名，取值：FaceCompare

Version

必选

string

版本号，取值：2022-08-31

req_key

必选

string

算法名称，取固定值为"face_compare_usage"

binary_data_base64

可选

array of string

输入图片的base64数组，与图片链接二选一。此算法需要输入 2 张人脸图，第一张为xxx，第二张为xxx

image_urls

可选

array of string

输入图片的下载链接数组。需要输入两个图片下载链接

is_match

bool

两张图片的最大人脸是否为同一个人

confidence

float64

两张图片中的最大人脸属于同一个人的置信度，取值范围 0~1。如果某张图片中没有人脸，则返回的置信度为 0

thresholds

array of float64

误识率在 1/10000，1/100000，1/1000000 的情况下分别对应的置信度阈值。例如[62.3,66.4,78.7]，表示误识率为 1/10000 的情况下，置信度（Confidence）超过 62.3%就可以认为是同一个人

rect_a_list

array of int

图像A与图像B比较，最相似人脸在图像A中的矩形框[left, top, width, height]，例如[106,61,86,112]。如果图片中没有人脸，则返回的矩形框数值均为 0

rect_b_list

array of int

图像A与图像B比较，最相似人脸在图像B中的矩形框[left, top, width, height]，例如[771, 118, 222, 303]。如果图片中没有人脸，则返回的矩形框数值均为 0

200

10000

无

请求成功