Face liveness detection

Updated at:

Face liveness detection determines whether a face in an image is a live, genuine face captured by an authenticated device. This capability is widely used in real-time face capture scenarios. This topic provides sample code for face liveness detection in common programming languages.

Note
  • For real-time assistance, start an online consultation.

  • If you have questions about API access or usage for the Alibaba Cloud Vision AI Platform, join our DingTalk group (ID: 23109592) to contact us.

Feature overview

For more information about the face liveness detection feature and its API parameters, see face liveness detection.

Install the SDK

For information about SDK dependencies for common programming languages, see SDK Overview.

Configure environment variables

Configure the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables.

Important
  • An Alibaba Cloud account has full access to all API operations. We recommend that you use a RAM user for API calls or routine O&M. For more information, see Create a RAM user.

  • Do not save your AccessKey ID or AccessKey Secret in project code. Otherwise, the AccessKey pair may be leaked and the security of all resources in your account may be compromised.

  • Configure environment variables on Linux and macOS

    1. Open a terminal in IntelliJ IDEA.

    2. Run the following commands to configure the environment variables.

      Replace <access_key_id> with the AccessKey ID of your RAM user and <access_key_secret> with the AccessKey Secret of your RAM user. If you need to configure more permissions, see Control access permissions using a RAM policy.

      export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id>
      export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>
  • Configure environment variables on Windows

    Create a new environment variable file, add the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET, and set them to the AccessKey ID and AccessKey Secret that you have prepared. Then, restart the Windows operating system. The following example uses Windows 10.

    1. Open File Explorer, right-click This PC, and then select Properties.

    2. In the left-side navigation pane, click Advanced system settings.

    3. On the Advanced tab of the System Properties dialog box, click Environment Variables.

    4. In the Environment Variables dialog box, click New.

    5. In the New System Variable dialog box, add the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET, and set them to the AccessKey ID and AccessKey Secret that you have prepared.

    6. Restart the Windows operating system for the configurations to take effect.

Sample code

Files in OSS (Shanghai)

/*
Add the dependency.
Minimum SDK version required: facebody20191230 version 3.0.7 or later.
You can find the latest SDK version in this repository: https://mvnrepository.com/artifact/com.aliyun/facebody20191230
<!-- https://mvnrepository.com/artifact/com.aliyun/facebody20191230 -->
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>facebody20191230</artifactId>
    <version>${aliyun.facebody.version}</version>
</dependency>
*/

import com.aliyun.facebody20191230.models.DetectLivingFaceResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaModel;
public class DetectLivingFace {
    public static com.aliyun.facebody20191230.Client createClient(String accessKeyId, String accessKeySecret) throws Exception {
        /*
          Initializes a new Config object.
          This object stores configurations such as your AccessKey ID, AccessKey Secret, and endpoint.
         */
         com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
            .setAccessKeyId(accessKeyId)
            .setAccessKeySecret(accessKeySecret);
        // The endpoint of the service.
        config.endpoint = "facebody.cn-shanghai.aliyuncs.com";
        return new com.aliyun.facebody20191230.Client(config);
    }

    public static void main(String[] args) throws Exception {
        // For information about how to create an AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
        // If you use a RAM user's AccessKey pair, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
        // Before running the sample code, make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"); 
        com.aliyun.facebody20191230.Client client = DetectLivingFaceSample.createClient(accessKeyId, accessKeySecret);
        com.aliyun.facebody20191230.models.DetectLivingFaceRequest.DetectLivingFaceRequestTasks tasks0 = new com.aliyun.facebody20191230.models.DetectLivingFaceRequest.DetectLivingFaceRequestTasks()
            .setImageURL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg");
        com.aliyun.facebody20191230.models.DetectLivingFaceRequest.DetectLivingFaceRequestTasks tasks1 = new com.aliyun.facebody20191230.models.DetectLivingFaceRequest.DetectLivingFaceRequestTasks()
            .setImageURL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace17.jpg");
        com.aliyun.facebody20191230.models.DetectLivingFaceRequest detectLivingFaceRequest = new com.aliyun.facebody20191230.models.DetectLivingFaceRequest()
            .setTasks(java.util.Arrays.asList(
                tasks0,
                tasks1
            ));
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
        try {
            // We recommend that you print the API response after you run the sample code.
            DetectLivingFaceResponse resp = client.detectLivingFaceWithOptions(detectLivingFaceRequest, runtime);
            System.out.println(com.aliyun.teautil.Common.toJSONString(TeaModel.buildMap(resp)));
        } catch (TeaException error) {
            // Print the error if needed.
            com.aliyun.teautil.Common.assertAsString(error.message);
            System.out.println(error);
        } catch (Exception _error) {
            TeaException error = new TeaException(_error.getMessage(), _error);
            // Print the error if needed.
            com.aliyun.teautil.Common.assertAsString(error.message);
            System.out.println(_error);
        }
    }
}
# -*- coding: utf-8 -*-
# Add the dependency.
# Minimum SDK version required: alibabacloud-facebody20191230 version 4.0.8 or later.
# You can find the latest SDK version in this repository: https://pypi.org/project/alibabacloud-facebody20191230/
# pip install alibabacloud_facebody20191230

