AddFaceImageTemplate

更新时间:
复制 MD 格式

The AddFaceImageTemplate operation lets you add a face image that has passed content moderation to serve as a template for the face merge feature. This topic provides sample code for the AddFaceImageTemplate operation in several 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.

Overview

For an overview of the AddFaceImageTemplate capability and its request parameters, see AddFaceImageTemplate.

Install the SDK package

For information about the 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.

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

OSS file in Shanghai

/*
<!-- 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.AddFaceImageTemplateResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaModel;

public class AddMergeImageFace {
    public static com.aliyun.facebody20191230.Client createClient(String accessKeyId, String accessKeySecret) throws Exception {
        /*
          Initialize the configuration object com.aliyun.teaopenapi.models.Config.
          This object stores configuration parameters such as your accessKeyId, accessKeySecret, 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 AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
        // If you use a RAM user's AccessKey, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
        // Read the AccessKey ID and AccessKey Secret from environment variables. Before you run the sample code, you must configure the environment variables.
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"); 
        com.aliyun.facebody20191230.Client client = AddMergeImageFace.createClient(accessKeyId, accessKeySecret);
        com.aliyun.facebody20191230.models.AddFaceImageTemplateRequest addFaceImageTemplateRequest = new com.aliyun.facebody20191230.models.AddFaceImageTemplateRequest()
                .setImageURL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png");
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
        try {
            // After you copy the code and run it, the API response is printed.
            AddFaceImageTemplateResponse addFaceImageTemplateResponse = client.addFaceImageTemplateWithOptions(addFaceImageTemplateRequest, runtime);
            // Get the complete response.
            System.out.println(com.aliyun.teautil.Common.toJSONString(TeaModel.buildMap(addFaceImageTemplateResponse)));
            // Get a specific field from the response.
            System.out.println(addFaceImageTemplateResponse.getBody().getData());
        } catch (TeaException teaException) {
            // Get the complete error information.
            System.out.println(com.aliyun.teautil.Common.toJSONString(teaException));
            // Get a specific field from the error.
            System.out.println(teaException.getCode());
        }
    }
}
# -*- coding: utf-8 -*-
# Import the required packages.
# pip install alibabacloud_facebody20191230

import os
from alibabacloud_facebody20191230.client import Client
from alibabacloud_facebody20191230.models import AddFaceImageTemplateRequest
from alibabacloud_tea_openapi.models import Config
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, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
  # Read the AccessKey ID and AccessKey Secret from environment variables. Before you run the sample code, you must configure the environment variables.
  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 ID that corresponds to the endpoint.
  region_id='cn-shanghai'
)
runtime_option = RuntimeOptions()
add_face_image_template_request = AddFaceImageTemplateRequest(
    image_url='http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png'
)
try:
  # Initialize the client.
  client = Client(config)
  response = client.add_face_image_template_with_options(add_face_image_template_request, runtime_option)
  # Get the complete response.
  print(response.body)
  # Tip: You can view attribute names by using response.body.__dict__.
except Exception as error:
  # Get the complete error information.
  print(error)
  # Get a specific field from the error.
  print(error.code)
  # Tip: You can view attribute names by using error.__dict__.
<?php

// Install the dependency package.
//composer require alibabacloud/facebody-20191230
  
use AlibabaCloud\SDK\Facebody\V20191230\Facebody;
use AlibabaCloud\SDK\Facebody\V20191230\Models\AddFaceImageTemplateRequest;
use \Exception;
use AlibabaCloud\Tea\Utils\Utils;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
use Darabonba\OpenApi\Models\Config;

class AddFaceImageTemplate{
/**
     * Initialize the client with an AccessKey pair.
     * @param string $accessKeyId
     * @param string $accessKeySecret
     * @return Facebody Client
     */
    public static function createClient($accessKeyId, $accessKeySecret){
        // Initialize the configuration object Darabonba\OpenApi\Models\Config.
        // This object stores configuration parameters such as your accessKeyId, accessKeySecret, 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 AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
        // If you use a RAM user's AccessKey, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
        // Read the AccessKey ID and AccessKey Secret from environment variables. Before you run the sample code, you must configure the environment variables.
        $accessKeyId = getenv('ALIBABA_CLOUD_ACCESS_KEY_ID');
        $accessKeySecret = getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET'); 
        $client = self::createClient($accessKeyId, $accessKeySecret);
        $addFaceImageTemplateRequest = new AddFaceImageTemplateRequest([
            "imageURL" => "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png"
        ]);
        $runtime = new RuntimeOptions([]);
        try {
            $resp = $client->addFaceImageTemplateWithOptions($addFaceImageTemplateRequest, $runtime);
            # Get the complete response.
            echo Utils::toJSONString($resp->body);
        } catch (Exception $exception) {
            # Get the complete error information.
            echo Utils::toJSONString($exception);
            # Get a specific field from the error.
            echo $exception->getCode();
        }
    }
}
$path = __DIR__ . \DIRECTORY_SEPARATOR . '..' . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
if (file_exists($path)) {
    require_once $path;
}
AddFaceImageTemplate::main(array_slice($argv, 1));
// Install the dependency package.
//npm install @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, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
  // Read the AccessKey ID and AccessKey Secret from environment variables. Before you run the sample code, you must configure the environment variables. 
  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 addFaceImageTemplateRequest = new FacebodyClient.AddFaceImageTemplateRequest({
  imageURL: "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png",
});
let runtime = new TeaUtil.RuntimeOptions({ });
client.addFaceImageTemplateWithOptions(addFaceImageTemplateRequest, runtime)
  .then(function(addFaceImageTemplateResponse) {
    // Get the complete response.
    console.log(addFaceImageTemplateResponse);
    // Get a specific field from the response.
    console.log(addFaceImageTemplateResponse.body.data);
  }, function(error) {
    // Get the complete error information.
    console.log(error);
    // Get a specific field from the error.
    console.log(error.data.Code);
  })
