@alicloud/cloudauth20190307 3.13.4 → 3.14.1

package/src/models/InitFaceVerifyRequest.ts

@@ -5,16 +5,16 @@ import * as $dara from '@darabonba/typescript';
 export class InitFaceVerifyRequest extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether the SDK enables strict face quality detection:
+   * Specifies whether to enable strict face quality detection in the SDK. Valid values:
    * 
-   * - **Y**: enabled.
+   * - **Y**: Enables strict face quality detection.
    * 
-   * - **N**: disabled (default).
+   * - **N**: Does not enable strict face quality detection. This is the default value.
    * 
    * 
    * > 
-   * > - If this parameter is enabled, the SDK must integrate the [strict face quality detection module](https://www.alibabacloud.com/help/en/id-verification/financial-grade-id-verification/description-of-sdk-package-clipping). Strict quality detection may reduce the face authentication success rate.
-   * > - Only Android SDK 2.3.24 and later versions are supported.
+   * > - If you enable this parameter, the SDK must integrate the [strict face quality detection module](https://www.alibabacloud.com/help/en/id-verification/financial-grade-id-verification/description-of-sdk-package-clipping). Affected by strict quality detection, the success rate of face scanning may decrease.
+   * > - Only Android SDK 2.3.24 and later are supported.
    * 
    * @example
    * N
@@ -22,7 +22,7 @@ export class InitFaceVerifyRequest extends $dara.Model {
   appQualityCheck?: string;
   /**
    * @remarks
-   * The user authorization ID. Maximum length: 64 characters.
+   * The user authorization ID. The maximum length is 64 characters.
    * 
    * @example
    * 92d46b9e9e2d703f2897f350d5bd4149
@@ -30,9 +30,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
   authId?: string;
   /**
    * @remarks
-   * The date of birth on the certificate.
+   * The date of birth on the ID document.
    * 
-   * This field is required when **CertType** is set to **PASSPORT** and **Mode** is set to **3**.
+   * This parameter is required when the **CertType** parameter is set to **PASSPORT** and the **Mode** parameter is set to **3**.
    * 
    * @example
    * 1993-10-10
@@ -40,9 +40,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
   birthday?: string;
   /**
    * @remarks
-   * The security token that you generate to prevent duplication and tampering.
+   * The security token that you generate to prevent duplicate and tampered requests.
    * 
-   * If this value is set, the **CallbackToken** field is displayed in the callback URL.
+   * If you specify this parameter, the **CallbackToken** field is displayed in the callback URL.
    * 
    * @example
    * NMjvQanQgplBSaEI0sL86WnQplB
@@ -50,13 +50,13 @@ export class InitFaceVerifyRequest extends $dara.Model {
   callbackToken?: string;
   /**
    * @remarks
-   * The callback URL for the authentication result. The callback request method is GET by default, and the callback URL must start with `https`. After authentication is complete, the platform calls back this URL and automatically appends the `certifyId` and `passed` fields. The `passed` field returns the subcode value. Example: `https://www.alibabacloud.com?callbackToken=1000004826&certifyId=shaxxxx&passed=200.`
+   * The callback URL for authentication result notifications. The default callback request method is GET. The callback URL must start with `https`. After the authentication is completed, the platform invokes this URL and automatically appends the `certifyId` and `passed` fields. The value of the `passed` field is the subcode. Example: `https://www.aliyun.com?callbackToken=1000004826&certifyId=shaxxxx&passed=200`.
    * 
    * <notice>
    * 
-   * - The callback is triggered only when authentication is complete (including both passed and failed). If the user abandons authentication, an abnormal break occurs, or authentication is not performed, no notification is sent. After receiving the callback notification, invoke the query operation to obtain authentication details if needed.
-   * - The URL is validated for public network access before the operation is invoked. If the URL is not accessible over the public network, a 401 error is returned.
-   * - After receiving the callback, return HTTP status code 200. Otherwise, a retry is triggered with two callbacks within 3 seconds.
+   * - The callback is triggered only when the authentication is completed, including both successful and failed authentications. If the authentication is abandoned, an abnormal break occurs, or the authentication is not performed, no notification is sent. We recommend that you invoke the query API operation to obtain the authentication details after you receive the callback notification if needed.
+   * - The accessibility of the URL is verified before the API operation is invoked. If the URL does not support public network access, a 401 error is returned.
+   * - The API operation must return HTTP status code 200 after the callback. Otherwise, a retry is triggered, and two callbacks are sent within 3 seconds.
    * 
    * </notice>
    * 
@@ -66,13 +66,13 @@ export class InitFaceVerifyRequest extends $dara.Model {
   callbackUrl?: string;
   /**
    * @remarks
-   * Specifies whether to enable the camera selection feature:
+   * Specifies whether to enable the camera selection feature. Valid values:
    * 
-   * - **Y**: enabled.
+   * - **Y**: Enables the feature.
    * 
-   * - **N**: disabled (default).
+   * - **N**: Does not enable the feature. This is the default value.
    * 
-   * > This feature takes effect only for PC integration mode. After this feature is enabled, users can select a camera for authentication.
+   * > This feature takes effect only in the PC integration mode. After this feature is enabled, users can select a camera for authentication.
    * 
    * @example
    * N
@@ -83,12 +83,12 @@ export class InitFaceVerifyRequest extends $dara.Model {
    * The real name.
    * 
    * @example
-   * 张三
+   * Zhang San
    */
   certName?: string;
   /**
    * @remarks
-   * The certificate number.
+   * The ID document number.
    * 
    * @example
    * 330103xxxxxxxxxxxx
@@ -96,8 +96,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
   certNo?: string;
   /**
    * @remarks
-   * The certificate type.
-   * Currently, only ID cards are supported. Set this parameter to IDENTITY_CARD.
+   * The type of the ID document.
+   * 
+   * Only ID cards are supported. Set the value to IDENTITY_CARD.
    * 
    * @example
    * IDENTITY_CARD
@@ -105,11 +106,11 @@ export class InitFaceVerifyRequest extends $dara.Model {
   certType?: string;
   /**
    * @remarks
-   * >Warning: This parameter will be deprecated.</warning>
+   * **[Deprecated]**
    * 
-   * The CertifyId from a previous successful ID Verification. The photo from that authentication is used as the comparison photo.
+   * The CertifyId of a previous successful ID Verification. The photo used in the previous authentication is used as the comparison photo.
    * 
-   * > You can use one of the following four methods to submit a photo: FaceContrastPicture, FaceContrastPictureUrl, CertifyId, or OSS. Select only one method.
+   * > You can specify only one of the following parameters to pass the image: FaceContrastPicture, FaceContrastPictureUrl, CertifyId, and OSS.
    * 
    * @example
    * 0bfa7c493f850e5178b9f8613634c9xx
@@ -119,9 +120,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
    * @remarks
    * The type of the returned **CertifyUrl**. Valid values:
    * 
-   * - **L**: original long URL.
+   * - **L**: Original long URL.
    * 
-   * - **S** (default): short URL.
+   * - **S** (default): Short URL.
    * 
    * @example
    * L
@@ -129,7 +130,7 @@ export class InitFaceVerifyRequest extends $dara.Model {
   certifyUrlStyle?: string;
   /**
    * @remarks
-   * The Web SDK device type. Valid values: **WEB** or **H5**.
+   * The device type of the Web SDK. Valid values: **WEB** and **H5**.
    * 
    * > Only Web SDK device types are supported.
    * 
@@ -139,28 +140,47 @@ export class InitFaceVerifyRequest extends $dara.Model {
   certifyUrlType?: string;
   /**
    * @remarks
-   * Specifies whether to allow cropping of the face photo. By default, cropping is not allowed.
+   * Specifies whether to allow face image cropping. By default, cropping is not allowed. Valid values:
    * 
-   * - T: allows cropping.
+   * - T: Cropping is allowed.
    * 
-   * - F: does not allow cropping.
+   * - F: Cropping is not allowed.
    * 
-   * > If the requested image is not captured by a standard liveness detection SDK, allow cropping of the face photo. After this feature is enabled, the requested image is cropped and corrected before the request is sent to the service.
+   * > If the requested image is not collected by the standard liveness detection SDK, we recommend that you allow face image cropping. After this feature is enabled, the requested image is cropped and corrected before the request is sent to the service.
    * 
    * @example
    * T
    */
   crop?: string;
   /**
+   * @remarks
+   * Specifies whether to allow album upload. Valid values: Y and N. Default value: N.
+   * 
+   * @example
+   * Y
+   */
+  enableAlbumUpload?: string;
+  /**
+   * @remarks
+   * Specifies whether to enable the beauty filter. Valid values: Y and N.
+   * 
    * @example
    * Y
    */
   enableBeauty?: string;
   /**
    * @remarks
-   * The encryption algorithm. Currently, only the SM2 algorithm is supported.
+   * Specifies whether to enable speech synthesis for H5 willingness authentication. Valid values: Y and N. Default value: Y.
+   * 
+   * @example
+   * Y
+   */
+  enableTts?: string;
+  /**
+   * @remarks
+   * The encryption algorithm. Only the SM2 algorithm is supported.
    * 
-   * After encrypted transmission is enabled, pass in the encrypted CertName and CertNo. For more information about encryption, refer to [Parameter encryption description](https://www.alibabacloud.com/help/en/id-verification/financial-grade-id-verification/description-of-parameter-encryption#task-2229332).
+   * After encrypted transmission is enabled, you must pass the encrypted CertName and CertNo. For more information about encryption, see [Parameter encryption](https://www.alibabacloud.com/help/en/id-verification/financial-grade-id-verification/description-of-parameter-encryption#task-2229332).
    * 
    * @example
    * SM2
@@ -168,9 +188,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
   encryptType?: string;
   /**
    * @remarks
-   * The Base64-encoded photo.
+   * The Base64-encoded image.
    * 
-   * > You can use one of the following four methods to submit a photo: FaceContrastPicture, FaceContrastPictureUrl, CertifyId, or OSS. Select only one method.
+   * > You can specify only one of the following parameters to pass the image: FaceContrastPicture, FaceContrastPictureUrl, CertifyId, and OSS.
    * 
    * @example
    * /9j/4AAQSkZJRgABAQAASxxxxxxx
@@ -178,9 +198,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
   faceContrastPicture?: string;
   /**
    * @remarks
-   * The OSS photo URL. Currently, only authorized OSS photo URLs are supported.
+   * The URL of the image in OSS. Only authorized OSS image URLs are supported.
    * 
-   * > You can use one of the following four methods to submit a photo: FaceContrastPicture, FaceContrastPictureUrl, CertifyId, or OSS. Select only one method.
+   * > You can specify only one of the following parameters to pass the image: FaceContrastPicture, FaceContrastPictureUrl, CertifyId, and OSS.
    * 
    * @example
    * https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg
@@ -188,11 +208,11 @@ export class InitFaceVerifyRequest extends $dara.Model {
   faceContrastPictureUrl?: string;
   /**
    * @remarks
-   * The device assistant tag type. Valid values: **DeviceRisk**.
+   * The type of the Device Assistant tag. Set the value to **DeviceRisk**.
    * 
    * >
-   * > - Selecting device assistant output incurs additional fees. For more information, refer to [Paid value-added services](https://www.alibabacloud.com/help/en/id-verification/financial-grade-id-verification/face-guard).
-   * > - If you do not need device assistant tag output, do not pass this parameter or pass an empty value.
+   * > - Outputting Device Assistant tags incurs additional fees. For more information, see [Value-added services](https://www.alibabacloud.com/help/en/id-verification/financial-grade-id-verification/face-guard).
+   * > - If you do not need to output Device Assistant tags, you can leave this parameter empty or do not pass it.
    * 
    * @example
    * DeviceRisk
@@ -200,9 +220,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
   faceGuardOutput?: string;
   /**
    * @remarks
-   * Specifies whether to display the "I have completed authentication" button on the H5 fallback page after authentication is complete:
-   * - **Y**: enabled.
-   * - **N** (default): disabled.
+   * Specifies whether to display the I Have Completed Authentication button on the H5 downgrade page after authentication is completed. Valid values:
+   * - **Y**: Displays the button.
+   * - **N** (default): Hides the button.
    * 
    * @example
    * Y
@@ -218,7 +238,7 @@ export class InitFaceVerifyRequest extends $dara.Model {
   ip?: string;
   /**
    * @remarks
-   * The Metainfo environment parameter, which must be obtained through the client SDK.
+   * The Metainfo environment parameter. You must obtain this parameter by using the client SDK.
    * 
    * @example
    * {"zimVer":"3.0.0","appVersion": "1","bioMetaInfo": "4.1.0:11501568,0","appName": "com.aliyun.antcloudauth","deviceType": "ios","osVersion": "iOS 10.3.2","apdidToken": "","deviceModel": "iPhone9,1"}
@@ -234,13 +254,13 @@ export class InitFaceVerifyRequest extends $dara.Model {
   mobile?: string;
   /**
    * @remarks
-   * The method for obtaining passport NFC verification elements:
+   * The method to obtain the passport NFC verification elements. Valid values:
    * 
-   * - **1**: user input. The end user manually enters certificate element information using the UI provided by the Alibaba Cloud SDK.
+   * - **1**: User input. The end user manually enters the ID document element information by using the UI provided by the Alibaba Cloud SDK.
    * 
-   * - **3**: external parameter input. Certificate element information is passed in externally.
+   * - **3**: External parameter input. The ID document element information is passed from external sources.
    * 
-   * > To decode the encrypted information on the passport chip through NFC, three passport elements are required: name, date of birth, and certificate expiration date.
+   * > When the NFC decoder decrypts the encrypted information of the passport chip, it needs to obtain three passport elements: name, date of birth, and expiration date.
    * 
    * @example
    * 1
@@ -249,27 +269,27 @@ export class InitFaceVerifyRequest extends $dara.Model {
   /**
    * @remarks
    * The liveness detection type. Valid values:
-   * > The liveness detection type supports only the following values. Custom actions or combinations are not supported.
+   * > Only the following liveness detection types are supported. Custom actions or combinations are not supported.
    * 
-   * Note:
-   * The liveness detection type supports only the following values. Custom actions or combinations are not supported.
+   * Description
+   * Only the following liveness detection types are supported. Custom actions or combinations are not supported.
    * 
-   * - **LIVENESS** (default): blink
+   * - **LIVENESS** (default): Blinking.
    * 
-   * - **PHOTINUS_LIVENESS**: blink + colorful light
+   * - **PHOTINUS_LIVENESS**: Blinking and colorful light reflection.
    * 
-   * - **MULTI_ACTION**: blink + head shake (the order of blink and head shake is random)
+   * - **MULTI_ACTION**: Blinking and head turning (the order is random).
    * 
-   * - **MOVE_ACTION** (recommended): move closer/farther + blink
+   * - **MOVE_ACTION** (recommended): Moving closer or farther and blinking.
    * 
-   * - **MOVE_PHOTINUS**: move closer/farther + colorful light
+   * - **MOVE_PHOTINUS**: Moving closer or farther and colorful light reflection.
    * 
    * > 
-   * >- **The default liveness detection type** is supported in the following versions:
+   * >- **The default liveness detection type** is supported in the following SDK versions:
    * >   - Android SDK 1.2.6 and later
    * >   - iOS SDK 1.2.4 and later
    * >   - Harmony SDK 1.0.0 and later
-   * >- Other types are supported in the latest Android/iOS/Harmony SDK versions. Integrate the latest version.
+   * >- Other types are supported in the latest SDK versions for Android, iOS, and Harmony. We recommend that you integrate the latest SDK version.
    * 
    * @example
    * MOVE_ACTION
@@ -277,11 +297,11 @@ export class InitFaceVerifyRequest extends $dara.Model {
   model?: string;
   /**
    * @remarks
-   * Specifies whether to block authentication when multiple faces are detected on the device. Valid values:
+   * Specifies whether to intercept the request when multiple faces are detected on the terminal. Valid values:
    * 
-   * - **Y**: blocked. The client prompts the user to redo face authentication.
+   * - **Y**: Intercepts the request. The client prompts the user to scan the face again.
    * 
-   * - **N** (default): not blocked. The largest face in the frame is sent to the server for security detection.
+   * - **N** (default): Does not intercept the request. The largest face in the face scanning screen is sent to the server for security detection.
    * 
    * @example
    * Y
@@ -289,9 +309,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
   needMultiFaceCheck?: string;
   /**
    * @remarks
-   * The bucket name of the authorized OSS space.
+   * The name of the authorized OSS bucket.
    * 
-   * > You can use one of the following four methods to submit a photo: FaceContrastPicture, FaceContrastPictureUrl, CertifyId, or OSS. Select only one method.
+   * > You can specify only one of the following parameters to pass the image: FaceContrastPicture, FaceContrastPictureUrl, CertifyId, and OSS.
    * 
    * @example
    * cn-shanghai-aliyun-cloudauth-xxxxx
@@ -299,9 +319,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
   ossBucketName?: string;
   /**
    * @remarks
-   * The file name in the authorized OSS space.
+   * The name of the object in the authorized OSS bucket.
    * 
-   * > You can use one of the following four methods to submit a photo: FaceContrastPicture, FaceContrastPictureUrl, CertifyId, or OSS. Select only one method.
+   * > You can specify only one of the following parameters to pass the image: FaceContrastPicture, FaceContrastPictureUrl, CertifyId, and OSS.
    * 
    * @example
    * verify/xxxxx/xxxxxx.jpeg
@@ -311,7 +331,7 @@ export class InitFaceVerifyRequest extends $dara.Model {
    * @remarks
    * The unique identifier of the merchant request.
    * 
-   * The value is a 32-character alphanumeric string. The first few characters are a custom abbreviation defined by the merchant, the middle part can be a time segment, and the last part can be a random or incremental sequence.
+   * The value is a 32-character alphanumeric string. The first few characters are a custom abbreviation of the merchant, the middle part can be a period of time, and the last part can be a random or incremental sequence.
    * 
    * @example
    * e0c34a77f5ac40a5aa5e6ed20c353888
@@ -319,17 +339,17 @@ export class InitFaceVerifyRequest extends $dara.Model {
   outerOrderNo?: string;
   /**
    * @remarks
-   * The fallback configuration when WebRTC or WebAssembly is incompatible during mobile H5 authentication.
+   * The downgrade configuration when WebRTC or WebAssembly is incompatible during mobile H5 authentication. Valid values:
    * 
-   * - **keep**: fallback is not supported. The system returns directly.
+   * - **keep**: Downgrade is not supported. The result is directly returned.
    * 
-   * - **url** (default): fallback is supported. An authentication URL is returned. The user opens or switches to a browser to authenticate using this URL.
+   * - **url** (default): Downgrade is supported. The authentication URL is returned. The user opens or switches to a browser by using this URL for authentication.
    * 
-   * - **video**: fallback is supported. The system camera records a 3 to 5 second blink video for authentication.
+   * - **video**: Downgrade is supported. The system camera is used to record a 3- to 5-second blinking video for authentication.
    * 
    * 
    * > 
-   * > When the fallback mode is Video, the following features are disabled and product security is reduced. Configure this mode only for security scenarios.
+   * > When the downgrade mode is set to video, the following features become invalid and product security is reduced. We recommend that you configure this mode only for security scenarios.
    * > - The liveness detection type setting does not take effect.
    * > - The VideoEvidence feature is not supported.
    * 
@@ -339,10 +359,10 @@ export class InitFaceVerifyRequest extends $dara.Model {
   procedurePriority?: string;
   /**
    * @remarks
-   * A fixed value. This parameter varies depending on the product plan:
-   * - APP authentication plan: set to ID_PRO.
-   * - Face liveness verification plan: set to PV_FV.
-   * - Liveness detection plan: set to LR_FR.
+   * The fixed value. The value of this parameter varies based on the product solution:
+   * - APP authentication solution: Set the value to ID_PRO.
+   * - Face liveness verification solution: Set the value to PV_FV.
+   * - Liveness detection solution: Set the value to LR_FR.
    * 
    * @example
    * ID_PRO
@@ -350,11 +370,11 @@ export class InitFaceVerifyRequest extends $dara.Model {
   productCode?: string;
   /**
    * @remarks
-   * Specifies whether to enable the rare character mode:
+   * Specifies whether to enable the rare character mode. Valid values:
    * 
-   * - **Y**: enabled. An information input box is displayed before authentication. The user must enter the name with rare characters and the ID card number, and agree to the protocol before starting the authentication process.
+   * - **Y**: Enables the mode. Before authentication, an information input box appears. The user must enter the name with rare characters and the ID card number, and agree to the agreement before the authentication process starts.
    * 
-   * - **N**: disabled (default).
+   * - **N**: Does not enable the mode. This is the default value.
    * 
    * @example
    * Y
@@ -362,13 +382,13 @@ export class InitFaceVerifyRequest extends $dara.Model {
   rarelyCharacters?: string;
   /**
    * @remarks
-   * Specifies whether to read the certificate photo:
+   * Specifies whether to read the ID document photo. Valid values:
    * 
-   * - **Y**: read.
+   * - **Y**: Reads the photo.
    * 
-   * - **N**: do not read.
+   * - **N**: Does not read the photo.
    * 
-   * > If the certificate face photo is needed in subsequent authentication steps, set this parameter to Y.
+   * > If you need to use the face photo from the ID document in subsequent authentication steps, we recommend that you set this parameter to Y.
    * 
    * @example
    * Y
@@ -384,7 +404,7 @@ export class InitFaceVerifyRequest extends $dara.Model {
   returnUrl?: string;
   /**
    * @remarks
-   * The authentication scenario ID.
+   * The ID of the authentication scenario.
    * 
    * @example
    * 1000000006
@@ -392,18 +412,18 @@ export class InitFaceVerifyRequest extends $dara.Model {
   sceneId?: number;
   /**
    * @remarks
-   * The elderly-friendly configuration parameter. This parameter takes effect for each authentication request. You can select different parameters for each authentication request based on the business attributes, customer distribution, and operational characteristics of your app. Valid values (default: 0):
+   * The age-friendly configuration parameter. This parameter takes effect for each authentication request. You can select different parameters for each authentication request based on the business property, customer distribution, and operation attribute of your app. The following options are available. Default value: 0.
    * 
-   * - **0**: disabled. The elderly-friendly mode is not enabled for the current authentication request.
+   * - **0**: Disables the age-friendly pattern for the current authentication request.
    * 
-   * - **1**: enabled. The elderly-friendly mode is enabled for the current authentication request.
+   * - **1**: Enables the age-friendly pattern for the current authentication request.
    * 
-   * - **2**: user choice.
+   * - **2**: Allows the user to select the pattern.
    * 
    * 
-   * Allows the end user to select the authentication mode. The product guide page provides two authentication entries: "Start Authentication" and "Elderly Authentication Mode". When the user selects "Elderly Authentication Mode", the system enters elderly-friendly mode.
+   * The end user can select the authentication pattern. The product guide page provides two authentication entries: Start Authentication and Senior Authentication Pattern. When the user selects Senior Authentication Pattern, the system enters the age-friendly pattern.
    * > 
-   * > - The elderly-friendly parameter takes effect only when the liveness detection type **Model** is set to **LIVENESS** or **MULTI_ACTION**.
+   * > - The age-friendly parameter takes effect only when the liveness detection type **Model** is set to **LIVENESS** or **MULTI_ACTION**.
    * 
    * @example
    * 0
@@ -411,9 +431,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
   suitableType?: string;
   /**
    * @remarks
-   * The UI configuration file URL.
+   * The URL of the UI configuration file.
    * 
-   * You can view the complete configuration in [Web SDK UI custom configuration](https://www.alibabacloud.com/help/en/id-verification/financial-grade-id-verification/web-sdk-ui-custom-configuration-description).
+   * For the complete configuration, see [Web SDK UI custom configuration](https://www.alibabacloud.com/help/en/id-verification/financial-grade-id-verification/web-sdk-ui-custom-configuration-description).
    * 
    * @example
    * www.aliyundoc.com
@@ -421,7 +441,7 @@ export class InitFaceVerifyRequest extends $dara.Model {
   uiCustomUrl?: string;
   /**
    * @remarks
-   * The custom user ID defined by the business. Keep this value unique.
+   * The custom user ID in the customer business. Make sure that the ID is unique.
    * 
    * @example
    * 123456789
@@ -429,9 +449,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
   userId?: string;
   /**
    * @remarks
-   * The certificate expiration date.
+   * The expiration date of the ID document.
    * 
-   * This field is required when **CertType** is set to **PASSPORT** and **Mode** is set to **3**.
+   * This parameter is required when the **CertType** parameter is set to **PASSPORT** and the **Mode** parameter is set to **3**.
    * 
    * @example
    * 2039-06-10
@@ -439,13 +459,13 @@ export class InitFaceVerifyRequest extends $dara.Model {
   validityDate?: string;
   /**
    * @remarks
-   * Specifies whether to enable video evidence:
+   * Specifies whether to enable video evidence. Valid values:
    * 
-   * - **true**: enabled.
+   * - **true**: Enables video evidence.
    * 
-   * - **false**: disabled (default).
+   * - **false**: Does not enable video evidence. This is the default value.
    * 
-   * > Because video files are large, the system discards video files to prioritize the transmission of essential authentication images when the network is unstable. Set video as a weak dependency in your business logic.
+   * > Because video files are large, the system discards video files to prioritize the transmission of necessary authentication images when the network is unstable. We recommend that you set your business to weakly depend on videos.
    * 
    * @example
    * false
@@ -453,14 +473,14 @@ export class InitFaceVerifyRequest extends $dara.Model {
   videoEvidence?: string;
   /**
    * @remarks
-   * The custom voluntary content. This parameter is required when personalized settings are enabled. The format is a JSON string of a String List.
+   * The custom willingness content. This parameter is required when personalized settings are enabled. The value is a JSON string of a string list.
    * 
-   * - For read-aloud scenarios: the content cannot exceed 60 Chinese characters (excluding punctuation), and the List contains only 1 element.
+   * - In the read-along scenario: The content cannot exceed 60 Chinese characters (excluding punctuation marks), and the list contains only one element.
    * 
-   * - For Q&A scenarios: a maximum of 3 questions can be set. Each question cannot exceed 30 Chinese characters, and each question is a separate element in the List.
+   * - In the Q&A scenario: You can configure up to three questions. Each question cannot exceed 30 Chinese characters, and each question is an element in the list.
    * 
    * @example
-   * ["本人王先生同意***协议。"]
+   * ["I, Mr. Wang, agree to the *** agreement."]
    */
   voluntaryCustomizedContent?: string;
   static names(): { [key: string]: string } {
@@ -478,7 +498,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
       certifyUrlStyle: 'CertifyUrlStyle',
       certifyUrlType: 'CertifyUrlType',
       crop: 'Crop',
+      enableAlbumUpload: 'EnableAlbumUpload',
       enableBeauty: 'EnableBeauty',
+      enableTts: 'EnableTts',
       encryptType: 'EncryptType',
       faceContrastPicture: 'FaceContrastPicture',
       faceContrastPictureUrl: 'FaceContrastPictureUrl',
@@ -523,7 +545,9 @@ export class InitFaceVerifyRequest extends $dara.Model {
       certifyUrlStyle: 'string',
       certifyUrlType: 'string',
       crop: 'string',
+      enableAlbumUpload: 'string',
       enableBeauty: 'string',
+      enableTts: 'string',
       encryptType: 'string',
       faceContrastPicture: 'string',
       faceContrastPictureUrl: 'string',

package/src/models/InitFaceVerifyResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class InitFaceVerifyResponseBodyResultObject extends $dara.Model {
   /**
    * @remarks
-   * The unique identifier for ID Verification.
+   * The unique identifier of ID Verification.
    * 
    * @example
    * 91707dc296d469ad38e4c5efa6a0f24b
@@ -13,18 +13,16 @@ export class InitFaceVerifyResponseBodyResultObject extends $dara.Model {
   certifyId?: string;
   /**
    * @remarks
-   * The URL for performing ID Verification in a web browser. After authentication is complete, the page redirects based on the ReturnUrl parameter.
+   * The URL for ID Verification in a web browser. After the authentication is completed, the user is redirected based on the ReturnUrl parameter.
    * 
    * >Notice: 
    * 
-   * - The CertifyUrl returned by the initialization operation is **valid for 30 minutes and can be submitted for authentication only once**. Use it within the validity period and do not reuse it.
-   * - This parameter requires the **MetaInfo** parameter to be correctly passed in to return a CertifyUrl that matches the client. If the URL cannot be obtained, check whether **MetaInfo** and other input parameters are correct.
+   * - The CertifyUrl returned by the initialization API operation is **valid for 30 minutes and can be used to submit authentication only once**. Use it within the validity period to avoid repeated use.
+   * - This parameter requires the correct input of the **MetaInfo** parameter to return a CertifyUrl that matches the client. If you cannot obtain it, check whether **MetaInfo** and other input parameters are correct.
    * 
-   * - The domain name of this URL may change with service updates. To ensure normal service availability, do not apply access control to this domain name.
+   * - The domain name of this URL may change with service updates. To ensure normal service availability, we recommend that you do not configure access control for this domain name.
    * 
-   * - Do not use incognito mode or modify the URL during browser redirection. Otherwise, a **signature exception** error may occur.
-   * 
-   * .
+   * - When the browser redirects, try not to use incognito mode or change the URL. Otherwise, a **signature exception** error may occur.
    * 
    * @example
    * https://t.aliyun.com/****
@@ -56,7 +54,7 @@ export class InitFaceVerifyResponseBodyResultObject extends $dara.Model {
 export class InitFaceVerifyResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The response code. 200 indicates success. Other values indicate failure.
+   * The return code. A value of 200 indicates success, and other values indicate failure.
    * 
    * @example
    * 200