import os
from alibabacloud_facebody20191230.models import DetectLivingFaceRequestTasks, DetectLivingFaceRequest
from alibabacloud_tea_openapi.models import Config
from alibabacloud_facebody20191230.client import Client
from alibabacloud_tea_util.models import RuntimeOptions

config = Config(
    # For information about how to create an AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
    # If you use a RAM user's AccessKey pair, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
    # Before running the sample code, make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.
    access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
    access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
    # The endpoint of the service.
    endpoint='facebody.cn-shanghai.aliyuncs.com',
    # The region ID that corresponds to the endpoint.
    region_id='cn-shanghai'
)
tasks_0 = DetectLivingFaceRequestTasks(
  image_url='http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg'
)
tasks_1 = DetectLivingFaceRequestTasks(
  image_url='http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace18.jpg'
)
detect_living_face_request = DetectLivingFaceRequest(
  tasks=[
    tasks_0,
    tasks_1
  ]
)
runtime_option = RuntimeOptions()
try:
  # Initialize the client.
  client = Client(config)
  response = client.detect_living_face_with_options(detect_living_face_request, runtime_option)
  # Get the entire response.
  print(response.body)
  # Tip: You can view attribute names with response.body.__dict__.
except Exception as error:
  # Get the full error message.
  print(error)
  # Get a single field.
  print(error.code)
  # Tip: You can view attribute names with error.__dict__.
<?php

// Add the dependency.
// Minimum SDK version required: facebody-20191230 version 3.0.8 or later.
// You can find the latest SDK version in this repository: https://packagist.org/packages/alibabacloud/facebody-20191230
// composer require alibabacloud/facebody-20191230

use AlibabaCloud\SDK\Facebody\V20191230\Facebody;
use AlibabaCloud\SDK\Facebody\V20191230\Models\DetectLivingFaceRequest;
use AlibabaCloud\SDK\Facebody\V20191230\Models\DetectLivingFaceRequest\tasks;
use AlibabaCloud\Tea\Console\Console;
use \Exception;
use AlibabaCloud\Tea\Exception\TeaError;
use AlibabaCloud\Tea\Utils\Utils;
use Darabonba\OpenApi\Models\Config;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;

class DetectLivingFace {

    /**
     * Initialize the client with an AccessKey pair.
     * @param string $accessKeyId
     * @param string $accessKeySecret
     * @return Facebody Client
     */
    public static function createClient($accessKeyId, $accessKeySecret){
        // Initializes a new Config object.
        // This object stores configurations such as your accessKeyId, accessKeySecret, and endpoint.
        $config = new Config([
            "accessKeyId" => $accessKeyId,
            "accessKeySecret" => $accessKeySecret
        ]);
        // The endpoint of the service.
        $config->endpoint = "facebody.cn-shanghai.aliyuncs.com";
        return new Facebody($config);
    }