/**
This example depends on github.com/alibabacloud-go/facebody-20191230/v4.
We recommend that you use `go mod tidy` to install the dependency.
 */

package main

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"
	"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, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
  // Read the AccessKey ID and AccessKey Secret from environment variables. Before you run the sample code, you must configure the environment variables.
  accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")  
  accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
  // Initialize the configuration object &openapi.Config.
  // This object stores configuration parameters such as your AccessKeyId, AccessKeySecret, 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)
	}
	addFaceImageTemplateRequest := &facebody20191230.AddFaceImageTemplateRequest{
		ImageURL: tea.String("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png"),
	}
	runtime := &util.RuntimeOptions{}
	addFaceImageTemplateResponse, err := client.AddFaceImageTemplateWithOptions(addFaceImageTemplateRequest, runtime)
	if err != nil {
		// Get the complete error information.
		fmt.Println(err.Error())
	} else {
		// Get the complete response.
		fmt.Println(addFaceImageTemplateResponse)
	}
}
 // Install the dependency.
// dotnet add package 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
    {
      /**
      * 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
            {
              // Your AccessKey ID.
              AccessKeyId = accessKeyId,
              // Your AccessKey Secret.
              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 AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
            // If you use a RAM user's AccessKey, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
            // Read the AccessKey ID and AccessKey Secret from environment variables. Before you run the sample code, you must configure the environment variables.
            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.AddFaceImageTemplateRequest addFaceImageTemplateRequest = new AlibabaCloud.SDK.Facebody20191230.Models.AddFaceImageTemplateRequest
            {
              ImageURL = "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png",
            };
           	AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
            try
            {
              AlibabaCloud.SDK.Facebody20191230.Models.AddFaceImageTemplateResponse addFaceImageTemplatResponse = client.AddFaceImageTemplateWithOptions(addFaceImageTemplateRequest, runtime);
              // Get the complete response.
              Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(addFaceImageTemplatResponse.Body));
              // Get a specific field from the response.
              Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(addFaceImageTemplatResponse.Body.Data));
            }
          	catch (TeaException error)
            {
              // Get the complete error information.
              Console.WriteLine(error.Message);
            }
          	catch (Exception _error)
            {
              TeaException error = new TeaException(new Dictionary<string, object>
              {
                { "message", _error.Message }
              });
              // Get the complete error information.
              Console.WriteLine(error.Message);
            }
        }
    }
}

Local file or public URL

/*
<!-- 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.AddFaceImageTemplateResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaModel;

import java.io.InputStream;
import java.net.URL;

public class AddMergeImageFace {
    public static com.aliyun.facebody20191230.Client createClient(String accessKeyId, String accessKeySecret) throws Exception {
        /*
          Initialize the configuration object com.aliyun.teaopenapi.models.Config.
          This object stores configuration parameters such as your accessKeyId, accessKeySecret, 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 AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
        // If you use a RAM user's AccessKey, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
        // Read the AccessKey ID and AccessKey Secret from environment variables. Before you run the sample code, you must configure the environment variables.
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"); 
        com.aliyun.facebody20191230.Client client = AddMergeImageFace.createClient(accessKeyId, accessKeySecret);
        // Scenario 1: Use a local file.
        // InputStream inputStream = new FileInputStream(new File("/tmp/AddMergeImageFace.jpg"));
        // Scenario 2: Use a publicly accessible URL.
        URL url = new URL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png");
        InputStream inputStream = url.openConnection().getInputStream();
        com.aliyun.facebody20191230.models.AddFaceImageTemplateAdvanceRequest addFaceImageTemplateAdvanceRequest = new com.aliyun.facebody20191230.models.AddFaceImageTemplateAdvanceRequest()
                .setImageURLObject(inputStream);
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
        try {
            AddFaceImageTemplateResponse addFaceImageTemplateResponse = client.addFaceImageTemplateAdvance(addFaceImageTemplateAdvanceRequest, runtime);
            // Get the complete response.
            System.out.println(com.aliyun.teautil.Common.toJSONString(TeaModel.buildMap(addFaceImageTemplateResponse)));
            // Get a specific field from the response.
            System.out.println(addFaceImageTemplateResponse.getBody().getData());
        } catch (TeaException teaException) {
            // Get the complete error information.
            System.out.println(com.aliyun.teautil.Common.toJSONString(teaException));
            // Get a specific field from the error.
            System.out.println(teaException.getCode());
        }
    }
}
# -*- coding: utf-8 -*-
# Import the required packages.
# pip install alibabacloud_facebody20191230

import os
import io
from urllib.request import urlopen
from alibabacloud_facebody20191230.client import Client
from alibabacloud_facebody20191230.models import AddFaceImageTemplateAdvanceRequest
from alibabacloud_tea_openapi.models import Config
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, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
  # Read the AccessKey ID and AccessKey Secret from environment variables. Before you run the sample code, you must configure the environment variables.
  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 ID that corresponds to the endpoint.
  region_id='cn-shanghai'
)
# Scenario 1: Use a local file.
#stream = open(r'/tmp/AddFaceImageTemplate.jpg', 'rb')
#add_face_image_template_request = AddFaceImageTemplateAdvanceRequest()
#add_face_image_template_request.image_urlobject = stream

# Scenario 2: Use a publicly accessible URL.
url = 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png'
img = urlopen(url).read()
add_face_image_template_request = AddFaceImageTemplateAdvanceRequest()
add_face_image_template_request.image_urlobject = io.BytesIO(img)

runtime_option = RuntimeOptions()
try:
  # Initialize the client.
  client = Client(config)
  response = client.add_face_image_template_advance(add_face_image_template_request, runtime_option)
  # Get the complete response.
  print(response.body)
  # Tip: You can view attribute names by using response.body.__dict__.
except Exception as error:
  # Get the complete error information.
  print(error)
  # Get a specific field from the error.
  print(error.code)
  # Tip: You can view attribute names by using error.__dict__.

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

// Install the dependency package.
//composer require alibabacloud/facebody-20191230
  
use AlibabaCloud\SDK\Facebody\V20191230\Facebody;
use AlibabaCloud\SDK\Facebody\V20191230\Models\AddFaceImageTemplateAdvanceRequest;
use AlibabaCloud\Tea\Utils\Utils;
use \Exception;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
use Darabonba\OpenApi\Models\Config;
use GuzzleHttp\Psr7\Stream;

class AddFaceImageTemplateAdvance{
/**
     * Initialize the client with an AccessKey pair.
     * @param string $accessKeyId
     * @param string $accessKeySecret
     * @return Facebody Client
     */
    public static function createClient($accessKeyId, $accessKeySecret){
        // Initialize the configuration object Darabonba\OpenApi\Models\Config.
        // This object stores configuration parameters such as your accessKeyId, accessKeySecret, 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 AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
        # If you use a RAM user's AccessKey, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
        // Read the AccessKey ID and AccessKey Secret from environment variables. Before you run the sample code, you must configure the environment variables.
        $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/AddFaceImageTemplate.jpg', 'rb');
        // Scenario 2: Use a publicly accessible URL.
        $file = fopen('http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png', 'rb');
        $stream = new Stream($file);
        $addFaceImageTemplateRequest = new AddFaceImageTemplateAdvanceRequest([
            "imageURLObject" => $stream
        ]);
        $runtime = new RuntimeOptions([]);
        try {
            $resp = $client->addFaceImageTemplateAdvance($addFaceImageTemplateRequest, $runtime);
            # Get the complete response.
            echo Utils::toJSONString($resp->body);
        } catch (Exception $exception) {
            # Get the complete error information.
            echo Utils::toJSONString($exception);
            # Get a specific field from the error.
            echo $exception->getCode();
        }
    }
}
$path = __DIR__ . \DIRECTORY_SEPARATOR . '..' . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
if (file_exists($path)) {
    require_once $path;
}
AddFaceImageTemplateAdvance::main(array_slice($argv, 1));
// Install the dependency package.
//npm install @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, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
  // Read the AccessKey ID and AccessKey Secret from environment variables. Before you run the sample code, you must configure the environment variables. 
  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 addFaceImageTemplateRequest = new FacebodyClient.AddFaceImageTemplateRequest();
    // Scenario 1: Use a local file.
    // const fileStream = fs.createReadStream('/tmp/MergeImageFace-mb1.png');
    // addFaceImageTemplateRequest.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/MergeImageFace/MergeImageFace-1.png");
    const httpClient = (url.protocol == "https:") ? https : http;
    addFaceImageTemplateRequest.imageURLObject = await getResponse(httpClient, url);
    let runtime = new TeaUtil.RuntimeOptions({});
    client.addFaceImageTemplateAdvance(addFaceImageTemplateRequest, runtime)
      .then(function (addFaceImageTemplateResponse) {
        // Get the complete response.
        console.log(addFaceImageTemplateResponse);
        // Get a specific field from the response.
        console.log(addFaceImageTemplateResponse.body.data);
      }, function (error) {
        // Get the complete error information.
        console.log(error);
        // Get a specific field from the error.
        console.log(error.data.Code);
      });
  } catch (error) {
    console.log(error);
  }
}();
/**
This example depends on github.com/alibabacloud-go/facebody-20191230/v4.
We recommend that you use `go mod tidy` to install the dependency.
 */

