本文介绍了金融级人脸比对方案的Python SDK调用示例。

SDK使用说明

如果需要其他语言的SDK示例代码,您可以通过OpenAPI开发者门户在线调试工具调试API接口。该工具会自动生成相应API的SDK调用示例代码。

详细信息,请参见调试CompareFaceVerify接口

前提条件

  • 需要使用的Python版本在3.0版本及以上。
  • 已添加认证场景,并获取对应的场景ID。具体操作,请参见添加认证场景

引入依赖包

pip install alibabacloud_tea_openapi==0.2.5

安装SDK

关于Python SDK源代码,请参见Python SDK包

pip install alibabacloud_cloudauth20190307==1.0.5

调用示例

CompareFaceVerify接口调用示例

关于参数的具体描述,请参见纯服务端(API)接入

from alibabacloud_cloudauth20190307.client import Client as CloudauthClient
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_cloudauth20190307 import models as cloudauth_models
from alibabacloud_tea_util.client import Client as UtilClient
from alibabacloud_tea_util import models as util_models


class CompareFaceVerify:
    def __init__(self):
        pass

    @staticmethod
    def create_client(
        endpoint: str,
    ) -> CloudauthClient:
        config = open_api_models.Config(
            # 您的AccessKey ID。
            access_key_id='您的AccessKey ID',
            # 您的AccessKey Secret。
            access_key_secret='您的AccessKey Secret',
            # 设置HTTP代理。
            # http_proxy='http://xx.xx.xx.xx:xxxx',
            # 设置HTTPS代理。
            # https_proxy='https://xx.xx.xx.xx:xxxx',
            endpoint=endpoint
        )
        return CloudauthClient(config)

    @staticmethod
    def main() -> None:
        request = cloudauth_models.CompareFaceVerifyRequest(
            # 请输入场景ID。
            scene_id=xxx,
            outer_order_no='商户请求的唯一标识',
            product_code='PV_FC',
            
            # 请在以下四种传入人脸照片方式中,选择一种。
            # 1.照片Base64编码。
            # 2.照片OSS Bucket名和文件名。
            # 3.照片OSS的URL地址。
            # 4.已经实人认证通过的CertifyId。
            
            # 方式一:照片Base64。
            # source_face_contrast_picture='人脸照片Base64编码',
            # 方式二:照片OSS Bucket名和文件名。
            # source_oss_bucket_name='cn-shanghai-aliyun-cloudauth-xxxxx',
            # source_oss_object_name='verify/xxxxx/xxxxxx.jpeg',
            # 方式三:照片OSS的URL地址,公网可访问。
            source_face_contrast_picture_url='https=//cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg',
            # 方式四:已经实人认证通过的CertifyId。
            # source_certify_id='0bfa7c493f850e5178b9f8613634c9xx',
            
            # 请在以下四种传入底库人脸照片方式中,选择一种:
            # 1.照片Base64编码。
            # 2.照片OSS Bucket名和文件名。
            # 3.照片OSS的URL地址。
            # 4.已经实人认证通过的CertifyId。
            
            # 方式一:照片Base64。
            # target_face_contrast_picture='底库人脸照片Base64编码'
            # 方式二:照片OSS Bucket名和文件名。
            # target_oss_bucket_name='cn-shanghai-aliyun-cloudauth-xxxxx',
            # target_oss_object_name='verify/xxxxx/xxxxxx.jpeg',
            # 方式三:照片OSS的URL地址,公网可访问。
            target_face_contrast_picture_url='https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg',
            # 方式四:已经实人认证通过的CertifyId。
            # target_certify_id='0bfa7c493f850e5178b9f8613634c9xx'
        )
        response = CompareFaceVerify.compare_face_verify_auto_route(request)
        # 不支持服务自动路由。
        # response = CompareFaceVerify.compare_face_verify('cloudauth.cn-shanghai.aliyuncs.com', request)
        print(response.request_id)
        print(response.code)
        print(response.message)
        print(response.result_object.passed)
        print(response.result_object.verify_score)
        print(response.result_object.certify_id)

    @staticmethod
    def compare_face_verify_auto_route(
        request: cloudauth_models.CompareFaceVerifyRequest,
    ) -> cloudauth_models.CompareFaceVerifyResponse:
        endpoints = [
            'cloudauth.cn-shanghai.aliyuncs.com',
            'cloudauth.cn-beijing.aliyuncs.com'
        ]
        for endpoint in endpoints:
            try:
                response = CompareFaceVerify.compare_face_verify(endpoint, request)
                if UtilClient.equal_string('500', response.code):
                    continue
                return response
            except Exception as err:
                    continue
        return None

    @staticmethod
    def compare_face_verify(
        endpoint: str,
        request: cloudauth_models.CompareFaceVerifyRequest,
    ) -> cloudauth_models.CompareFaceVerifyResponse:
        client = CompareFaceVerify.create_client(endpoint)
        # 创建RuntimeObject实例并设置运行参数。
        runtime = util_models.RuntimeOptions()
        runtime.read_timeout = 10000
        runtime.connect_timeout = 10000
        return client.compare_face_verify(request, runtime)

if __name__ == '__main__':
    CompareFaceVerify.main()