    /**
     * @param string[] $args
     * @return void
     */
    public static function main($args){
        // For information about how to create an AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
        // If you use a RAM user's AccessKey pair, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
        // Before running the sample code, make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.
        $accessKeyId = getenv('ALIBABA_CLOUD_ACCESS_KEY_ID');      
        $accessKeySecret = getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET');
        $client = self::createClient($accessKeyId, $accessKeySecret);
        $runtime = new RuntimeOptions([]);
        $tasks0 = new tasks([
           "imageURL" => "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg"
        ]);
        $tasks1 = new tasks([
           "imageURL" => "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg"
        ]);
        $detectLivingFaceRequest = new DetectLivingFaceRequest([
           "tasks" => [
              $tasks0,
              $tasks1
            ]
        ]);
        try {
            $resp = $client->detectLivingFaceWithOptions($detectLivingFaceRequest, $runtime);
            # Get the entire response.
            echo Utils::toJSONString($resp->body);
        } catch (Exception $exception) {
            # Get the full error message.
            echo Utils::toJSONString($exception);
            # Get a single field.
            echo $exception->getCode();
        }
    }
}
$path = __DIR__ . \DIRECTORY_SEPARATOR . '..' . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
if (file_exists($path)) {
    require_once $path;
}
// $argv is a reserved array for input parameters and does not need to be modified.
DetectLivingFace::main(array_slice($argv, 1));
// Add the dependency.
// npm install @alicloud/facebody20191230
// Minimum SDK version required: @alicloud/facebody20191230 version 4.0.7 or later.
// You can find the latest SDK version in this repository: https://npmjs.com/package/@alicloud/facebody20191230
const FacebodyClient = require('@alicloud/facebody20191230');
const OpenapiClient = require('@alicloud/openapi-client');
const TeaUtil = require('@alicloud/tea-util');

let config = new OpenapiClient.Config({
    // For information about how to create an AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
    // If you use a RAM user's AccessKey pair, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
    // Before running the sample code, make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.
    accessKeyId: process.env.ALIBABA_CLOUD_ACCESS_KEY_ID,   
    accessKeySecret: process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET
});
// The endpoint of the service.
config.endpoint = `facebody.cn-shanghai.aliyuncs.com`;
const client = new FacebodyClient.default(config);
let tasks0 = new FacebodyClient.DetectLivingFaceRequestTasks({
    imageURL: "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace11.jpg",
});
let detectLivingFaceRequest = new FacebodyClient.DetectLivingFaceRequest({
    tasks: [
        tasks0
    ],
});
let runtime = new TeaUtil.RuntimeOptions({});
client.detectLivingFaceWithOptions(detectLivingFaceRequest, runtime)
    .then(function (detectLivingFaceResponse) {
        // Get the entire response.
        console.log(detectLivingFaceResponse);
        // Get a single field.
        console.log(detectLivingFaceResponse.body.data);
    }, function (error) {
        // Get the full error message.
        console.log(error);
        // Get a single field.
        console.log(error.data.Code);
    })
/**
Minimum SDK version required: facebody-20191230 version 4.0.7 or later.
You can find the latest SDK version in this repository: https://pkg.go.dev/github.com/alibabacloud-go/facebody-20191230/v4
Requires the github.com/alibabacloud-go/facebody-20191230 dependency.
We recommend using 'go mod tidy' to install dependencies.
*/

import (
  "fmt"
  facebody20191230  "github.com/alibabacloud-go/facebody-20191230/v4/client"
  openapi  "github.com/alibabacloud-go/darabonba-openapi/v2/client"
  util  "github.com/alibabacloud-go/tea-utils/v2/service"
  "github.com/alibabacloud-go/tea/tea"
)
func main() {
     // For information about how to create an AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
     // If you use a RAM user's AccessKey pair, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
     // Before running the sample code, make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.
     accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")  
     accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
     // Initializes a new openapi.Config object. This object stores configurations such as your AccessKey ID, AccessKey Secret, and endpoint.
     config := &openapi.Config{
          AccessKeyId: tea.String(accessKeyId),
          AccessKeySecret: tea.String(accessKeySecret)
	   }
    // The endpoint of the service.
    config.Endpoint = tea.String("facebody.cn-shanghai.aliyuncs.com")
    client, err := facebody20191230.NewClient(config)
    if err != nil {
        panic(err)
    }
    tasks0 := &facebody20191230.DetectLivingFaceRequestTasks{
	  ImageURL: tea.String("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace17.jpg"),
	}
	tasks1 := &facebody20191230.DetectLivingFaceRequestTasks{
	  ImageURL: tea.String("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace18.jpg"),
	}
	detectLivingFaceRequest := &facebody20191230.DetectLivingFaceRequest{
	  Tasks: []*facebody20191230.DetectLivingFaceRequestTasks{tasks0, tasks1},
	}
    runtime := &util.RuntimeOptions{}
    detectLivingFaceResponse, err := client.DetectLivingFaceWithOptions(detectLivingFaceRequest, runtime)
    if err != nil {
        // Get the full error message.
        fmt.Println(err.Error())
    } else {
        // Get the entire response.
        fmt.Println(detectLivingFaceResponse)
    }
}
// Add the dependency.
// dotnet add package AlibabaCloud.SDK.Facebody20191230
// Minimum SDK version required: facebody20191230 version 3.0.7 or later.
// You can find the latest SDK version in this repository: https://nuget.org/packages/AlibabaCloud.SDK.Facebody20191230
using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;
using AlibabaCloud.SDK.Facebody20191230.Models;
using Tea;
using Tea.Utils;