package main

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, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
  // Read the AccessKey ID and AccessKey Secret from environment variables. Before you run the sample code, you must configure the environment variables.
  accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")  
  accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
  // Initialize the configuration object &openapi.Config.
  // This object stores configuration parameters such as your AccessKeyId, AccessKeySecret, 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/AddFaceImageTemplate.jpg")
	//if err != nil {
	//	fmt.Println("can not open file", err)
	//	panic(err)
	//}
	//addFaceImageTemplateAdvanceRequest := &facebody20191230.AddFaceImageTemplateAdvanceRequest{
	//	ImageURLObject: file,
	//}
	// Scenario 2: Use a publicly accessible URL.
	httpClient := http.Client{}
	file, _ := httpClient.Get("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png")
	addFaceImageTemplateAdvanceRequest := &facebody20191230.AddFaceImageTemplateAdvanceRequest{
		ImageURLObject: file.Body,
	}
	runtime := &util.RuntimeOptions{}
	addFaceImageTemplateAdvanceResponse, err := client.AddFaceImageTemplateAdvance(addFaceImageTemplateAdvanceRequest, runtime)
	if err != nil {
		// Get the complete error information.
		fmt.Println(err.Error())
	} else {
		// Get the complete response.
		fmt.Println(addFaceImageTemplateAdvanceResponse)
	}
}
// Install the dependency.
// dotnet add package 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
    {
        /**
            * 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 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 AccessKey pair, see https://help.aliyun.com/document_detail/175144.html.
            // If you use a RAM user's AccessKey, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
            // Read the AccessKey ID and AccessKey Secret from environment variables. Before you run the sample code, you must configure the environment variables.
            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.AddFaceImageTemplateAdvanceRequest addFaceImageTemplateAdvanceRequest = new AlibabaCloud.SDK.Facebody20191230.Models.AddFaceImageTemplateAdvanceRequest();
            // Scenario 1: Use a local file.
            //System.IO.StreamReader file = new System.IO.StreamReader(@"/tmp/template.jpg");
            //addFaceImageTemplateAdvanceRequest.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/MergeImageFace/MergeImageFace-1.png");
            WebResponse response = request.GetResponse();
            Stream stream = response.GetResponseStream();
            addFaceImageTemplateAdvanceRequest.ImageURLObject = stream;

            AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
            try
            {
                AlibabaCloud.SDK.Facebody20191230.Models.AddFaceImageTemplateResponse adFaceImageTemplateResponse = client.AddFaceImageTemplateAdvance(addFaceImageTemplateAdvanceRequest, runtime);
                // Get the complete response.
                Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(adFaceImageTemplateResponse.Body));
                // Get a specific field from the response.
                Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(adFaceImageTemplateResponse.Body.Data));
            }
            catch (TeaException error)
            {
                // Get the complete error information.
                Console.WriteLine(error.Message);
            }
            catch (Exception _error)
            {
                TeaException error = new TeaException(new Dictionary<string, object>
                {
                  { "message", _error.Message }
                });
                // Get the complete error information.
                Console.WriteLine(error.Message);
            }
        }
    }
}