功能介紹

靜默活體檢測是實(shí)人檢測的常見技術(shù)方案之一，基于人臉圖片中可能存在的畸變、摩爾紋、反光、倒影、邊框等信息，判斷圖片中的人臉是否來自于真人活體，進(jìn)行實(shí)人檢測，有效抵御紙質(zhì)翻拍照、電子翻拍照以及視頻翻拍等各種攻擊方式。靜默活體檢測支持單張圖片，也支持多人臉圖片，當(dāng)圖片中有多個(gè)人臉時(shí)，會(huì)檢測其中最大的人臉是否為活體。新老用戶均可用該接口。

實(shí)人檢測方案可結(jié)合具體業(yè)務(wù)訴求、成本等因素靈活設(shè)計(jì)，靜默活體檢測可作為其中一種技術(shù)手段，與其他方案按需組合使用。

前提條件：

請確保您已開通 人臉識別 服務(wù)，具體操作方法請參見申請服務(wù)。

約束限制：

• 只支持識別JPG、PNG、JPEG、BMP格式的圖片。
• application/json請求的body中，請使用標(biāo)準(zhǔn)Json格式。
• Base64編碼中請勿使用回車換行。
• 系統(tǒng)不保存用戶圖片。
• 圖片大小小于2MB，由于過大圖片會(huì)導(dǎo)致時(shí)延較長，并且圖片信息量不大，建議小于1MB。
• 圖片分辨率小于4096*4096，圖片中人臉像素大于40*40，建議120*120以上。
• 為保證識別效果，人臉圖片建議要求如下：
  1. 光照大于200lux、無反光強(qiáng)光陰影現(xiàn)象。
  2. 人臉無遮擋、整體清晰無拖尾抖動(dòng)等運(yùn)動(dòng)模糊。
  3. 側(cè)臉不超過30°、俯仰角小于15°、偏轉(zhuǎn)角小于15°、圖片中人臉保持豎置正臉。
• 其他的約束限制信息請參見1.4 約束限制章節(jié)。

建議：

• 由于過大圖片對識別算法精度無明顯提升，同時(shí)會(huì)導(dǎo)致時(shí)延較長，建議傳入圖片小于1MB，一般500KB左右足夠。
• OBS 上存儲的圖片也建議小于1MB。
• 圖片中人臉像素建議120*120以上。

調(diào)試

您可以在API Explorer中調(diào)試該接口，支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例，并提供SDK代碼示例調(diào)試功能。

URI

POST /v1/{project_id}/live-detect-face

請求參數(shù)

響應(yīng)參數(shù)

狀態(tài)碼：200

狀態(tài)碼： 400

請求示例

X-Auth-Token值獲取方法請參見快速入門。

• 通過傳入圖片的B AS E64編碼，判斷圖片中的人臉是否來自于真人活體

  POST https://{endpoint}/v1/{project_id}/live-detect-faceRequest Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...  Request Body: {         "image_base64": "/9j/4AAQSkZJRgABAgEASABIAAD"}

• 通過傳入圖片文件，判斷圖片中的人臉是否來自于真人活體

  POST https://{endpoint}/v1/{project_id}/live-detect-faceRequest Header: X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...  Request Body:   image_file: File(圖片文件)

• 通過傳入圖片URL，判斷圖片中的人臉是否來自于真人活體

  POST https://{endpoint}/v1/{project_id}/live-detect-faceRequest Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...  Request Body: {     "image_url": "https://<bucket-name>.<endpoint>/<object-name>"}

• 使用Python3語言讀取本地圖片，判斷圖片中的人臉是否來自于真人活體

  # -*- coding:utf-8 -*-import requestsimport base64endpoint = '開通服務(wù)所在region的人臉識別服務(wù)域名'project_id = '開通服務(wù)所在region的用戶項(xiàng)目ID'token = "用戶獲取得到的實(shí)際token值"headers = {'Content-Type': 'application/json', 'X-Auth-Token': token}url = "https://{endpoint}/v1/{project_id}/live-detect-face".format(endpoint=endpoint, project_id=project_id)image_file_path = r'./data/face-demo.png'with open(image_file_path, "rb") as bin_data:image_data = bin_data.read()image_base64 = base64.b64encode(image_data).decode("utf-8")body = {"image_base64": image_base64}response = requests.post(url, headers=headers, json=body, verify=False)print(response.text)  