namespace AlibabaCloud.SDK.Sample
{
public class Sample
{
  public static AlibabaCloud.SDK.Facebody20191230.Client CreateClient(string accessKeyId, string accessKeySecret)
  {
    AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
    {
      AccessKeyId = accessKeyId,
      AccessKeySecret = accessKeySecret,
    };
    // The endpoint of the service.
    config.Endpoint = "facebody.cn-shanghai.aliyuncs.com";
    return new AlibabaCloud.SDK.Facebody20191230.Client(config);
  }

  public static void Main(string[] args)
    {
      // For information about how to create an AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
      // If you use a RAM user's AccessKey pair, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
      // Before running the sample code, make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.
      AlibabaCloud.SDK.Facebody20191230.Client client = CreateClient(System.Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"), System.Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
      AlibabaCloud.SDK.Facebody20191230.Models.DetectLivingFaceRequest.DetectLivingFaceRequestTasks tasks0 = new AlibabaCloud.SDK.Facebody20191230.Models.DetectLivingFaceRequest.DetectLivingFaceRequestTasks
      {
        ImageURL = "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace11.jpg",
      };
      AlibabaCloud.SDK.Facebody20191230.Models.DetectLivingFaceRequest detectLivingFaceRequest = new AlibabaCloud.SDK.Facebody20191230.Models.DetectLivingFaceRequest
      {
        Tasks = new List<AlibabaCloud.SDK.Facebody20191230.Models.DetectLivingFaceRequest.DetectLivingFaceRequestTasks>
        {
          tasks0
          },
      };
      AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
      try
      {
        AlibabaCloud.SDK.Facebody20191230.Models.DetectLivingFaceResponse detectLivingFaceResponse = client.DetectLivingFaceWithOptions(detectLivingFaceRequest, runtime);
        // Get the entire response.
        Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(detectLivingFaceResponse.Body));
        // Get a single field.
        Console.WriteLine(detectLivingFaceResponse.Body.Data);
      }
      catch (TeaException error)
      {
        // Get the full error message.
        Console.WriteLine(error.Message);
      }
      catch (Exception _error)
      {
        TeaException error = new TeaException(new Dictionary<string, object>
        {
          { "message", _error.Message }
        });
        // Get the full error message.
        Console.WriteLine(error.Message);
      }
    }
  }
}

Local files and URLs

/*
Add the dependency.
Minimum SDK version required: facebody20191230 version 3.0.7 or later.
You can find the latest SDK version in this repository: https://mvnrepository.com/artifact/com.aliyun/facebody20191230
<!-- https://mvnrepository.com/artifact/com.aliyun/facebody20191230 -->
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>facebody20191230</artifactId>
    <version>${aliyun.facebody.version}</version>
</dependency>
*/

import com.aliyun.facebody20191230.models.DetectLivingFaceResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaModel;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
import java.net.URL;
public class DetectLivingFaceSample {
    public static com.aliyun.facebody20191230.Client createClient(String accessKeyId, String accessKeySecret) throws Exception {
        /*
          Initializes a new Config object.
          This object stores configurations such as your AccessKey ID, AccessKey Secret, and endpoint.
         */
         com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
            .setAccessKeyId(accessKeyId)
            .setAccessKeySecret(accessKeySecret);
        // The endpoint of the service.
        config.endpoint = "facebody.cn-shanghai.aliyuncs.com";
        return new com.aliyun.facebody20191230.Client(config);
    }

