上传人脸基准图片

POST

/face_verify/v1/upload_face_image

无源人脸比对流程，开发者后台通过调用此接口将基准图片上传到飞书后台，做检测时的对比使用。

无源人脸比对接入需申请白名单，接入前请联系飞书开放平台工作人员，邮箱：open-platform@bytedance.com。

查询参数

用户标识open_id与employee_id二选其一，同时传入取open_id，open_id必须与tenant_access_token对应的应用和租户相同，employee_id必须与tenant_access_token的租户相同。

错误码

错误码	描述	排查建议
10100	invalid request	检查参数是否为空，权限是否接入
10101	internal error	建议重试

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Body 参数multipart/form-data

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/face_verify/v1/upload_face_image?open_id&employee_id' \
--header 'Authorization: Bearer <token>' \
--form 'image=@""'

响应示例

{
    "code": 0,
    "msg": "ok",
    "data": {
        "face_uid": "ou_3a85bc15f186865bf03d9fa522878a53"
    }
}

修改于 2025-10-21 08:29:47

录入身份信息

裁剪人脸图片

上传人脸基准图片

查询参数#

错误码#

请求参数

返回响应

查询参数

错误码