• 使用Java語言讀取圖片base64編碼，判斷圖片中的人臉是否來自于真人活體

  import com.huawei.trace.http.apache.httpclient.TraceApacheHttpClientBuilder;import org.apache.http.HttpEntity;import org.apache.http.HttpHeaders;import org.apache.http.HttpResponse;import org.apache.http.client.config.RequestConfig;import org.apache.http.client.methods.HttpPost;import org.apache.http.config.Registry;import org.apache.http.config.RegistryBuilder;import org.apache.http.conn.socket.ConnectionSocketFactory;import org.apache.http.conn.socket.PlainConnectionSocketFactory;import org.apache.http.conn.ssl.NoopHostnameVerifier;import org.apache.http.conn.ssl.SSLConnectionSocketFactory;import org.apache.http.entity.ContentType;import org.apache.http.entity.StringEntity;import org.apache.http.impl.client.CloseableHttpClient;import org.apache.http.impl.client.HttpClientBuilder;import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;import org.apache.http.ssl.SSLContextBuilder;import org.apache.http.ssl.TrustStrategy;import org.apache.http.util.EntityUtils;import java.io.IOException;import java.nio.charset.StandardCharsets;import java.security.KeyManagementException;import java.security.KeyStoreException;import java.security.NoSuchAlgorithmException;import java.security.cert.CertificateException;import java.security.cert.X509Certificate;import java.util.concurrent.TimeUnit;import javax.net.ssl.HostnameVerifier;import javax.net.ssl.SSLContext;/** * 此demo僅供測試使用，強(qiáng)烈建議使用SDK * 使用前需已配置HttpClient jar包。jar包可通過下載SDK獲取 */public class LiveDetectFace {    protected static HttpClientBuilder buildClient(HttpClientBuilder httpClientBuilder) {        SSLContext sslContext = null;        try {            sslContext = new SSLContextBuilder().loadTrustMaterial(null, new TrustStrategy() {                public boolean isTrusted(X509Certificate[] arg0, String arg1) throws CertificateException {                    return true;                }            }).build();        } catch (NoSuchAlgorithmException e) {            throw new RuntimeException(e.getMessage());        } catch (KeyManagementException e) {            throw new RuntimeException(e.getMessage());        } catch (KeyStoreException e) {            throw new RuntimeException(e.getMessage());        }        httpClientBuilder.setSSLContext(sslContext);        httpClientBuilder.setConnectionTimeToLive(30, TimeUnit.SECONDS);        HostnameVerifier hostnameVerifier = NoopHostnameVerifier.INSTANCE;        SSLConnectionSocketFactory sslSocketFactory = new SSLConnectionSocketFactory(sslContext, hostnameVerifier);        Registry<ConnectionSocketFactory> socketFactoryRegistry            = RegistryBuilder.<ConnectionSocketFactory>create().register("http",            PlainConnectionSocketFactory.getSocketFactory()).register("https", sslSocketFactory).build();        PoolingHttpClientConnectionManager connMgr = new PoolingHttpClientConnectionManager(socketFactoryRegistry);        connMgr.setMaxTotal(200);        connMgr.setDefaultMaxPerRoute(100);        httpClientBuilder.setConnectionManager(connMgr);        return httpClientBuilder;    }    public static String doPost(String url, String jsonStr, String token, CloseableHttpClient client) {        HttpPost post = new HttpPost(url);        StringEntity entity = new StringEntity(jsonStr, ContentType.APPLICATION_JSON);        post.setEntity(entity);        post.setHeader(HttpHeaders.CONTENT_TYPE, "application/json");        //time unit is milliseconds        RequestConfig requestConfig = RequestConfig.custom().setConnectTimeout(3000).setSocketTimeout(3000).build();        post.setConfig(requestConfig);        post.setHeader("X-Auth-Token", token);        HttpResponse response = null;        String result = "";        try {            response = client.execute(post);            HttpEntity responseBody = response.getEntity();            if (responseBody == null) {                System.out.println("the response body is null.");                return result;            } else {                byte[] byteStream = EntityUtils.toByteArray(responseBody);                System.arraycopy(byteStream, 0, new byte[byteStream.length], 0, byteStream.length);                result = new String(byteStream, StandardCharsets.UTF_8);            }        } catch (IOException e) {            e.printStackTrace();        }        return result;    }    public static void main(String[] args) {        CloseableHttpClient client = buildClient(TraceApacheHttpClientBuilder.create()).build();        // endpoint和project_id需要替換成實(shí)際信息。        String url = "https://{{endpoint}}/v1/{{project_id}}/live-detect-face";        String jsonStr = "{ \"image_base64\": \"/9j/4AAQSkZJRgABAgEASABIAAD...\" }";        String token = "對應(yīng)region的token";        String result = doPost(url, jsonStr, token, client);        System.out.println(result);    }}

響應(yīng)示例

狀態(tài)碼：200

狀態(tài)碼

狀態(tài)碼請參見狀態(tài)碼。

錯(cuò)誤碼

錯(cuò)誤碼請參見錯(cuò)誤碼。