    public static void main(String[] args_) throws Exception {
        // For information about how to create an AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
        // If you use a RAM user's AccessKey pair, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
        // Before running the sample code, make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"); 
        com.aliyun.facebody20191230.Client client = DetectLivingFaceSample.createClient(accessKeyId, accessKeySecret);
        // Scenario 1: Use a local file.
        InputStream tasks0inputStream = new FileInputStream(new File("/tmp/DetectLivingFace4.jpg"));
        // Scenario 2: Use a publicly accessible URL.
        URL url = new URL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace17.jpg");
        InputStream tasks1inputStream = url.openConnection().getInputStream();
        com.aliyun.facebody20191230.models.DetectLivingFaceAdvanceRequest.DetectLivingFaceAdvanceRequestTasks tasks0 = new com.aliyun.facebody20191230.models.DetectLivingFaceAdvanceRequest.DetectLivingFaceAdvanceRequestTasks()
            .setImageURLObject(tasks0inputStream);
        com.aliyun.facebody20191230.models.DetectLivingFaceAdvanceRequest.DetectLivingFaceAdvanceRequestTasks tasks1 = new com.aliyun.facebody20191230.models.DetectLivingFaceAdvanceRequest.DetectLivingFaceAdvanceRequestTasks()
            .setImageURLObject(tasks1inputStream);
        com.aliyun.facebody20191230.models.DetectLivingFaceAdvanceRequest advanceRequest = new com.aliyun.facebody20191230.models.DetectLivingFaceAdvanceRequest()
            .setTasks(java.util.Arrays.asList(
                tasks0,
                tasks1
            ));
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
        try {
            // We recommend that you print the API response after you run the sample code.
            DetectLivingFaceResponse resp = client.detectLivingFaceAdvance(advanceRequest, runtime);
            System.out.println(com.aliyun.teautil.Common.toJSONString(TeaModel.buildMap(resp)));
        } catch (TeaException error) {
            // Print the error if needed.
            com.aliyun.teautil.Common.assertAsString(error.message);
            System.out.println(error);
        } catch (Exception _error) {
            TeaException error = new TeaException(_error.getMessage(), _error);
            // Print the error if needed.
            com.aliyun.teautil.Common.assertAsString(error.message);
            System.out.println(_error);
        }
    }
}
# -*- coding: utf-8 -*-
# Add the dependency.
# Minimum SDK version required: alibabacloud-facebody20191230 version 4.0.8 or later.
# You can find the latest SDK version in this repository: https://pypi.org/project/alibabacloud-facebody20191230/
# pip install alibabacloud_facebody20191230

import os
import io
from urllib.request import urlopen
from alibabacloud_facebody20191230.models import DetectLivingFaceAdvanceRequestTasks,DetectLivingFaceAdvanceRequest
from alibabacloud_tea_openapi.models import Config
from alibabacloud_facebody20191230.client import Client
from alibabacloud_tea_util.models import RuntimeOptions

config = Config(
    # For information about how to create an AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
    # If you use a RAM user's AccessKey pair, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
    # Before running the sample code, make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.
    access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
    access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
    # The endpoint of the service.
    endpoint='facebody.cn-shanghai.aliyuncs.com',
    # The region ID that corresponds to the endpoint.
    region_id='cn-shanghai'
)
# Scenario 1: Use a local file.
stream0 = open(r'/tmp/DetectLivingFace17.jpg', 'rb')
tasks_0 = DetectLivingFaceAdvanceRequestTasks()
tasks_0.image_urlobject = stream0

# Scenario 2: Use a publicly accessible URL.
url1 = 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace17.jpg'
img1 = urlopen(url1).read()
tasks_1 = DetectLivingFaceAdvanceRequestTasks()
tasks_1.image_urlobject = io.BytesIO(img1)
detect_living_face_request = DetectLivingFaceAdvanceRequest(
  tasks=[
    tasks_0,
    tasks_1  
  ]
)
runtime_option = RuntimeOptions()
try:
  # Initialize the client.
  client = Client(config)
  response = client.detect_living_face_advance(detect_living_face_request, runtime_option)
  # Get the entire response.
  print(response.body)
  # Tip: You can view attribute names with response.body.__dict__.
