The RecognizeFace API detects five facial attributes: gender, age, expression, glasses, and hat. It also provides a comprehensive quality score based on factors like occlusion, lighting, blur, pose, and noise. The service can analyze images that contain multiple faces. This topic provides code examples in popular programming languages for calling the RecognizeFace API.
-
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.
Overview
For an overview of the RecognizeFace API and its request parameters, see RecognizeFace.
SDK installation
For information about SDK dependencies for popular languages, see SDK Overview.
Configure environment variables
Configure the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables.
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
Open a terminal in IntelliJ IDEA.
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_IDandALIBABA_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.Open File Explorer, right-click This PC, and then select Properties.
In the left-side navigation pane, click Advanced system settings.
On the Advanced tab of the System Properties dialog box, click Environment Variables.
In the Environment Variables dialog box, click New.
In the New System Variable dialog box, add the environment variables
ALIBABA_CLOUD_ACCESS_KEY_IDandALIBABA_CLOUD_ACCESS_KEY_SECRET, and set them to the AccessKey ID and AccessKey Secret that you have prepared.Restart the Windows operating system for the configurations to take effect.
Sample code
OSS bucket
/*
Import dependency packages.
The minimum required SDK version for facebody20191230 is 3.0.7.
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.RecognizeFaceResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaModel;
public class RecognizeFace {
public static com.aliyun.facebody20191230.Client createClient(String accessKeyId, String accessKeySecret) throws Exception {
/*
Initialize the configuration object com.aliyun.teaopenapi.models.Config.
The Config object stores configurations such as your access key ID, access key secret, and endpoint.
*/
com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
.setAccessKeyId(accessKeyId)
.setAccessKeySecret(accessKeySecret);
// The service endpoint.
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 access key ID and an access key secret, see https://help.aliyun.com/document_detail/175144.html.
// If you use the access key of a RAM user, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
// Read the access key ID and access key secret from environment variables. You must configure the environment variables before you run the code example.
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
com.aliyun.facebody20191230.Client client = RecognizeFace.createClient(accessKeyId, accessKeySecret);
com.aliyun.facebody20191230.models.RecognizeFaceRequest recognizeFaceRequest = new com.aliyun.facebody20191230.models.RecognizeFaceRequest()
.setImageURL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png");
com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
try {
// Print the API response.
RecognizeFaceResponse recognizeFaceResponse = client.recognizeFaceWithOptions(recognizeFaceRequest, runtime);
// Get the entire response.
System.out.println(com.aliyun.teautil.Common.toJSONString(TeaModel.buildMap(recognizeFaceResponse)));
} catch (TeaException teaException) {
// Get the complete error message.
System.out.println(com.aliyun.teautil.Common.toJSONString(teaException));
// Get a specific field.
System.out.println(teaException.getCode());
}
}
}
# -*- coding: utf-8 -*-
# Import dependency packages.
# The minimum required SDK version for facebody20191230 is 4.0.8.
# 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.client import Client
from alibabacloud_facebody20191230.models import RecognizeFaceRequest
from alibabacloud_tea_openapi.models import Config
from alibabacloud_tea_util.models import RuntimeOptions
config = Config(
# For information about how to create an access key ID and an access key secret, see https://help.aliyun.com/document_detail/175144.html.
# If you use the access key of a RAM user, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
# Read the access key ID and access key secret from environment variables. You must configure the environment variables before you run the code example.
access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
# The service endpoint.
endpoint='facebody.cn-shanghai.aliyuncs.com',
# The region that corresponds to the endpoint.
region_id='cn-shanghai'
)
recognize_face_request = RecognizeFaceRequest(
image_url='http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png',
age=True,
gender=True,
hat=True,
glass=True,
beauty=True,
expression=True,
mask=True,
quality=True,
max_face_number=2
)
runtime = RuntimeOptions()
try:
# Initialize the client.
client = Client(config)
response = client.recognize_face_with_options(recognize_face_request, runtime)
# Get the entire response.
print(response.body)
except Exception as error:
# Get the complete error message.
print(error)
# Get a specific field.
print(error.code)
# Tip: You can view attribute names by using error.__dict__.
<?php
// Install dependencies.
// The minimum required SDK version for facebody-20191230 is 3.0.8.
// 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 \Exception;
use AlibabaCloud\Tea\Utils\Utils;
use Darabonba\OpenApi\Models\Config;
use AlibabaCloud\SDK\Facebody\V20191230\Models\RecognizeFaceRequest;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
class RecognizeFace {
/**
* Use an access key ID and an access key secret to initialize the client.
* @param string $accessKeyId
* @param string $accessKeySecret
* @return Facebody Client
*/
public static function createClient($accessKeyId, $accessKeySecret){
// Initialize the configuration object Darabonba\OpenApi\Models\Config.
// The Config object stores configurations such as your access key ID, access key secret, and endpoint.
$config = new Config([
"accessKeyId" => $accessKeyId,
"accessKeySecret" => $accessKeySecret
]);
// The service endpoint.
$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 access key ID and an access key secret, see https://help.aliyun.com/document_detail/175144.html.
// If you use the access key of a RAM user, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
// Read the access key ID and access key secret from environment variables. You must configure the environment variables before you run the code example.
$accessKeyId = getenv('ALIBABA_CLOUD_ACCESS_KEY_ID');
$accessKeySecret = getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET');
$client = self::createClient($accessKeyId, $accessKeySecret);
$recognizeFaceRequest = new RecognizeFaceRequest([
"imageURL" => "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png",
"age" => true,
"gender" => true,
"hat" => true,
"glass" => true,
"beauty" => true,
"expression" => true,
"mask" => true,
"quality" => true,
"maxFaceNumber" => 2
]);
$runtime = new RuntimeOptions([]);
try {
$resp = $client->recognizeFaceWithOptions($recognizeFaceRequest, $runtime);
# Get the entire response.
echo Utils::toJSONString($resp->body);
} catch (Exception $exception) {
# Get the complete error message.
echo Utils::toJSONString($exception);
# Get a specific 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. It has no practical purpose and does not need to be modified.
RecognizeFace::main(array_slice($argv, 1));
// Install dependency packages.
// npm install @alicloud/facebody20191230
// The minimum required SDK version for facebody20191230 is 4.0.7.
// 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 access key ID and an access key secret, see https://help.aliyun.com/document_detail/175144.html.
// If you use the access key of a RAM user, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
// Read the access key ID and access key secret from environment variables. You must configure the environment variables before you run the code example.
accessKeyId: process.env.ALIBABA_CLOUD_ACCESS_KEY_ID,
accessKeySecret: process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET
});
// The service endpoint.
config.endpoint = `facebody.cn-shanghai.aliyuncs.com`;
const client = new FacebodyClient.default(config);
let recognizeFaceRequest = new FacebodyClient.RecognizeFaceRequest({
imageURL: "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png",
});
let runtime = new TeaUtil.RuntimeOptions({ });
client.recognizeFaceWithOptions(recognizeFaceRequest, runtime)
.then(function(recognizeFaceResponse) {
// Get the entire response.
console.log(recognizeFaceResponse);
// Get a specific field.
console.log(recognizeFaceResponse.body.data);
}, function(error) {
// Get the complete error message.
console.log(error);
// Get a specific field.
console.log(error.data.Code);
})
/**
The minimum required SDK version for facebody-20191230 is 4.0.7.
You can find the latest SDK version in this repository: https://pkg.go.dev/github.com/alibabacloud-go/facebody-20191230/v4
Depends on github.com/alibabacloud-go/facebody-20191230.
We recommend that you use `go mod tidy` to install the dependency.
*/
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"
)
func main() {
// For information about how to create an access key ID and an access key secret, see https://help.aliyun.com/document_detail/175144.html.
// If you use the access key of a RAM user, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
// Read the access key ID and access key secret from environment variables. You must configure the environment variables before you run the code example.
accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
// Initialize the configuration object &openapi.Config. The Config object stores configurations such as your access key ID, access key secret, and endpoint.
config := &openapi.Config{
AccessKeyId: tea.String(accessKeyId),
AccessKeySecret: tea.String(accessKeySecret)
}
// The service endpoint.
config.Endpoint = tea.String("facebody.cn-shanghai.aliyuncs.com")
client, err := facebody20191230.NewClient(config)
if err != nil {
panic(err)
}
recognizeFaceRequest := &facebody20191230.RecognizeFaceRequest{
ImageURL: tea.String("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png"),
}
runtime := &util.RuntimeOptions{}
recognizeFaceResponse, err := client.RecognizeFaceWithOptions(recognizeFaceRequest, runtime)
if err != nil {
// Get the complete error message.
fmt.Println(err.Error())
} else {
// Get the entire response.
fmt.Println(recognizeFaceResponse)
}
}
// Install dependency packages.
// dotnet add package AlibabaCloud.SDK.Facebody20191230
// The minimum required SDK version for facebody20191230 is 3.0.7.
// 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
{
/**
* Use an access key ID and an access key secret to initialize the client.
* @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 service endpoint.
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 access key ID and an access key secret, see https://help.aliyun.com/document_detail/175144.html.
// If you use the access key of a RAM user, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
// Read the access key ID and access key secret from environment variables. You must configure the environment variables before you run the code example.
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.RecognizeFaceRequest recognizeFaceRequest = new AlibabaCloud.SDK.Facebody20191230.Models.RecognizeFaceRequest
{
ImageURL = "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png",
};
AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
try
{
AlibabaCloud.SDK.Facebody20191230.Models.RecognizeFaceResponse recognizeFaceResponse = client.RecognizeFaceWithOptions(recognizeFaceRequest, runtime);
// Get the entire response.
Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(recognizeFaceResponse.Body));
// Get a specific field.
Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(recognizeFaceResponse.Body.Data));
}
catch (TeaException error)
{
// Print the error details.
Console.WriteLine(AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message));
}
catch (Exception _error)
{
TeaException error = new TeaException(new Dictionary<string, object>
{
{ "message", _error.Message }
});
// Print the error details.
Console.WriteLine(AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message));
}
}
}
}
Local file or public URL
/*
Import dependency packages.
The minimum required SDK version for facebody20191230 is 3.0.7.
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.RecognizeFaceResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaModel;
import java.io.InputStream;
import java.net.URL;
public class RecognizeFace {
public static com.aliyun.facebody20191230.Client createClient(String accessKeyId, String accessKeySecret) throws Exception {
/*
Initialize the configuration object com.aliyun.teaopenapi.models.Config.
The Config object stores configurations such as your access key ID, access key secret, and endpoint.
*/
com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
.setAccessKeyId(accessKeyId)
.setAccessKeySecret(accessKeySecret);
// The service endpoint.
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 access key ID and an access key secret, see https://help.aliyun.com/document_detail/175144.html.
// If you use the access key of a RAM user, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
// Read the access key ID and access key secret from environment variables. You must configure the environment variables before you run the code example.
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
com.aliyun.facebody20191230.Client client = RecognizeFace.createClient(accessKeyId, accessKeySecret);
// Scenario 1: Use a local file.
// InputStream inputStream = new FileInputStream(new File("/tmp/recognizeFace.png"));
// Scenario 2: Use any publicly accessible URL.
URL url = new URL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png");
InputStream inputStream = url.openConnection().getInputStream();
com.aliyun.facebody20191230.models.RecognizeFaceAdvanceRequest recognizeFaceAdvanceRequest = new com.aliyun.facebody20191230.models.RecognizeFaceAdvanceRequest()
.setImageURLObject(inputStream);
com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
try {
// Print the API response.
RecognizeFaceResponse recognizeFaceResponse = client.recognizeFaceAdvance(recognizeFaceAdvanceRequest, runtime);
// Get the entire response.
System.out.println(com.aliyun.teautil.Common.toJSONString(TeaModel.buildMap(recognizeFaceResponse)));
} catch (TeaException teaException) {
// Get the complete error message.
System.out.println(com.aliyun.teautil.Common.toJSONString(teaException));
// Get a specific field.
System.out.println(teaException.getCode());
}
}
}
# -*- coding: utf-8 -*-
# Import dependency packages.
# The minimum required SDK version for facebody20191230 is 4.0.8.
# 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.client import Client
from alibabacloud_facebody20191230.models import RecognizeFaceAdvanceRequest
from alibabacloud_tea_openapi.models import Config
from alibabacloud_tea_util.models import RuntimeOptions
config = Config(
# For information about how to create an access key ID and an access key secret, see https://help.aliyun.com/document_detail/175144.html.
# If you use the access key of a RAM user, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
# Read the access key ID and access key secret from environment variables. You must configure the environment variables before you run the code example.
access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
# The service endpoint.
endpoint='facebody.cn-shanghai.aliyuncs.com',
# The region that corresponds to the endpoint.
region_id='cn-shanghai'
)
# Scenario 1: The file is stored locally.
# stream = open(r'/tmp/RecognizeFace1.png', 'rb')
# Scenario 2: Use any publicly accessible URL.
url = 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png'
img = urlopen(url).read()
recognize_face_request = RecognizeFaceAdvanceRequest(
# Code for using a local file.
# image_urlobject=stream,
image_urlobject=io.BytesIO(img),
age=True,
gender=True,
hat=True,
glass=True,
beauty=True,
expression=True,
mask=True,
quality=True,
max_face_number=2
)
runtime = RuntimeOptions()
try:
# Initialize the client.
client = Client(config)
response = client.recognize_face_advance(recognize_face_request, runtime)
# Get the entire response.
print(response.body)
except Exception as error:
# Get the complete error message.
print(error)
# Get a specific field.
print(error.code)
# Tip: You can view attribute names by using error.__dict__.
# Close the stream.
# stream.close()
<?php
// Install dependencies.
// The minimum required SDK version for facebody-20191230 is 3.0.8.
// 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 \Exception;
use AlibabaCloud\Tea\Utils\Utils;
use Darabonba\OpenApi\Models\Config;
use AlibabaCloud\SDK\Facebody\V20191230\Models\RecognizeFaceAdvanceRequest;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
use GuzzleHttp\Psr7\Stream;
class RecognizeFaceAdvance {
/**
* Use an access key ID and an access key secret to initialize the client.
* @param string $accessKeyId
* @param string $accessKeySecret
* @return Facebody Client
*/
public static function createClient($accessKeyId, $accessKeySecret){
// Initialize the configuration object Darabonba\OpenApi\Models\Config.
// The Config object stores configurations such as your access key ID, access key secret, and endpoint.
$config = new Config([
"accessKeyId" => $accessKeyId,
"accessKeySecret" => $accessKeySecret
]);
// The service endpoint.
$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 access key ID and an access key secret, see https://help.aliyun.com/document_detail/175144.html.
// If you use the access key of a RAM user, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
// Read the access key ID and access key secret from environment variables. You must configure the environment variables before you run the code example.
$accessKeyId = getenv('ALIBABA_CLOUD_ACCESS_KEY_ID');
$accessKeySecret = getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET');
$client = self::createClient($accessKeyId, $accessKeySecret);
// Scenario 1: Use a local file.
//$file = fopen('/tmp/RecognizeFace1.png', 'rb');
//$stream = new Stream($file);
// Scenario 2: Use any publicly accessible URL.
$file = fopen('http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png', 'rb');
$stream = new Stream($file);
$recognizeFaceAdvanceRequest = new RecognizeFaceAdvanceRequest([
"imageURLObject" => $stream,
"age" => true,
"gender" => true,
"hat" => true,
"glass" => true,
"beauty" => true,
"expression" => true,
"mask" => true,
"quality" => true,
"maxFaceNumber" => 2
]);
$runtime = new RuntimeOptions([]);
try {
$resp = $client->recognizeFaceAdvance($recognizeFaceAdvanceRequest, $runtime);
# Get the entire response.
echo Utils::toJSONString($resp->body);
} catch (Exception $exception) {
# Get the complete error message.
echo Utils::toJSONString($exception);
# Get a specific 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. It has no practical purpose and does not need to be modified.
RecognizeFaceAdvance::main(array_slice($argv, 1));
// Install dependencies.
// npm install @alicloud/facebody20191230
// The minimum required SDK version for facebody20191230 is 4.0.7.
// 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 access key ID and an access key secret, see https://help.aliyun.com/document_detail/175144.html.
// If you use the access key of a RAM user, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
// Read the access key ID and access key secret from environment variables. You must configure the environment variables before you run the code example.
accessKeyId: process.env.ALIBABA_CLOUD_ACCESS_KEY_ID,
accessKeySecret: process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET
});
// The service endpoint.
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 {
let recognizeFaceAdvanceRequest = new FacebodyClient.RecognizeFaceAdvanceRequest();
// Scenario 1: Use a local file.
// const fileStream = fs.createReadStream('/tmp/RecognizeFace1.png');
// recognizeFaceAdvanceRequest.imageURLObject = fileStream;
// Scenario 2: Use any publicly accessible URL.
const url = new URL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png");
const httpClient = (url.protocol == "https:") ? https : http;
recognizeFaceAdvanceRequest.imageURLObject = await getResponse(httpClient, url);
let runtime = new TeaUtil.RuntimeOptions({});
client.recognizeFaceAdvance(recognizeFaceAdvanceRequest, runtime)
.then(function(recognizeFaceResponse) {
// Get the entire response.
console.log(recognizeFaceResponse);
// Get a specific field.
console.log(recognizeFaceResponse.body.data);
}, function(error) {
// Get the complete error message.
console.log(error);
// Get a specific field.
console.log(error.data.Code);
})
} catch (error) {
console.log(error);
}
}();
/**
The minimum required SDK version for facebody-20191230 is 4.0.7.
You can find the latest SDK version in this repository: https://pkg.go.dev/github.com/alibabacloud-go/facebody-20191230/v4
Depends on github.com/alibabacloud-go/facebody-20191230.
We recommend that you use `go mod tidy` to install the dependency.
*/
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"
)
func main() {
// For information about how to create an access key ID and an access key secret, see https://help.aliyun.com/document_detail/175144.html.
// If you use the access key of a RAM user, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
// Read the access key ID and access key secret from environment variables. You must configure the environment variables before you run the code example.
accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
// Initialize the configuration object &openapi.Config. The Config object stores configurations such as your access key ID, access key secret, and endpoint.
config := &openapi.Config{
AccessKeyId: tea.String(accessKeyId),
AccessKeySecret: tea.String(accessKeySecret)
}
// The service endpoint.
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/RecognizeFace.png")
//if err != nil {
// fmt.Println("can not open file", err)
// panic(err)
//}
//recognizeFaceAdvanceRequest := &facebody20191230.RecognizeFaceAdvanceRequest{
// ImageURLObject: file,
//}
// Scenario 2: Use any publicly accessible URL.
httpClient := http.Client{}
file, _ := httpClient.Get("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png")
recognizeFaceAdvanceRequest := &facebody20191230.RecognizeFaceAdvanceRequest{
ImageURLObject: file.Body,
}
runtime := &util.RuntimeOptions{}
recognizeFaceAdvanceResponse, err := client.RecognizeFaceAdvance(recognizeFaceAdvanceRequest, runtime)
if err != nil {
// Get the complete error message.
fmt.Println(err.Error())
} else {
// Get the entire response.
fmt.Println(recognizeFaceAdvanceResponse)
}
}
// Install dependency packages.
// dotnet add package AlibabaCloud.SDK.Facebody20191230
// The minimum required SDK version for facebody20191230 is 3.0.7.
// 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;
namespace AlibabaCloud.SDK.Sample
{
public class Sample
{
/**
* Use an access key ID and an access key secret to initialize the client.
* @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 service endpoint.
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 access key ID and an access key secret, see https://help.aliyun.com/document_detail/175144.html.
// If you use the access key of a RAM user, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
// Read the access key ID and access key secret from environment variables. You must configure the environment variables before you run the code example.
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.RecognizeFaceAdvanceRequest recognizeFaceAdvanceRequest = new AlibabaCloud.SDK.Facebody20191230.Models.RecognizeFaceAdvanceRequest
();
// Scenario 1: Use a local file.
// System.IO.StreamReader file = new System.IO.StreamReader(@"/tmp/RecognizeFace1.png");
// recognizeFaceAdvanceRequest.ImageURLObject = file.BaseStream;
// Scenario 2: Use any publicly accessible URL.
HttpWebRequest request = (HttpWebRequest)WebRequest.Create("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeFace/RecognizeFace1.png");
WebResponse response = request.GetResponse();
Stream stream = response.GetResponseStream();
recognizeFaceAdvanceRequest.ImageURLObject = stream;
AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
try
{
AlibabaCloud.SDK.Facebody20191230.Models.RecognizeFaceResponse recognizeFaceResponse = client.RecognizeFaceAdvance(recognizeFaceAdvanceRequest, runtime);
// Get the entire response.
Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(recognizeFaceResponse.Body));
// Get a specific field.
Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(recognizeFaceResponse.Body.Data));
}
catch (TeaException error)
{
// Print the error details.
Console.WriteLine(AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message));
}
catch (Exception _error)
{
TeaException error = new TeaException(new Dictionary<string, object>
{
{ "message", _error.Message }
});
// Print the error details.
Console.WriteLine(AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message));
}
}
}
}