@alicloud/cloudauth20190307 3.9.1 → 3.9.3

package/dist/client.js

@@ -35,17 +35,10 @@ var __importStar = (this && this.__importStar) || (function () {
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 // This file is auto-generated, don't edit it
 const $dara = __importStar(require("@darabonba/typescript"));
-const oss_client_1 = __importStar(require("@alicloud/oss-client")), $OSS = oss_client_1;
-const openplatform20191219_1 = __importStar(require("@alicloud/openplatform20191219")), $OpenPlatform = openplatform20191219_1;
-const $OSSUtil = __importStar(require("@alicloud/oss-util"));
-const $FileForm = __importStar(require("@alicloud/tea-fileform"));
-const openapi_core_1 = __importDefault(require("@alicloud/openapi-core"));
+const openapi_core_1 = __importStar(require("@alicloud/openapi-core")), $OpenApi = openapi_core_1;
 const openapi_core_2 = require("@alicloud/openapi-core");
 const $_model = __importStar(require("./models/model"));
 __exportStar(require("./models/model"), exports);
@@ -56,6 +49,38 @@ class Client extends openapi_core_1.default {
         this.checkConfig(config);
         this._endpoint = this.getEndpoint("cloudauth", this._regionId, this._endpointRule, this._network, this._suffix, this._endpointMap, this._endpoint);
     }
+    async _postOSSObject(bucketName, form) {
+        let request_ = new $dara.Request();
+        let boundary = $dara.Form.getBoundary();
+        request_.protocol = "HTTPS";
+        request_.method = "POST";
+        request_.pathname = `/`;
+        request_.headers = {
+            host: String(form["host"]),
+            date: openapi_core_2.OpenApiUtil.getDateUTCString(),
+            'user-agent': openapi_core_2.OpenApiUtil.getUserAgent(""),
+        };
+        request_.headers["content-type"] = `multipart/form-data; boundary=${boundary}`;
+        request_.body = $dara.Form.toFileForm(form, boundary);
+        let response_ = await $dara.doAction(request_);
+        let respMap = null;
+        let bodyStr = await $dara.Stream.readAsString(response_.body);
+        if ((response_.statusCode >= 400) && (response_.statusCode < 600)) {
+            respMap = $dara.XML.parseXml(bodyStr, null);
+            let err = respMap["Error"];
+            throw new $OpenApi.ClientError({
+                code: String(err["Code"]),
+                message: String(err["Message"]),
+                data: {
+                    httpCode: response_.statusCode,
+                    requestId: String(err["RequestId"]),
+                    hostId: String(err["HostId"]),
+                },
+            });
+        }
+        respMap = $dara.XML.parseXml(bodyStr, null);
+        return Object.assign({}, respMap);
+    }
     getEndpoint(productId, regionId, endpointRule, network, suffix, endpointMap, endpoint) {
         if (!$dara.isNull(endpoint)) {
             return endpoint;
@@ -66,7 +91,7 @@ class Client extends openapi_core_1.default {
         return openapi_core_2.OpenApiUtil.getEndpointRules(productId, regionId, endpointRule, network, suffix);
     }
     /**
-     * 新增AIGC人脸检测能力
+     * Add AIGC Face Detection Capability
      *
      * @param request - AIGCFaceVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -115,7 +140,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.AIGCFaceVerifyResponse({}));
     }
     /**
-     * 新增AIGC人脸检测能力
+     * Add AIGC Face Detection Capability
      *
      * @param request - AIGCFaceVerifyRequest
      * @returns AIGCFaceVerifyResponse
@@ -125,7 +150,15 @@ class Client extends openapi_core_1.default {
         return await this.aIGCFaceVerifyWithOptions(request, runtime);
     }
     /**
-     * 银行卡要素核验接口
+     * Bank Card Element Verification Interface
+     *
+     * @remarks
+     * Bank card verification, including: two elements (name + bank card number), three elements (name + ID number + bank card number), and four elements (name + ID number + mobile phone number + bank card number) consistency verification.
+     * - Service address:
+     *   - Beijing region: cloudauth.cn-beijing.aliyuncs.com (IPv4) or cloudauth-dualstack.cn-beijing.aliyuncs.com (IPv6).
+     *   - Shanghai region: cloudauth.cn-shanghai.aliyuncs.com (IPv4) or cloudauth-dualstack.cn-shanghai.aliyuncs.com (IPv6).
+     * - Request method: POST and GET.
+     * - Transfer protocol: HTTPS.
      *
      * @param request - BankMetaVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -175,7 +208,15 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.BankMetaVerifyResponse({}));
     }
     /**
-     * 银行卡要素核验接口
+     * Bank Card Element Verification Interface
+     *
+     * @remarks
+     * Bank card verification, including: two elements (name + bank card number), three elements (name + ID number + bank card number), and four elements (name + ID number + mobile phone number + bank card number) consistency verification.
+     * - Service address:
+     *   - Beijing region: cloudauth.cn-beijing.aliyuncs.com (IPv4) or cloudauth-dualstack.cn-beijing.aliyuncs.com (IPv6).
+     *   - Shanghai region: cloudauth.cn-shanghai.aliyuncs.com (IPv4) or cloudauth-dualstack.cn-shanghai.aliyuncs.com (IPv6).
+     * - Request method: POST and GET.
+     * - Transfer protocol: HTTPS.
      *
      * @param request - BankMetaVerifyRequest
      * @returns BankMetaVerifyResponse
@@ -185,6 +226,21 @@ class Client extends openapi_core_1.default {
         return await this.bankMetaVerifyWithOptions(request, runtime);
     }
     /**
+     * Financial-grade Pure Server-Side API for Face Comparison.
+     *
+     * @remarks
+     * - API Name: CompareFaceVerify.
+     * - Service Address: cloudauth.aliyuncs.com.
+     * - Request Method: HTTPS POST and GET.
+     * - API Description: An interface to achieve real-person authentication through server-side integration.
+     * #### Photo Format Requirements
+     * When performing face comparison, please upload 2 facial photos that meet all the following conditions:
+     * - Recent photo/recent database photo, with a complete, clear, unobstructed face, natural expression, and facing the camera directly.
+     * - Clear photo with normal exposure, no overly dark, overly bright, or halo effects on the face, and no significant angle deviation.
+     * - Resolution not exceeding 1920*1080, at least 640*480, recommended to scale the shorter side to 720 pixels, with a compression ratio greater than 0.9.
+     * - Photo size: <1MB.
+     * - Supports 90, 180, and 270-degree photos; in cases of multiple faces, the largest face will be selected.
+     *
      * @param request - CompareFaceVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
      * @returns CompareFaceVerifyResponse
@@ -251,6 +307,21 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CompareFaceVerifyResponse({}));
     }
     /**
+     * Financial-grade Pure Server-Side API for Face Comparison.
+     *
+     * @remarks
+     * - API Name: CompareFaceVerify.
+     * - Service Address: cloudauth.aliyuncs.com.
+     * - Request Method: HTTPS POST and GET.
+     * - API Description: An interface to achieve real-person authentication through server-side integration.
+     * #### Photo Format Requirements
+     * When performing face comparison, please upload 2 facial photos that meet all the following conditions:
+     * - Recent photo/recent database photo, with a complete, clear, unobstructed face, natural expression, and facing the camera directly.
+     * - Clear photo with normal exposure, no overly dark, overly bright, or halo effects on the face, and no significant angle deviation.
+     * - Resolution not exceeding 1920*1080, at least 640*480, recommended to scale the shorter side to 720 pixels, with a compression ratio greater than 0.9.
+     * - Photo size: <1MB.
+     * - Supports 90, 180, and 270-degree photos; in cases of multiple faces, the largest face will be selected.
+     *
      * @param request - CompareFaceVerifyRequest
      * @returns CompareFaceVerifyResponse
      */
@@ -259,6 +330,23 @@ class Client extends openapi_core_1.default {
         return await this.compareFaceVerifyWithOptions(request, runtime);
     }
     /**
+     * Invoke CompareFaces for face comparison.
+     *
+     * @remarks
+     * Request Method: Only supports sending requests via HTTPS POST.
+     * Interface Description: Compares two face images and outputs the similarity score of the faces in the two images as the result.
+     * - At least one of the specified comparison images should be a face photo (FacePic).
+     * - If an image contains multiple faces, the algorithm will automatically select the largest face in the image.
+     * - If one of the two comparison images does not detect a face, the system will return an error message stating \\"No face detected\\".
+     * When uploading images, you need to provide the HTTP address or base64 encoding of the image.
+     * - HTTP Address: A publicly accessible HTTP address. For example, `http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg`.
+     * - Base64 Encoding: An image encoded in base64, formatted as `base64://<base64 string of the image>`.
+     * Image Restrictions
+     * - Does not support relative or absolute paths for local images.
+     * - Please keep the size of a single image within 2MB to avoid timeout during retrieval by the algorithm.
+     * - The body of a single request has a size limit of 8MB; please calculate the total size of all images and other information in the request to ensure it does not exceed this limit.
+     * - When using base64 to transmit images, the request method must be changed to POST; the header description such as `data:image/png;base64,` should be removed from the base64 string of the image.
+     *
      * @param request - CompareFacesRequest
      * @param runtime - runtime options for this request RuntimeOptions
      * @returns CompareFacesResponse
@@ -295,6 +383,23 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CompareFacesResponse({}));
     }
     /**
+     * Invoke CompareFaces for face comparison.
+     *
+     * @remarks
+     * Request Method: Only supports sending requests via HTTPS POST.
+     * Interface Description: Compares two face images and outputs the similarity score of the faces in the two images as the result.
+     * - At least one of the specified comparison images should be a face photo (FacePic).
+     * - If an image contains multiple faces, the algorithm will automatically select the largest face in the image.
+     * - If one of the two comparison images does not detect a face, the system will return an error message stating \\"No face detected\\".
+     * When uploading images, you need to provide the HTTP address or base64 encoding of the image.
+     * - HTTP Address: A publicly accessible HTTP address. For example, `http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg`.
+     * - Base64 Encoding: An image encoded in base64, formatted as `base64://<base64 string of the image>`.
+     * Image Restrictions
+     * - Does not support relative or absolute paths for local images.
+     * - Please keep the size of a single image within 2MB to avoid timeout during retrieval by the algorithm.
+     * - The body of a single request has a size limit of 8MB; please calculate the total size of all images and other information in the request to ensure it does not exceed this limit.
+     * - When using base64 to transmit images, the request method must be changed to POST; the header description such as `data:image/png;base64,` should be removed from the base64 string of the image.
+     *
      * @param request - CompareFacesRequest
      * @returns CompareFacesResponse
      */
@@ -395,12 +500,19 @@ class Client extends openapi_core_1.default {
     }
     async contrastFaceVerifyAdvance(request, runtime) {
         // Step 0: init client
-        let accessKeyId = await this._credential.getAccessKeyId();
-        let accessKeySecret = await this._credential.getAccessKeySecret();
-        let securityToken = await this._credential.getSecurityToken();
-        let credentialType = this._credential.getType();
+        if ($dara.isNull(this._credential)) {
+            throw new $OpenApi.ClientError({
+                code: "InvalidCredentials",
+                message: "Please set up the credentials correctly. If you are setting them through environment variables, please ensure that ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET are set correctly. See https://help.aliyun.com/zh/sdk/developer-reference/configure-the-alibaba-cloud-accesskey-environment-variable-on-linux-macos-and-windows-systems for more details.",
+            });
+        }
+        let credentialModel = await this._credential.getCredential();
+        let accessKeyId = credentialModel.accessKeyId;
+        let accessKeySecret = credentialModel.accessKeySecret;
+        let securityToken = credentialModel.securityToken;
+        let credentialType = credentialModel.type;
         let openPlatformEndpoint = this._openPlatformEndpoint;
-        if ($dara.isNull(openPlatformEndpoint)) {
+        if ($dara.isNull(openPlatformEndpoint) || openPlatformEndpoint == "") {
             openPlatformEndpoint = "openplatform.aliyuncs.com";
         }
         if ($dara.isNull(credentialType)) {
@@ -415,51 +527,54 @@ class Client extends openapi_core_1.default {
             protocol: this._protocol,
             regionId: this._regionId,
         });
-        let authClient = new openplatform20191219_1.default(authConfig);
-        let authRequest = new $OpenPlatform.AuthorizeFileUploadRequest({
-            product: "Cloudauth",
-            regionId: this._regionId,
+        let authClient = new openapi_core_1.default(authConfig);
+        let authRequest = {
+            Product: "Cloudauth",
+            RegionId: this._regionId,
+        };
+        let authReq = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            query: openapi_core_2.OpenApiUtil.query(authRequest),
         });
-        let authResponse = new $OpenPlatform.AuthorizeFileUploadResponse({});
-        let ossConfig = new $OSS.Config({
-            accessKeyId: accessKeyId,
-            accessKeySecret: accessKeySecret,
-            type: "access_key",
-            protocol: this._protocol,
-            regionId: this._regionId,
+        let authParams = new openapi_core_2.$OpenApiUtil.Params({
+            action: "AuthorizeFileUpload",
+            version: "2019-12-19",
+            protocol: "HTTPS",
+            pathname: "/",
+            method: "GET",
+            authType: "AK",
+            style: "RPC",
+            reqBodyType: "formData",
+            bodyType: "json",
         });
-        let ossClient = new oss_client_1.default(ossConfig);
-        let fileObj = new $FileForm.FileField({});
-        let ossHeader = new $OSS.PostObjectRequestHeader({});
-        let uploadRequest = new $OSS.PostObjectRequest({});
-        let ossRuntime = new $OSSUtil.RuntimeOptions({});
-        openapi_core_2.OpenApiUtil.convert(runtime, ossRuntime);
+        let authResponse = {};
+        let fileObj = new $dara.FileField({});
+        let ossHeader = {};
+        let tmpBody = {};
+        let useAccelerate = false;
+        let authResponseBody = {};
         let contrastFaceVerifyReq = new $_model.ContrastFaceVerifyRequest({});
         openapi_core_2.OpenApiUtil.convert(request, contrastFaceVerifyReq);
         if (!$dara.isNull(request.faceContrastFileObject)) {
-            authResponse = await authClient.authorizeFileUploadWithOptions(authRequest, runtime);
-            ossConfig.accessKeyId = authResponse.body.accessKeyId;
-            ossConfig.endpoint = openapi_core_2.OpenApiUtil.getEndpoint(authResponse.body.endpoint, authResponse.body.useAccelerate, this._endpointType);
-            ossClient = new oss_client_1.default(ossConfig);
-            fileObj = new $FileForm.FileField({
-                filename: authResponse.body.objectKey,
+            authResponse = await authClient.callApi(authParams, authReq, runtime);
+            tmpBody = authResponse["body"];
+            useAccelerate = Boolean(tmpBody["UseAccelerate"]);
+            authResponseBody = openapi_core_2.OpenApiUtil.stringifyMapValue(tmpBody);
+            fileObj = new $dara.FileField({
+                filename: authResponseBody["ObjectKey"],
                 content: request.faceContrastFileObject,
                 contentType: "",
             });
-            ossHeader = new $OSS.PostObjectRequestHeader({
-                accessKeyId: authResponse.body.accessKeyId,
-                policy: authResponse.body.encodedPolicy,
-                signature: authResponse.body.signature,
-                key: authResponse.body.objectKey,
+            ossHeader = {
+                host: `${authResponseBody["Bucket"]}.${openapi_core_2.OpenApiUtil.getEndpoint(authResponseBody["Endpoint"], useAccelerate, this._endpointType)}`,
+                OSSAccessKeyId: authResponseBody["AccessKeyId"],
+                policy: authResponseBody["EncodedPolicy"],
+                Signature: authResponseBody["Signature"],
+                key: authResponseBody["ObjectKey"],
                 file: fileObj,
-                successActionStatus: "201",
-            });
-            uploadRequest = new $OSS.PostObjectRequest({
-                bucketName: authResponse.body.bucket,
-                header: ossHeader,
-            });
-            await ossClient.postObject(uploadRequest, ossRuntime);
-            contrastFaceVerifyReq.faceContrastFile = `http://${authResponse.body.bucket}.${authResponse.body.endpoint}/${authResponse.body.objectKey}`;
+                success_action_status: "201",
+            };
+            await this._postOSSObject(authResponseBody["Bucket"], ossHeader);
+            contrastFaceVerifyReq.faceContrastFile = `http://${authResponseBody["Bucket"]}.${authResponseBody["Endpoint"]}/${authResponseBody["ObjectKey"]}`;
         }
         let contrastFaceVerifyResp = await this.contrastFaceVerifyWithOptions(contrastFaceVerifyReq, runtime);
         return contrastFaceVerifyResp;
@@ -559,7 +674,10 @@ class Client extends openapi_core_1.default {
         return await this.createVerifySettingWithOptions(request, runtime);
     }
     /**
-     * 商品凭证核验
+     * Product Credential Verification
+     *
+     * @remarks
+     * Upload e-commerce product images to perform tampering, quality (clarity), and similar image detection, returning risk labels and scores.
      *
      * @param request - CredentialProductVerifyV2Request
      * @param runtime - runtime options for this request RuntimeOptions
@@ -605,7 +723,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CredentialProductVerifyV2Response({}));
     }
     /**
-     * 商品凭证核验
+     * Product Credential Verification
+     *
+     * @remarks
+     * Upload e-commerce product images to perform tampering, quality (clarity), and similar image detection, returning risk labels and scores.
      *
      * @param request - CredentialProductVerifyV2Request
      * @returns CredentialProductVerifyV2Response
@@ -616,12 +737,19 @@ class Client extends openapi_core_1.default {
     }
     async credentialProductVerifyV2Advance(request, runtime) {
         // Step 0: init client
-        let accessKeyId = await this._credential.getAccessKeyId();
-        let accessKeySecret = await this._credential.getAccessKeySecret();
-        let securityToken = await this._credential.getSecurityToken();
-        let credentialType = this._credential.getType();
+        if ($dara.isNull(this._credential)) {
+            throw new $OpenApi.ClientError({
+                code: "InvalidCredentials",
+                message: "Please set up the credentials correctly. If you are setting them through environment variables, please ensure that ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET are set correctly. See https://help.aliyun.com/zh/sdk/developer-reference/configure-the-alibaba-cloud-accesskey-environment-variable-on-linux-macos-and-windows-systems for more details.",
+            });
+        }
+        let credentialModel = await this._credential.getCredential();
+        let accessKeyId = credentialModel.accessKeyId;
+        let accessKeySecret = credentialModel.accessKeySecret;
+        let securityToken = credentialModel.securityToken;
+        let credentialType = credentialModel.type;
         let openPlatformEndpoint = this._openPlatformEndpoint;
-        if ($dara.isNull(openPlatformEndpoint)) {
+        if ($dara.isNull(openPlatformEndpoint) || openPlatformEndpoint == "") {
             openPlatformEndpoint = "openplatform.aliyuncs.com";
         }
         if ($dara.isNull(credentialType)) {
@@ -636,51 +764,54 @@ class Client extends openapi_core_1.default {
             protocol: this._protocol,
             regionId: this._regionId,
         });
-        let authClient = new openplatform20191219_1.default(authConfig);
-        let authRequest = new $OpenPlatform.AuthorizeFileUploadRequest({
-            product: "Cloudauth",
-            regionId: this._regionId,
+        let authClient = new openapi_core_1.default(authConfig);
+        let authRequest = {
+            Product: "Cloudauth",
+            RegionId: this._regionId,
+        };
+        let authReq = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            query: openapi_core_2.OpenApiUtil.query(authRequest),
         });
-        let authResponse = new $OpenPlatform.AuthorizeFileUploadResponse({});
-        let ossConfig = new $OSS.Config({
-            accessKeyId: accessKeyId,
-            accessKeySecret: accessKeySecret,
-            type: "access_key",
-            protocol: this._protocol,
-            regionId: this._regionId,
+        let authParams = new openapi_core_2.$OpenApiUtil.Params({
+            action: "AuthorizeFileUpload",
+            version: "2019-12-19",
+            protocol: "HTTPS",
+            pathname: "/",
+            method: "GET",
+            authType: "AK",
+            style: "RPC",
+            reqBodyType: "formData",
+            bodyType: "json",
         });
-        let ossClient = new oss_client_1.default(ossConfig);
-        let fileObj = new $FileForm.FileField({});
-        let ossHeader = new $OSS.PostObjectRequestHeader({});
-        let uploadRequest = new $OSS.PostObjectRequest({});
-        let ossRuntime = new $OSSUtil.RuntimeOptions({});
-        openapi_core_2.OpenApiUtil.convert(runtime, ossRuntime);
+        let authResponse = {};
+        let fileObj = new $dara.FileField({});
+        let ossHeader = {};
+        let tmpBody = {};
+        let useAccelerate = false;
+        let authResponseBody = {};
         let credentialProductVerifyV2Req = new $_model.CredentialProductVerifyV2Request({});
         openapi_core_2.OpenApiUtil.convert(request, credentialProductVerifyV2Req);
         if (!$dara.isNull(request.imageFileObject)) {
-            authResponse = await authClient.authorizeFileUploadWithOptions(authRequest, runtime);
-            ossConfig.accessKeyId = authResponse.body.accessKeyId;
-            ossConfig.endpoint = openapi_core_2.OpenApiUtil.getEndpoint(authResponse.body.endpoint, authResponse.body.useAccelerate, this._endpointType);
-            ossClient = new oss_client_1.default(ossConfig);
-            fileObj = new $FileForm.FileField({
-                filename: authResponse.body.objectKey,
+            authResponse = await authClient.callApi(authParams, authReq, runtime);
+            tmpBody = authResponse["body"];
+            useAccelerate = Boolean(tmpBody["UseAccelerate"]);
+            authResponseBody = openapi_core_2.OpenApiUtil.stringifyMapValue(tmpBody);
+            fileObj = new $dara.FileField({
+                filename: authResponseBody["ObjectKey"],
                 content: request.imageFileObject,
                 contentType: "",
             });
-            ossHeader = new $OSS.PostObjectRequestHeader({
-                accessKeyId: authResponse.body.accessKeyId,
-                policy: authResponse.body.encodedPolicy,
-                signature: authResponse.body.signature,
-                key: authResponse.body.objectKey,
+            ossHeader = {
+                host: `${authResponseBody["Bucket"]}.${openapi_core_2.OpenApiUtil.getEndpoint(authResponseBody["Endpoint"], useAccelerate, this._endpointType)}`,
+                OSSAccessKeyId: authResponseBody["AccessKeyId"],
+                policy: authResponseBody["EncodedPolicy"],
+                Signature: authResponseBody["Signature"],
+                key: authResponseBody["ObjectKey"],
                 file: fileObj,
-                successActionStatus: "201",
-            });
-            uploadRequest = new $OSS.PostObjectRequest({
-                bucketName: authResponse.body.bucket,
-                header: ossHeader,
-            });
-            await ossClient.postObject(uploadRequest, ossRuntime);
-            credentialProductVerifyV2Req.imageFile = `http://${authResponse.body.bucket}.${authResponse.body.endpoint}/${authResponse.body.objectKey}`;
+                success_action_status: "201",
+            };
+            await this._postOSSObject(authResponseBody["Bucket"], ossHeader);
+            credentialProductVerifyV2Req.imageFile = `http://${authResponseBody["Bucket"]}.${authResponseBody["Endpoint"]}/${authResponseBody["ObjectKey"]}`;
         }
         let credentialProductVerifyV2Resp = await this.credentialProductVerifyV2WithOptions(credentialProductVerifyV2Req, runtime);
         return credentialProductVerifyV2Resp;
@@ -771,7 +902,10 @@ class Client extends openapi_core_1.default {
         return await this.credentialVerifyWithOptions(request, runtime);
     }
     /**
-     * 凭证核验
+     * Credential Verification
+     *
+     * @remarks
+     * Input credential image information, perform image tampering and forgery detection, and image semantic understanding. Return the risk detection results.
      *
      * @param tmpReq - CredentialVerifyV2Request
      * @param runtime - runtime options for this request RuntimeOptions
@@ -825,6 +959,9 @@ class Client extends openapi_core_1.default {
             query["UserName"] = request.userName;
         }
         let body = {};
+        if (!$dara.isNull(request.imageContext)) {
+            body["ImageContext"] = request.imageContext;
+        }
         if (!$dara.isNull(request.imageFile)) {
             body["ImageFile"] = request.imageFile;
         }
@@ -846,7 +983,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CredentialVerifyV2Response({}));
     }
     /**
-     * 凭证核验
+     * Credential Verification
+     *
+     * @remarks
+     * Input credential image information, perform image tampering and forgery detection, and image semantic understanding. Return the risk detection results.
      *
      * @param request - CredentialVerifyV2Request
      * @returns CredentialVerifyV2Response
@@ -857,12 +997,19 @@ class Client extends openapi_core_1.default {
     }
     async credentialVerifyV2Advance(request, runtime) {
         // Step 0: init client
-        let accessKeyId = await this._credential.getAccessKeyId();
-        let accessKeySecret = await this._credential.getAccessKeySecret();
-        let securityToken = await this._credential.getSecurityToken();
-        let credentialType = this._credential.getType();
+        if ($dara.isNull(this._credential)) {
+            throw new $OpenApi.ClientError({
+                code: "InvalidCredentials",
+                message: "Please set up the credentials correctly. If you are setting them through environment variables, please ensure that ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET are set correctly. See https://help.aliyun.com/zh/sdk/developer-reference/configure-the-alibaba-cloud-accesskey-environment-variable-on-linux-macos-and-windows-systems for more details.",
+            });
+        }
+        let credentialModel = await this._credential.getCredential();
+        let accessKeyId = credentialModel.accessKeyId;
+        let accessKeySecret = credentialModel.accessKeySecret;
+        let securityToken = credentialModel.securityToken;
+        let credentialType = credentialModel.type;
         let openPlatformEndpoint = this._openPlatformEndpoint;
-        if ($dara.isNull(openPlatformEndpoint)) {
+        if ($dara.isNull(openPlatformEndpoint) || openPlatformEndpoint == "") {
             openPlatformEndpoint = "openplatform.aliyuncs.com";
         }
         if ($dara.isNull(credentialType)) {
@@ -877,57 +1024,66 @@ class Client extends openapi_core_1.default {
             protocol: this._protocol,
             regionId: this._regionId,
         });
-        let authClient = new openplatform20191219_1.default(authConfig);
-        let authRequest = new $OpenPlatform.AuthorizeFileUploadRequest({
-            product: "Cloudauth",
-            regionId: this._regionId,
+        let authClient = new openapi_core_1.default(authConfig);
+        let authRequest = {
+            Product: "Cloudauth",
+            RegionId: this._regionId,
+        };
+        let authReq = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            query: openapi_core_2.OpenApiUtil.query(authRequest),
         });
-        let authResponse = new $OpenPlatform.AuthorizeFileUploadResponse({});
-        let ossConfig = new $OSS.Config({
-            accessKeyId: accessKeyId,
-            accessKeySecret: accessKeySecret,
-            type: "access_key",
-            protocol: this._protocol,
-            regionId: this._regionId,
+        let authParams = new openapi_core_2.$OpenApiUtil.Params({
+            action: "AuthorizeFileUpload",
+            version: "2019-12-19",
+            protocol: "HTTPS",
+            pathname: "/",
+            method: "GET",
+            authType: "AK",
+            style: "RPC",
+            reqBodyType: "formData",
+            bodyType: "json",
         });
-        let ossClient = new oss_client_1.default(ossConfig);
-        let fileObj = new $FileForm.FileField({});
-        let ossHeader = new $OSS.PostObjectRequestHeader({});
-        let uploadRequest = new $OSS.PostObjectRequest({});
-        let ossRuntime = new $OSSUtil.RuntimeOptions({});
-        openapi_core_2.OpenApiUtil.convert(runtime, ossRuntime);
+        let authResponse = {};
+        let fileObj = new $dara.FileField({});
+        let ossHeader = {};
+        let tmpBody = {};
+        let useAccelerate = false;
+        let authResponseBody = {};
         let credentialVerifyV2Req = new $_model.CredentialVerifyV2Request({});
         openapi_core_2.OpenApiUtil.convert(request, credentialVerifyV2Req);
         if (!$dara.isNull(request.imageFileObject)) {
-            authResponse = await authClient.authorizeFileUploadWithOptions(authRequest, runtime);
-            ossConfig.accessKeyId = authResponse.body.accessKeyId;
-            ossConfig.endpoint = openapi_core_2.OpenApiUtil.getEndpoint(authResponse.body.endpoint, authResponse.body.useAccelerate, this._endpointType);
-            ossClient = new oss_client_1.default(ossConfig);
-            fileObj = new $FileForm.FileField({
-                filename: authResponse.body.objectKey,
+            authResponse = await authClient.callApi(authParams, authReq, runtime);
+            tmpBody = authResponse["body"];
+            useAccelerate = Boolean(tmpBody["UseAccelerate"]);
+            authResponseBody = openapi_core_2.OpenApiUtil.stringifyMapValue(tmpBody);
+            fileObj = new $dara.FileField({
+                filename: authResponseBody["ObjectKey"],
                 content: request.imageFileObject,
                 contentType: "",
             });
-            ossHeader = new $OSS.PostObjectRequestHeader({
-                accessKeyId: authResponse.body.accessKeyId,
-                policy: authResponse.body.encodedPolicy,
-                signature: authResponse.body.signature,
-                key: authResponse.body.objectKey,
+            ossHeader = {
+                host: `${authResponseBody["Bucket"]}.${openapi_core_2.OpenApiUtil.getEndpoint(authResponseBody["Endpoint"], useAccelerate, this._endpointType)}`,
+                OSSAccessKeyId: authResponseBody["AccessKeyId"],
+                policy: authResponseBody["EncodedPolicy"],
+                Signature: authResponseBody["Signature"],
+                key: authResponseBody["ObjectKey"],
                 file: fileObj,
-                successActionStatus: "201",
-            });
-            uploadRequest = new $OSS.PostObjectRequest({
-                bucketName: authResponse.body.bucket,
-                header: ossHeader,
-            });
-            await ossClient.postObject(uploadRequest, ossRuntime);
-            credentialVerifyV2Req.imageFile = `http://${authResponse.body.bucket}.${authResponse.body.endpoint}/${authResponse.body.objectKey}`;
+                success_action_status: "201",
+            };
+            await this._postOSSObject(authResponseBody["Bucket"], ossHeader);
+            credentialVerifyV2Req.imageFile = `http://${authResponseBody["Bucket"]}.${authResponseBody["Endpoint"]}/${authResponseBody["ObjectKey"]}`;
         }
         let credentialVerifyV2Resp = await this.credentialVerifyV2WithOptions(credentialVerifyV2Req, runtime);
         return credentialVerifyV2Resp;
     }
     /**
-     * 人脸凭证核验服务
+     * Face Credential Verification Service
+     *
+     * @remarks
+     * > The Face Deepfake Detection API is currently in the free public beta stage, which will end on August 30, 2024, at 23:59:59. During the public beta, the QPS (Queries Per Second) cannot exceed 3 times/second.
+     * - Service address: cloudauth.aliyuncs.com (IPv4) or cloudauth-dualstack.aliyuncs.com (IPv6).
+     * - Request method: POST and GET.
+     * - Transfer protocol: HTTPS.
      *
      * @param request - DeepfakeDetectRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -967,7 +1123,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeepfakeDetectResponse({}));
     }
     /**
-     * 人脸凭证核验服务
+     * Face Credential Verification Service
+     *
+     * @remarks
+     * > The Face Deepfake Detection API is currently in the free public beta stage, which will end on August 30, 2024, at 23:59:59. During the public beta, the QPS (Queries Per Second) cannot exceed 3 times/second.
+     * - Service address: cloudauth.aliyuncs.com (IPv4) or cloudauth-dualstack.aliyuncs.com (IPv6).
+     * - Request method: POST and GET.
+     * - Transfer protocol: HTTPS.
      *
      * @param request - DeepfakeDetectRequest
      * @returns DeepfakeDetectResponse
@@ -977,7 +1139,10 @@ class Client extends openapi_core_1.default {
         return await this.deepfakeDetectWithOptions(request, runtime);
     }
     /**
-     * 金融级服务敏感数据删除接口
+     * Financial Level Sensitive Data Deletion Interface
+     *
+     * @remarks
+     * Deletes all personal information fields in the request, including name, ID number, phone number, IP, images, videos, and device information, etc.
      *
      * @param request - DeleteFaceVerifyResultRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1009,7 +1174,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteFaceVerifyResultResponse({}));
     }
     /**
-     * 金融级服务敏感数据删除接口
+     * Financial Level Sensitive Data Deletion Interface
+     *
+     * @remarks
+     * Deletes all personal information fields in the request, including name, ID number, phone number, IP, images, videos, and device information, etc.
      *
      * @param request - DeleteFaceVerifyResultRequest
      * @returns DeleteFaceVerifyResultResponse
@@ -1519,7 +1687,7 @@ class Client extends openapi_core_1.default {
         return await this.detectFaceAttributesWithOptions(request, runtime);
     }
     /**
-     * 二要素有效期核验接口
+     * Two-Factor Validity Verification API
      *
      * @param request - Id2MetaPeriodVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1560,7 +1728,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.Id2MetaPeriodVerifyResponse({}));
     }
     /**
-     * 二要素有效期核验接口
+     * Two-Factor Validity Verification API
      *
      * @param request - Id2MetaPeriodVerifyRequest
      * @returns Id2MetaPeriodVerifyResponse
@@ -1570,7 +1738,7 @@ class Client extends openapi_core_1.default {
         return await this.id2MetaPeriodVerifyWithOptions(request, runtime);
     }
     /**
-     * 身份二要素标准版
+     * Identity Two-Factor Standard
      *
      * @param request - Id2MetaStandardVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1605,7 +1773,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.Id2MetaStandardVerifyResponse({}));
     }
     /**
-     * 身份二要素标准版
+     * Identity Two-Factor Standard
      *
      * @param request - Id2MetaStandardVerifyRequest
      * @returns Id2MetaStandardVerifyResponse
@@ -1615,7 +1783,12 @@ class Client extends openapi_core_1.default {
         return await this.id2MetaStandardVerifyWithOptions(request, runtime);
     }
     /**
-     * 身份二要素接口
+     * Identity Two-Factor Interface
+     *
+     * @remarks
+     * - Service address: cloudauth.aliyuncs.com (IPv4) or cloudauth-dualstack.aliyuncs.com (IPv6).
+     * - Request method: POST and GET.
+     * - Transfer protocol: HTTPS.
      *
      * @param request - Id2MetaVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1650,7 +1823,12 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.Id2MetaVerifyResponse({}));
     }
     /**
-     * 身份二要素接口
+     * Identity Two-Factor Interface
+     *
+     * @remarks
+     * - Service address: cloudauth.aliyuncs.com (IPv4) or cloudauth-dualstack.aliyuncs.com (IPv6).
+     * - Request method: POST and GET.
+     * - Transfer protocol: HTTPS.
      *
      * @param request - Id2MetaVerifyRequest
      * @returns Id2MetaVerifyResponse
@@ -1660,7 +1838,10 @@ class Client extends openapi_core_1.default {
         return await this.id2MetaVerifyWithOptions(request, runtime);
     }
     /**
-     * 身份二要素图片核验
+     * ID Two-Factor Image Verification
+     *
+     * @remarks
+     * Upload both sides of the ID card, and get the verification result of the two factors from an authoritative data source.
      *
      * @param request - Id2MetaVerifyWithOCRRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1698,7 +1879,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.Id2MetaVerifyWithOCRResponse({}));
     }
     /**
-     * 身份二要素图片核验
+     * ID Two-Factor Image Verification
+     *
+     * @remarks
+     * Upload both sides of the ID card, and get the verification result of the two factors from an authoritative data source.
      *
      * @param request - Id2MetaVerifyWithOCRRequest
      * @returns Id2MetaVerifyWithOCRResponse
@@ -1709,12 +1893,19 @@ class Client extends openapi_core_1.default {
     }
     async id2MetaVerifyWithOCRAdvance(request, runtime) {
         // Step 0: init client
-        let accessKeyId = await this._credential.getAccessKeyId();
-        let accessKeySecret = await this._credential.getAccessKeySecret();
-        let securityToken = await this._credential.getSecurityToken();
-        let credentialType = this._credential.getType();
+        if ($dara.isNull(this._credential)) {
+            throw new $OpenApi.ClientError({
+                code: "InvalidCredentials",
+                message: "Please set up the credentials correctly. If you are setting them through environment variables, please ensure that ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET are set correctly. See https://help.aliyun.com/zh/sdk/developer-reference/configure-the-alibaba-cloud-accesskey-environment-variable-on-linux-macos-and-windows-systems for more details.",
+            });
+        }
+        let credentialModel = await this._credential.getCredential();
+        let accessKeyId = credentialModel.accessKeyId;
+        let accessKeySecret = credentialModel.accessKeySecret;
+        let securityToken = credentialModel.securityToken;
+        let credentialType = credentialModel.type;
         let openPlatformEndpoint = this._openPlatformEndpoint;
-        if ($dara.isNull(openPlatformEndpoint)) {
+        if ($dara.isNull(openPlatformEndpoint) || openPlatformEndpoint == "") {
             openPlatformEndpoint = "openplatform.aliyuncs.com";
         }
         if ($dara.isNull(credentialType)) {
@@ -1729,82 +1920,85 @@ class Client extends openapi_core_1.default {
             protocol: this._protocol,
             regionId: this._regionId,
         });
-        let authClient = new openplatform20191219_1.default(authConfig);
-        let authRequest = new $OpenPlatform.AuthorizeFileUploadRequest({
-            product: "Cloudauth",
-            regionId: this._regionId,
+        let authClient = new openapi_core_1.default(authConfig);
+        let authRequest = {
+            Product: "Cloudauth",
+            RegionId: this._regionId,
+        };
+        let authReq = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            query: openapi_core_2.OpenApiUtil.query(authRequest),
         });
-        let authResponse = new $OpenPlatform.AuthorizeFileUploadResponse({});
-        let ossConfig = new $OSS.Config({
-            accessKeyId: accessKeyId,
-            accessKeySecret: accessKeySecret,
-            type: "access_key",
-            protocol: this._protocol,
-            regionId: this._regionId,
+        let authParams = new openapi_core_2.$OpenApiUtil.Params({
+            action: "AuthorizeFileUpload",
+            version: "2019-12-19",
+            protocol: "HTTPS",
+            pathname: "/",
+            method: "GET",
+            authType: "AK",
+            style: "RPC",
+            reqBodyType: "formData",
+            bodyType: "json",
         });
-        let ossClient = new oss_client_1.default(ossConfig);
-        let fileObj = new $FileForm.FileField({});
-        let ossHeader = new $OSS.PostObjectRequestHeader({});
-        let uploadRequest = new $OSS.PostObjectRequest({});
-        let ossRuntime = new $OSSUtil.RuntimeOptions({});
-        openapi_core_2.OpenApiUtil.convert(runtime, ossRuntime);
+        let authResponse = {};
+        let fileObj = new $dara.FileField({});
+        let ossHeader = {};
+        let tmpBody = {};
+        let useAccelerate = false;
+        let authResponseBody = {};
         let id2MetaVerifyWithOCRReq = new $_model.Id2MetaVerifyWithOCRRequest({});
         openapi_core_2.OpenApiUtil.convert(request, id2MetaVerifyWithOCRReq);
         if (!$dara.isNull(request.certFileObject)) {
-            authResponse = await authClient.authorizeFileUploadWithOptions(authRequest, runtime);
-            ossConfig.accessKeyId = authResponse.body.accessKeyId;
-            ossConfig.endpoint = openapi_core_2.OpenApiUtil.getEndpoint(authResponse.body.endpoint, authResponse.body.useAccelerate, this._endpointType);
-            ossClient = new oss_client_1.default(ossConfig);
-            fileObj = new $FileForm.FileField({
-                filename: authResponse.body.objectKey,
+            authResponse = await authClient.callApi(authParams, authReq, runtime);
+            tmpBody = authResponse["body"];
+            useAccelerate = Boolean(tmpBody["UseAccelerate"]);
+            authResponseBody = openapi_core_2.OpenApiUtil.stringifyMapValue(tmpBody);
+            fileObj = new $dara.FileField({
+                filename: authResponseBody["ObjectKey"],
                 content: request.certFileObject,
                 contentType: "",
             });
-            ossHeader = new $OSS.PostObjectRequestHeader({
-                accessKeyId: authResponse.body.accessKeyId,
-                policy: authResponse.body.encodedPolicy,
-                signature: authResponse.body.signature,
-                key: authResponse.body.objectKey,
+            ossHeader = {
+                host: `${authResponseBody["Bucket"]}.${openapi_core_2.OpenApiUtil.getEndpoint(authResponseBody["Endpoint"], useAccelerate, this._endpointType)}`,
+                OSSAccessKeyId: authResponseBody["AccessKeyId"],
+                policy: authResponseBody["EncodedPolicy"],
+                Signature: authResponseBody["Signature"],
+                key: authResponseBody["ObjectKey"],
                 file: fileObj,
-                successActionStatus: "201",
-            });
-            uploadRequest = new $OSS.PostObjectRequest({
-                bucketName: authResponse.body.bucket,
-                header: ossHeader,
-            });
-            await ossClient.postObject(uploadRequest, ossRuntime);
-            id2MetaVerifyWithOCRReq.certFile = `http://${authResponse.body.bucket}.${authResponse.body.endpoint}/${authResponse.body.objectKey}`;
+                success_action_status: "201",
+            };
+            await this._postOSSObject(authResponseBody["Bucket"], ossHeader);
+            id2MetaVerifyWithOCRReq.certFile = `http://${authResponseBody["Bucket"]}.${authResponseBody["Endpoint"]}/${authResponseBody["ObjectKey"]}`;
         }
         if (!$dara.isNull(request.certNationalFileObject)) {
-            authResponse = await authClient.authorizeFileUploadWithOptions(authRequest, runtime);
-            ossConfig.accessKeyId = authResponse.body.accessKeyId;
-            ossConfig.endpoint = openapi_core_2.OpenApiUtil.getEndpoint(authResponse.body.endpoint, authResponse.body.useAccelerate, this._endpointType);
-            ossClient = new oss_client_1.default(ossConfig);
-            fileObj = new $FileForm.FileField({
-                filename: authResponse.body.objectKey,
+            authResponse = await authClient.callApi(authParams, authReq, runtime);
+            tmpBody = authResponse["body"];
+            useAccelerate = Boolean(tmpBody["UseAccelerate"]);
+            authResponseBody = openapi_core_2.OpenApiUtil.stringifyMapValue(tmpBody);
+            fileObj = new $dara.FileField({
+                filename: authResponseBody["ObjectKey"],
                 content: request.certNationalFileObject,
                 contentType: "",
             });
-            ossHeader = new $OSS.PostObjectRequestHeader({
-                accessKeyId: authResponse.body.accessKeyId,
-                policy: authResponse.body.encodedPolicy,
-                signature: authResponse.body.signature,
-                key: authResponse.body.objectKey,
+            ossHeader = {
+                host: `${authResponseBody["Bucket"]}.${openapi_core_2.OpenApiUtil.getEndpoint(authResponseBody["Endpoint"], useAccelerate, this._endpointType)}`,
+                OSSAccessKeyId: authResponseBody["AccessKeyId"],
+                policy: authResponseBody["EncodedPolicy"],
+                Signature: authResponseBody["Signature"],
+                key: authResponseBody["ObjectKey"],
                 file: fileObj,
-                successActionStatus: "201",
-            });
-            uploadRequest = new $OSS.PostObjectRequest({
-                bucketName: authResponse.body.bucket,
-                header: ossHeader,
-            });
-            await ossClient.postObject(uploadRequest, ossRuntime);
-            id2MetaVerifyWithOCRReq.certNationalFile = `http://${authResponse.body.bucket}.${authResponse.body.endpoint}/${authResponse.body.objectKey}`;
+                success_action_status: "201",
+            };
+            await this._postOSSObject(authResponseBody["Bucket"], ossHeader);
+            id2MetaVerifyWithOCRReq.certNationalFile = `http://${authResponseBody["Bucket"]}.${authResponseBody["Endpoint"]}/${authResponseBody["ObjectKey"]}`;
         }
         let id2MetaVerifyWithOCRResp = await this.id2MetaVerifyWithOCRWithOptions(id2MetaVerifyWithOCRReq, runtime);
         return id2MetaVerifyWithOCRResp;
     }
     /**
-     * 图片核验发起认证请求
+     * Initiate an authentication request for image verification
+     *
+     * @remarks
+     * Before each authentication, use this interface to obtain the CertifyId, which is used to link various interfaces in the authentication request.
      *
      * @param request - InitCardVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1860,7 +2054,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.InitCardVerifyResponse({}));
     }
     /**
-     * 图片核验发起认证请求
+     * Initiate an authentication request for image verification
+     *
+     * @remarks
+     * Before each authentication, use this interface to obtain the CertifyId, which is used to link various interfaces in the authentication request.
      *
      * @param request - InitCardVerifyRequest
      * @returns InitCardVerifyResponse
@@ -2015,7 +2212,7 @@ class Client extends openapi_core_1.default {
         return await this.initFaceVerifyWithOptions(request, runtime);
     }
     /**
-     * 新增实人白名单
+     * Add Real Person Whitelist
      *
      * @param request - InsertWhiteListSettingRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2059,7 +2256,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.InsertWhiteListSettingResponse({}));
     }
     /**
-     * 新增实人白名单
+     * Add Real Person Whitelist
      *
      * @param request - InsertWhiteListSettingRequest
      * @returns InsertWhiteListSettingResponse
@@ -2145,7 +2342,10 @@ class Client extends openapi_core_1.default {
         return await this.livenessFaceVerifyWithOptions(request, runtime);
     }
     /**
-     * 手机二要素核验
+     * Mobile Two-Factor Verification
+     *
+     * @remarks
+     * Input the phone number and name, verify their authenticity and consistency through authoritative data sources.
      *
      * @param request - Mobile2MetaVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2180,7 +2380,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.Mobile2MetaVerifyResponse({}));
     }
     /**
-     * 手机二要素核验
+     * Mobile Two-Factor Verification
+     *
+     * @remarks
+     * Input the phone number and name, verify their authenticity and consistency through authoritative data sources.
      *
      * @param request - Mobile2MetaVerifyRequest
      * @returns Mobile2MetaVerifyResponse
@@ -2190,7 +2393,10 @@ class Client extends openapi_core_1.default {
         return await this.mobile2MetaVerifyWithOptions(request, runtime);
     }
     /**
-     * 手机号三要素详版_标准版
+     * Detailed Three-Element Verification for Phone Number_Standard Version
+     *
+     * @remarks
+     * Input the phone number, name, and ID number to verify their authenticity and consistency through authoritative data sources. If they do not match, the reason for the mismatch is returned.
      *
      * @param request - Mobile3MetaDetailStandardVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2228,7 +2434,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.Mobile3MetaDetailStandardVerifyResponse({}));
     }
     /**
-     * 手机号三要素详版_标准版
+     * Detailed Three-Element Verification for Phone Number_Standard Version
+     *
+     * @remarks
+     * Input the phone number, name, and ID number to verify their authenticity and consistency through authoritative data sources. If they do not match, the reason for the mismatch is returned.
      *
      * @param request - Mobile3MetaDetailStandardVerifyRequest
      * @returns Mobile3MetaDetailStandardVerifyResponse
@@ -2238,7 +2447,12 @@ class Client extends openapi_core_1.default {
         return await this.mobile3MetaDetailStandardVerifyWithOptions(request, runtime);
     }
     /**
-     * 手机三要素详版接口
+     * Detailed Mobile Three-Element Verification Interface
+     *
+     * @remarks
+     * - Service address: cloudauth.aliyuncs.com (IPv4) or cloudauth-dualstack.aliyuncs.com (IPv6).
+     * - Request method: POST and GET.
+     * - Transfer protocol: HTTPS.
      *
      * @param request - Mobile3MetaDetailVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2276,7 +2490,12 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.Mobile3MetaDetailVerifyResponse({}));
     }
     /**
-     * 手机三要素详版接口
+     * Detailed Mobile Three-Element Verification Interface
+     *
+     * @remarks
+     * - Service address: cloudauth.aliyuncs.com (IPv4) or cloudauth-dualstack.aliyuncs.com (IPv6).
+     * - Request method: POST and GET.
+     * - Transfer protocol: HTTPS.
      *
      * @param request - Mobile3MetaDetailVerifyRequest
      * @returns Mobile3MetaDetailVerifyResponse
@@ -2286,7 +2505,10 @@ class Client extends openapi_core_1.default {
         return await this.mobile3MetaDetailVerifyWithOptions(request, runtime);
     }
     /**
-     * 手机号三要素简版_标准版
+     * Simplified Three-Element Verification for Phone Number_Standard Version
+     *
+     * @remarks
+     * Input the phone number, name, and ID number to verify their authenticity and consistency through authoritative data sources.
      *
      * @param request - Mobile3MetaSimpleStandardVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2324,7 +2546,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.Mobile3MetaSimpleStandardVerifyResponse({}));
     }
     /**
-     * 手机号三要素简版_标准版
+     * Simplified Three-Element Verification for Phone Number_Standard Version
+     *
+     * @remarks
+     * Input the phone number, name, and ID number to verify their authenticity and consistency through authoritative data sources.
      *
      * @param request - Mobile3MetaSimpleStandardVerifyRequest
      * @returns Mobile3MetaSimpleStandardVerifyResponse
@@ -2334,7 +2559,12 @@ class Client extends openapi_core_1.default {
         return await this.mobile3MetaSimpleStandardVerifyWithOptions(request, runtime);
     }
     /**
-     * 手机号三要素简版接口
+     * Mobile Three Elements Simplified Interface
+     *
+     * @remarks
+     * - Service address: cloudauth.aliyuncs.com (IPv4) or cloudauth-dualstack.aliyuncs.com (IPv6).
+     * - Request method: POST and GET.
+     * - Transfer protocol: HTTPS.
      *
      * @param request - Mobile3MetaSimpleVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2372,7 +2602,12 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.Mobile3MetaSimpleVerifyResponse({}));
     }
     /**
-     * 手机号三要素简版接口
+     * Mobile Three Elements Simplified Interface
+     *
+     * @remarks
+     * - Service address: cloudauth.aliyuncs.com (IPv4) or cloudauth-dualstack.aliyuncs.com (IPv6).
+     * - Request method: POST and GET.
+     * - Transfer protocol: HTTPS.
      *
      * @param request - Mobile3MetaSimpleVerifyRequest
      * @returns Mobile3MetaSimpleVerifyResponse
@@ -2382,7 +2617,7 @@ class Client extends openapi_core_1.default {
         return await this.mobile3MetaSimpleVerifyWithOptions(request, runtime);
     }
     /**
-     * 号码检测
+     * Number Detection
      *
      * @param request - MobileDetectRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2414,7 +2649,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.MobileDetectResponse({}));
     }
     /**
-     * 号码检测
+     * Number Detection
      *
      * @param request - MobileDetectRequest
      * @returns MobileDetectResponse
@@ -2424,7 +2659,7 @@ class Client extends openapi_core_1.default {
         return await this.mobileDetectWithOptions(request, runtime);
     }
     /**
-     * 查询手机号在网状态
+     * Query the online status of a mobile number
      *
      * @param request - MobileOnlineStatusRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2456,7 +2691,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.MobileOnlineStatusResponse({}));
     }
     /**
-     * 查询手机号在网状态
+     * Query the online status of a mobile number
      *
      * @param request - MobileOnlineStatusRequest
      * @returns MobileOnlineStatusResponse
@@ -2466,7 +2701,7 @@ class Client extends openapi_core_1.default {
         return await this.mobileOnlineStatusWithOptions(request, runtime);
     }
     /**
-     * 查询手机号在网时长
+     * Query the online duration of a mobile number
      *
      * @param request - MobileOnlineTimeRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2498,7 +2733,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.MobileOnlineTimeResponse({}));
     }
     /**
-     * 查询手机号在网时长
+     * Query the online duration of a mobile number
      *
      * @param request - MobileOnlineTimeRequest
      * @returns MobileOnlineTimeResponse
@@ -2508,6 +2743,11 @@ class Client extends openapi_core_1.default {
         return await this.mobileOnlineTimeWithOptions(request, runtime);
     }
     /**
+     * Call ModifyDeviceInfo to update device-related information, such as extending the device authorization validity period, updating the business party\\"s custom business identifier, and device ID. Suitable for scenarios like renewing the device validity period.
+     *
+     * @remarks
+     * Request Method: Supports sending requests using HTTPS POST and GET methods.
+     *
      * @param request - ModifyDeviceInfoRequest
      * @param runtime - runtime options for this request RuntimeOptions
      * @returns ModifyDeviceInfoResponse
@@ -2547,6 +2787,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ModifyDeviceInfoResponse({}));
     }
     /**
+     * Call ModifyDeviceInfo to update device-related information, such as extending the device authorization validity period, updating the business party\\"s custom business identifier, and device ID. Suitable for scenarios like renewing the device validity period.
+     *
+     * @remarks
+     * Request Method: Supports sending requests using HTTPS POST and GET methods.
+     *
      * @param request - ModifyDeviceInfoRequest
      * @returns ModifyDeviceInfoResponse
      */
@@ -2555,7 +2800,7 @@ class Client extends openapi_core_1.default {
         return await this.modifyDeviceInfoWithOptions(request, runtime);
     }
     /**
-     * 分页查询实人白名单配置
+     * Paging Query for Real Person Whitelist Configuration
      *
      * @param request - PageQueryWhiteListSettingRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2608,7 +2853,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.PageQueryWhiteListSettingResponse({}));
     }
     /**
-     * 分页查询实人白名单配置
+     * Paging Query for Real Person Whitelist Configuration
      *
      * @param request - PageQueryWhiteListSettingRequest
      * @returns PageQueryWhiteListSettingResponse
@@ -2618,7 +2863,7 @@ class Client extends openapi_core_1.default {
         return await this.pageQueryWhiteListSettingWithOptions(request, runtime);
     }
     /**
-     * 删除实人白名单
+     * Delete Real Person Whitelist
      *
      * @param tmpReq - RemoveWhiteListSettingRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2655,7 +2900,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.RemoveWhiteListSettingResponse({}));
     }
     /**
-     * 删除实人白名单
+     * Delete Real Person Whitelist
      *
      * @param request - RemoveWhiteListSettingRequest
      * @returns RemoveWhiteListSettingResponse
@@ -2665,7 +2910,10 @@ class Client extends openapi_core_1.default {
         return await this.removeWhiteListSettingWithOptions(request, runtime);
     }
     /**
-     * 车五项信息识别
+     * Five-Item Vehicle Information Recognition
+     *
+     * @remarks
+     * Query basic vehicle information through the license plate number and vehicle type.
      *
      * @param request - Vehicle5ItemQueryRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2700,7 +2948,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.Vehicle5ItemQueryResponse({}));
     }
     /**
-     * 车五项信息识别
+     * Five-Item Vehicle Information Recognition
+     *
+     * @remarks
+     * Query basic vehicle information through the license plate number and vehicle type.
      *
      * @param request - Vehicle5ItemQueryRequest
      * @returns Vehicle5ItemQueryResponse
@@ -2710,7 +2961,10 @@ class Client extends openapi_core_1.default {
         return await this.vehicle5ItemQueryWithOptions(request, runtime);
     }
     /**
-     * 车辆投保日期查询
+     * Vehicle Insurance Date Inquiry
+     *
+     * @remarks
+     * Query the vehicle insurance date through the license plate number, vehicle type, and vehicle identification number (VIN).
      *
      * @param request - VehicleInsureQueryRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2748,7 +3002,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.VehicleInsureQueryResponse({}));
     }
     /**
-     * 车辆投保日期查询
+     * Vehicle Insurance Date Inquiry
+     *
+     * @remarks
+     * Query the vehicle insurance date through the license plate number, vehicle type, and vehicle identification number (VIN).
      *
      * @param request - VehicleInsureQueryRequest
      * @returns VehicleInsureQueryResponse
@@ -2758,7 +3015,10 @@ class Client extends openapi_core_1.default {
         return await this.vehicleInsureQueryWithOptions(request, runtime);
     }
     /**
-     * 车辆要素核验
+     * Vehicle Element Verification
+     *
+     * @remarks
+     * Verifies the consistency of name, ID number, vehicle license plate, and vehicle type.
      *
      * @param request - VehicleMetaVerifyRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2802,7 +3062,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.VehicleMetaVerifyResponse({}));
     }
     /**
-     * 车辆要素核验
+     * Vehicle Element Verification
+     *
+     * @remarks
+     * Verifies the consistency of name, ID number, vehicle license plate, and vehicle type.
      *
      * @param request - VehicleMetaVerifyRequest
      * @returns VehicleMetaVerifyResponse
@@ -2812,7 +3075,10 @@ class Client extends openapi_core_1.default {
         return await this.vehicleMetaVerifyWithOptions(request, runtime);
     }
     /**
-     * 车辆要素核验增强版
+     * Enhanced Vehicle Element Verification
+     *
+     * @remarks
+     * Verifies the consistency of name, ID number, license plate number, and vehicle type, and supports returning detailed vehicle information.
      *
      * @param request - VehicleMetaVerifyV2Request
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2856,7 +3122,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.VehicleMetaVerifyV2Response({}));
     }
     /**
-     * 车辆要素核验增强版
+     * Enhanced Vehicle Element Verification
+     *
+     * @remarks
+     * Verifies the consistency of name, ID number, license plate number, and vehicle type, and supports returning detailed vehicle information.
      *
      * @param request - VehicleMetaVerifyV2Request
      * @returns VehicleMetaVerifyV2Response
@@ -2866,7 +3135,10 @@ class Client extends openapi_core_1.default {
         return await this.vehicleMetaVerifyV2WithOptions(request, runtime);
     }
     /**
-     * 车辆信息识别
+     * Vehicle Information Recognition
+     *
+     * @remarks
+     * Query detailed vehicle information through the license plate number and vehicle type.
      *
      * @param request - VehicleQueryRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2901,7 +3173,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.VehicleQueryResponse({}));
     }
     /**
-     * 车辆信息识别
+     * Vehicle Information Recognition
+     *
+     * @remarks
+     * Query detailed vehicle information through the license plate number and vehicle type.
      *
      * @param request - VehicleQueryRequest
      * @returns VehicleQueryResponse