except Exception as error:
  # Get the full error message.
  print(error)
  # Get a single field.
  print(error.code)
  # Tip: You can view attribute names with error.__dict__.

# Close the stream.
stream0.close()
<?php

// Add the dependency.
// Minimum SDK version required: facebody-20191230 version 3.0.8 or later.
// You can find the latest SDK version in this repository: https://packagist.org/packages/alibabacloud/facebody-20191230  
// composer require alibabacloud/facebody-20191230  
  
use AlibabaCloud\SDK\Facebody\V20191230\Facebody;
use AlibabaCloud\SDK\Facebody\V20191230\Models\DetectLivingFaceAdvanceRequest;
use AlibabaCloud\SDK\Facebody\V20191230\Models\DetectLivingFaceAdvanceRequest\tasks;
use AlibabaCloud\Tea\Console\Console;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
use Darabonba\OpenApi\Models\Config;
use AlibabaCloud\Tea\Utils\Utils;
use GuzzleHttp\Psr7\Stream;

class DetectLivingFaceAdvance {
    public static function createClient($accessKeyId, $accessKeySecret){
        // Initializes a new Config object.
        // This object stores configurations such as your accessKeyId, accessKeySecret, and endpoint.
        $config = new Config([
            "accessKeyId" => $accessKeyId,
            "accessKeySecret" => $accessKeySecret
        ]);
        // The endpoint of the service.
        $config->endpoint = "facebody.cn-shanghai.aliyuncs.com";
        return new Facebody($config);
    }
    public static function main($args){
        // For information about how to create an AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
        // If you use a RAM user's AccessKey pair, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
        // Before running the sample code, make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.
        $accessKeyId = getenv('ALIBABA_CLOUD_ACCESS_KEY_ID');      
        $accessKeySecret = getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET');
        $client = self::createClient($accessKeyId, $accessKeySecret);
        $runtime = new RuntimeOptions([]);
        // Scenario 1: Use a local file.
        $file = fopen('/tmp/DetectLivingFace4.jpg', 'rb');
        $stream = new Stream($file);
        // Scenario 2: Use a publicly accessible URL.
        $file1 = fopen('http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace17.jpg', 'rb');
        $stream1 = new Stream($file1);
        $tasks0 = new tasks([
            "imageURLObject" => $stream
        ]);
        $tasks1 = new tasks([
            "imageURLObject" => $stream1
        ]);
        $detectLivingFaceAdvanceRequest = new DetectLivingFaceAdvanceRequest([
           "tasks" => [
              $tasks0,
              $tasks1
            ]
        ]);
        try {
            $resp = $client->detectLivingFaceAdvance($detectLivingFaceAdvanceRequest, $runtime);
            # Get the entire response.
            echo Utils::toJSONString($resp->body);
        } catch (Exception $exception) {
            # Get the full error message.
            echo Utils::toJSONString($exception);
            # Get a single field.
            echo $exception->getCode();
        }
    }
}
$path = __DIR__ . \DIRECTORY_SEPARATOR . '..' . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
if (file_exists($path)) {
    require_once $path;
}
// $argv is a reserved array for input parameters and does not need to be modified.
DetectLivingFaceAdvance::main(array_slice($argv, 1));
// Add the dependency.
// npm install @alicloud/facebody20191230
// Minimum SDK version required: @alicloud/facebody20191230 version 4.0.7 or later.
// You can find the latest SDK version in this repository: https://npmjs.com/package/@alicloud/facebody20191230
const FacebodyClient = require('@alicloud/facebody20191230');
const OpenapiClient = require('@alicloud/openapi-client');
const TeaUtil = require('@alicloud/tea-util');
const fs = require('fs');
const http = require('http');
const https = require('https');

let config = new OpenapiClient.Config({
    // For information about how to create an AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
    // If you use a RAM user's AccessKey pair, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
    // Before running the sample code, make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.
    accessKeyId: process.env.ALIBABA_CLOUD_ACCESS_KEY_ID,   
    accessKeySecret: process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET
});
// The endpoint of the service.
config.endpoint = `facebody.cn-shanghai.aliyuncs.com`;
const client = new FacebodyClient.default(config);
const getResponse = function (httpClient, url) {
  return new Promise((resolve, reject) => {
    httpClient.get(url, function (response) {
      resolve(response);
    })
  })
}
const request = async function () {
  try {
    const detectLivingFaceAdvanceRequestTasks = new FacebodyClient.DetectLivingFaceAdvanceRequestTasks();
    // Scenario 1: Use a local file.
    // const fileStream = fs.createReadStream('/tmp/DetectLivingFace11.jpg');
    // detectLivingFaceAdvanceRequestTasks.imageURLObject = fileStream;
    // Scenario 2: Use a publicly accessible URL.
    const url = new URL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace17.jpg");
    const httpClient = (url.protocol == "https:") ? https : http;
    detectLivingFaceAdvanceRequestTasks.imageURLObject = await getResponse(httpClient, url);
    let detectLivingFaceAdvanceRequest = new FacebodyClient.DetectLivingFaceAdvanceRequest({
        tasks: [
            detectLivingFaceAdvanceRequestTasks
        ],
    });
    let runtime = new TeaUtil.RuntimeOptions({});
    client.detectLivingFaceAdvance(detectLivingFaceAdvanceRequest, runtime)
        .then(function (detectLivingFaceResponse) {
            // Get the entire response.
            console.log(detectLivingFaceResponse);
            // Get a single field.
            console.log(detectLivingFaceResponse.body.data);
        }, function (error) {
            // Get the full error message.
            console.log(error);
            // Get a single field.
            console.log(error.data.Code);
        });
  } catch (error) {
    console.log(error);
  }
}();
/**
Minimum SDK version required: facebody-20191230 version 4.0.7 or later.
You can find the latest SDK version in this repository: https://pkg.go.dev/github.com/alibabacloud-go/facebody-20191230/v4
Requires the github.com/alibabacloud-go/facebody-20191230 dependency.
We recommend using 'go mod tidy' to install dependencies.
*/

import (
	"fmt"
	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
	facebody20191230 "github.com/alibabacloud-go/facebody-20191230/v4/client"
	util "github.com/alibabacloud-go/tea-utils/v2/service"
	"github.com/alibabacloud-go/tea/tea"
	"net/http"
	"os"
)

func main() { 
       // For information about how to create an AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
       // If you use a RAM user's AccessKey pair, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
       // Before running the sample code, make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.
       accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")  
       accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
       // Initializes a new openapi.Config object. This object stores configurations such as your AccessKey ID, AccessKey Secret, and endpoint.
       config := &openapi.Config{
              AccessKeyId: tea.String(accessKeyId),
              AccessKeySecret: tea.String(accessKeySecret)
	     }
	// The endpoint of the service.
	config.Endpoint = tea.String("facebody.cn-shanghai.aliyuncs.com")
	client, err := facebody20191230.NewClient(config)
	if err != nil {
		panic(err)
	}
	// Scenario 1: Use a local file.
	file, err := os.Open("/tmp/DetectLivingFace18.jpg")
	if err != nil {
		fmt.Println("can not open file", err)
		panic(err)
	}
	// Scenario 2: Use a publicly accessible URL.
	httpClient := http.Client{}
	file1, _ := httpClient.Get("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace17.jpg")
	tasks0 := &facebody20191230.DetectLivingFaceAdvanceRequestTasks{
		ImageURLObject: file,
	}
	tasks1 := &facebody20191230.DetectLivingFaceAdvanceRequestTasks{
		ImageURLObject: file1.Body,
	}
	detectLivingFaceAdvanceRequest := &facebody20191230.DetectLivingFaceAdvanceRequest{
		Tasks: []*facebody20191230.DetectLivingFaceAdvanceRequestTasks{tasks0, tasks1},
	}
	runtime := &util.RuntimeOptions{}
	detectLivingFaceResponse, err := client.DetectLivingFaceAdvance(detectLivingFaceAdvanceRequest, runtime)
	if err != nil {
		// Get the full error message.
		fmt.Println(err.Error())
	} else {
		// Get the entire response.
		fmt.Println(detectLivingFaceResponse)
	}
}
// Add the dependency.
// dotnet add package AlibabaCloud.SDK.Facebody20191230
// Minimum SDK version required: facebody20191230 version 3.0.7 or later.
// You can find the latest SDK version in this repository: https://nuget.org/packages/AlibabaCloud.SDK.Facebody20191230
using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Threading.Tasks;
using AlibabaCloud.SDK.Facebody20191230.Models;
using Tea;
using Tea.Utils;
using static System.Net.WebRequestMethods;

namespace AlibabaCloud.SDK.Sample
{
    public class Sample
    {
      /**
      * Initialize the client with an AccessKey pair.
      * @param accessKeyId
      * @param accessKeySecret
      * @return Client
      * @throws Exception
      */
        public static AlibabaCloud.SDK.Facebody20191230.Client CreateClient(string accessKeyId, string accessKeySecret)
        {
            AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
            {
                AccessKeyId = accessKeyId,
                AccessKeySecret = accessKeySecret,
            };
            // The endpoint of the service.
            config.Endpoint = "facebody.cn-shanghai.aliyuncs.com";
            return new AlibabaCloud.SDK.Facebody20191230.Client(config);
        }

        public static void Main(string[] args)
        {
            // For information about how to create an AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
            // If you use a RAM user's AccessKey pair, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
            // Before running the sample code, make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.
            AlibabaCloud.SDK.Facebody20191230.Client client = CreateClient(System.Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"), System.Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
            AlibabaCloud.SDK.Facebody20191230.Models.DetectLivingFaceAdvanceRequest.DetectLivingFaceAdvanceRequestTasks detectLivingFaceAdvanceRequestTasks1 = new AlibabaCloud.SDK.Facebody20191230.Models.DetectLivingFaceAdvanceRequest.DetectLivingFaceAdvanceRequestTasks();
            // Scenario 1: Use a local file.
            System.IO.StreamReader file = new System.IO.StreamReader(@"/tmp/DetectLivingFace4.jpg");
            detectLivingFaceAdvanceRequestTasks0.ImageURLObject = file.BaseStream;

            // Scenario 2: Use a publicly accessible URL.
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace17.jpg");
            WebResponse response = request.GetResponse();
            Stream stream = response.GetResponseStream();
            detectLivingFaceAdvanceRequestTasks1.ImageURLObject = stream;
            AlibabaCloud.SDK.Facebody20191230.Models.DetectLivingFaceAdvanceRequest detectLivingFaceAdvanceRequest = new AlibabaCloud.SDK.Facebody20191230.Models.DetectLivingFaceAdvanceRequest
            {
                Tasks = new List<AlibabaCloud.SDK.Facebody20191230.Models.DetectLivingFaceAdvanceRequest.DetectLivingFaceAdvanceRequestTasks>
                {
                    detectLivingFaceAdvanceRequestTasks0,
                    detectLivingFaceAdvanceRequestTasks1
                },
            };
            AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
            try
            {
                AlibabaCloud.SDK.Facebody20191230.Models.DetectLivingFaceResponse detectLivingFaceResponse = client.DetectLivingFaceAdvance(detectLivingFaceAdvanceRequest, runtime);
                // Get the entire response.
                Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(detectLivingFaceResponse.Body));
                // Get a single field.
                Console.WriteLine(detectLivingFaceResponse.Body.Data);
            }
            catch (TeaException error)
            {
                Console.WriteLine(error.Message);
            }
            catch (Exception _error)
            {
                TeaException error = new TeaException(new Dictionary<string, object>
            {
                { "message", _error.Message }
          });
                Console.WriteLine(error.Message);
            }
        }
    }
}

FAQ

Does QPS throttling support phone or SMS alerts?

No. Phone or SMS alert configuration is not supported. When your QPS exceeds the limit, the API response body directly returns an error message. You need to implement monitoring and alerting in your own business system based on the returned parameters.

How do I integrate H5/Web face liveness detection?

H5 liveness detection is implemented by calling the Face Liveness Detection API and integrating it on the web frontend. For more information, see Direct calls from a web frontend.

Does face liveness detection support generating a unique feature ID?

No. The platform does not support generating a unique feature ID directly from a photo. We recommend that you combine Face Liveness Detection with Face Search (1:N): use liveness detection to verify that the face is genuine, and then use face search to register the face in a database for comparison and identification. When you register a face, you must specify an ID at the application layer and implement account differentiation logic.