@alicloud/green20220302 2.2.9 → 2.2.11

package/src/client.ts

@@ -124,7 +124,7 @@ export class DescribeFileModerationResultResponse extends $tea.Model {
 export class DescribeImageModerationResultRequest extends $tea.Model {
   /**
    * @remarks
-   * The reqId field returned by the Image Async Moderation API.
+   * The ReqId field returned by the asynchronous Image Moderation 2.0 API.
    * 
    * @example
    * B0963D30-BAB4-562F-9ED0-7A23AEC51C7C
@@ -158,7 +158,7 @@ export class DescribeImageModerationResultResponseBody extends $tea.Model {
   code?: number;
   /**
    * @remarks
-   * The data returned.
+   * The image moderation results.
    */
   data?: DescribeImageModerationResultResponseBodyData;
   /**
@@ -171,7 +171,7 @@ export class DescribeImageModerationResultResponseBody extends $tea.Model {
   msg?: string;
   /**
    * @remarks
-   * The request ID.
+   * The request ID, which is used to locate and troubleshoot issues.
    * 
    * @example
    * 2881AD4F-638B-52A3-BA20-F74C5B1CEAE3
@@ -420,7 +420,7 @@ export class DescribeUploadTokenResponse extends $tea.Model {
 export class DescribeUrlModerationResultRequest extends $tea.Model {
   /**
    * @remarks
-   * The reqId field returned by the Url Async Moderation API.
+   * The ReqId field returned by an asynchronous URL moderation operation.
    * 
    * @example
    * B0963D30-BAB4-562F-9ED0-7A23AEC51C7C
@@ -446,7 +446,7 @@ export class DescribeUrlModerationResultRequest extends $tea.Model {
 export class DescribeUrlModerationResultResponseBody extends $tea.Model {
   /**
    * @remarks
-   * The returned HTTP status code.
+   * The returned HTTP status code. The status code 200 indicates that the request was successful.
    * 
    * @example
    * 200
@@ -752,7 +752,27 @@ export class ImageAsyncModerationResponse extends $tea.Model {
 export class ImageModerationRequest extends $tea.Model {
   /**
    * @remarks
-   * The type of the moderation service.
+   * The moderation services supported by Image Moderation 2.0. Valid values:
+   * 
+   * *   baselineCheck: common baseline moderation
+   * *   baselineCheck_pro: common baseline moderation_Professional
+   * *   baselineCheck_cb: common baseline moderation_For regions outside the Chinese mainland
+   * *   tonalityImprove: content governance moderation
+   * *   aigcCheck: AI-generated image identification
+   * *   profilePhotoCheck: avatar image moderation
+   * *   advertisingCheck: marketing material identification
+   * *   liveStreamCheck: moderation of screenshots of videos and live streams
+   * 
+   * Valid values:
+   * 
+   * *   liveStreamCheck: moderation of screenshots of videos and live streams
+   * *   baselineCheck: common baseline moderation
+   * *   aigcCheck: AI-generated image identification
+   * *   baselineCheck_pro: common baseline moderation_Professional
+   * *   advertisingCheck: marketing material identification
+   * *   baselineCheck_cb: common baseline moderation_For regions outside the Chinese mainland
+   * *   tonalityImprove: content governance moderation
+   * *   profilePhotoCheck: avatar image moderation
    * 
    * @example
    * baselineCheck
@@ -762,6 +782,9 @@ export class ImageModerationRequest extends $tea.Model {
    * @remarks
    * The parameters required by the moderation service. The value is a JSON string.
    * 
+   * *   imageUrl: the URL of the object that you want to moderate. This parameter is required.
+   * *   dataId: the ID of the object that you want to moderate. This parameter is optional.
+   * 
    * @example
    * {"imageUrl":"https://www.aliyun.com/test.jpg","dataId":"img1234567"}
    */
@@ -788,7 +811,7 @@ export class ImageModerationRequest extends $tea.Model {
 export class ImageModerationResponseBody extends $tea.Model {
   /**
    * @remarks
-   * The returned HTTP status code.
+   * The returned HTTP status code. The status code 200 indicates that the request was successful.
    * 
    * @example
    * 200
@@ -796,7 +819,7 @@ export class ImageModerationResponseBody extends $tea.Model {
   code?: number;
   /**
    * @remarks
-   * The data returned.
+   * The moderation results.
    */
   data?: ImageModerationResponseBodyData;
   /**
@@ -809,7 +832,7 @@ export class ImageModerationResponseBody extends $tea.Model {
   msg?: string;
   /**
    * @remarks
-   * The request ID.
+   * The request ID, which is used to locate and troubleshoot issues.
    * 
    * @example
    * 6CF2815C-C8C7-4A01-B52E-FF6E24F53492
@@ -980,7 +1003,15 @@ export class TextModerationResponse extends $tea.Model {
 export class TextModerationPlusRequest extends $tea.Model {
   /**
    * @remarks
-   * The type of the moderation service.
+   * The moderation service.
+   * 
+   * Valid values:
+   * 
+   * *   chat_detection_pro: moderation of interactive content of private chats_Professional
+   * *   llm_response_moderation: moderation of text generated by LLMs
+   * *   llm_query_moderation: moderation of input text of LLMs
+   * *   nickname_detection_pro: moderation of user nicknames_Professional
+   * *   comment_detection_pro: moderation of comment content of public chats_Professional
    * 
    * @example
    * llm_query_moderation
@@ -1016,7 +1047,7 @@ export class TextModerationPlusRequest extends $tea.Model {
 export class TextModerationPlusResponseBody extends $tea.Model {
   /**
    * @remarks
-   * The returned HTTP status code.
+   * The returned HTTP status code. The status code 200 indicates that the request was successful.
    * 
    * @example
    * 200
@@ -1024,7 +1055,7 @@ export class TextModerationPlusResponseBody extends $tea.Model {
   code?: number;
   /**
    * @remarks
-   * The data returned.
+   * The moderation results.
    */
   data?: TextModerationPlusResponseBodyData;
   /**
@@ -1037,7 +1068,7 @@ export class TextModerationPlusResponseBody extends $tea.Model {
   message?: string;
   /**
    * @remarks
-   * The request ID.
+   * Id of the request
    * 
    * @example
    * AAAAAA-BBBB-CCCCC-DDDD-EEEEEEEE****
@@ -2222,12 +2253,20 @@ export class DescribeFileModerationResultResponseBodyData extends $tea.Model {
 export class DescribeImageModerationResultResponseBodyDataResult extends $tea.Model {
   /**
    * @remarks
-   * The score of the confidence level. Valid values: 0 to 100. The value is accurate to two decimal places. Some labels do not have scores of confidence levels.
+   * The score of the confidence level. Valid values: 0 to 100. The value is accurate to two decimal places.
    * 
    * @example
    * 81.22
    */
   confidence?: number;
+  /**
+   * @remarks
+   * The description of the result.
+   * 
+   * @example
+   * no risk
+   */
+  description?: string;
   /**
    * @remarks
    * The labels returned after the image moderation.
@@ -2239,6 +2278,7 @@ export class DescribeImageModerationResultResponseBodyDataResult extends $tea.Mo
   static names(): { [key: string]: string } {
     return {
       confidence: 'Confidence',
+      description: 'Description',
       label: 'Label',
     };
   }
@@ -2246,6 +2286,7 @@ export class DescribeImageModerationResultResponseBodyDataResult extends $tea.Mo
   static types(): { [key: string]: any } {
     return {
       confidence: 'number',
+      description: 'string',
       label: 'string',
     };
   }
@@ -2258,7 +2299,7 @@ export class DescribeImageModerationResultResponseBodyDataResult extends $tea.Mo
 export class DescribeImageModerationResultResponseBodyData extends $tea.Model {
   /**
    * @remarks
-   * The ID of the moderated object.
+   * The value of dataId that is specified in the API request. If this parameter is not specified in the API request, this field is not available in the response.
    * 
    * @example
    * 2a5389eb-4ff8-4584-ac99-644e2a539aa1
@@ -2266,7 +2307,7 @@ export class DescribeImageModerationResultResponseBodyData extends $tea.Model {
   dataId?: string;
   /**
    * @remarks
-   * Image frame information.
+   * The information about the captured frames.
    * 
    * @example
    * [{"result":[{"confidence":81.22,"label":"violent_explosion"}]}]
@@ -2274,7 +2315,7 @@ export class DescribeImageModerationResultResponseBodyData extends $tea.Model {
   frame?: string;
   /**
    * @remarks
-   * Number of result frames
+   * The number of frames.
    * 
    * @example
    * 1
@@ -2619,7 +2660,7 @@ export class DescribeUploadTokenResponseBodyData extends $tea.Model {
 export class DescribeUrlModerationResultResponseBodyDataExtraInfo extends $tea.Model {
   /**
    * @remarks
-   * ICP record number.
+   * The ICP number.
    * 
    * @example
    * xx
@@ -2627,12 +2668,19 @@ export class DescribeUrlModerationResultResponseBodyDataExtraInfo extends $tea.M
   icpNo?: string;
   /**
    * @remarks
-   * ICP filing type.
+   * The type of the ICP filing.
    * 
    * @example
    * xx
    */
   icpType?: string;
+  /**
+   * @remarks
+   * The type of site
+   * 
+   * @example
+   * game
+   */
   siteType?: string;
   static names(): { [key: string]: string } {
     return {
@@ -2658,7 +2706,7 @@ export class DescribeUrlModerationResultResponseBodyDataExtraInfo extends $tea.M
 export class DescribeUrlModerationResultResponseBodyDataResult extends $tea.Model {
   /**
    * @remarks
-   * The score of the confidence level. Valid values: 0 to 100. The value is accurate to two decimal places. Some labels do not have scores of confidence levels.
+   * The score of the confidence level. Valid values: 0 to 100. The value is accurate to two decimal places.
    * 
    * @example
    * 81.22
@@ -2666,7 +2714,7 @@ export class DescribeUrlModerationResultResponseBodyDataResult extends $tea.Mode
   confidence?: number;
   /**
    * @remarks
-   * The labels returned after the url async moderation.
+   * The labels returned after the asynchronous URL moderation.
    * 
    * @example
    * sexual_url
@@ -2694,7 +2742,7 @@ export class DescribeUrlModerationResultResponseBodyDataResult extends $tea.Mode
 export class DescribeUrlModerationResultResponseBodyData extends $tea.Model {
   /**
    * @remarks
-   * The ID of the moderated object.
+   * The value of dataId that is specified in the API request. If this parameter is not specified in the API request, this field is not available in the response.
    * 
    * @example
    * 26769ada6e264e7ba9aa048241e12be9
@@ -2702,12 +2750,12 @@ export class DescribeUrlModerationResultResponseBodyData extends $tea.Model {
   dataId?: string;
   /**
    * @remarks
-   * Supplementary information.
+   * The supplementary information.
    */
   extraInfo?: DescribeUrlModerationResultResponseBodyDataExtraInfo;
   /**
    * @remarks
-   * The reqId field returned by the Url Async Moderation API.
+   * The ReqId field returned by an asynchronous URL moderation operation.
    * 
    * @example
    * B0963D30-BAB4-562F-9ED0-7A23AEC51C7C
@@ -2715,7 +2763,7 @@ export class DescribeUrlModerationResultResponseBodyData extends $tea.Model {
   reqId?: string;
   /**
    * @remarks
-   * The results of url async moderation parameters such as the label parameter and the confidence parameter.
+   * The returned results.
    */
   result?: DescribeUrlModerationResultResponseBodyDataResult[];
   static names(): { [key: string]: string } {
@@ -3071,9 +3119,37 @@ export class ImageModerationResponseBodyDataExtOcrResult extends $tea.Model {
 }
 
 export class ImageModerationResponseBodyDataExtPublicFigureLocation extends $tea.Model {
+  /**
+   * @remarks
+   * The height
+   * 
+   * @example
+   * 44
+   */
   h?: number;
+  /**
+   * @remarks
+   * The weight
+   * 
+   * @example
+   * 33
+   */
   w?: number;
+  /**
+   * @remarks
+   * X coordinate
+   * 
+   * @example
+   * 11
+   */
   x?: number;
+  /**
+   * @remarks
+   * Y coordinate
+   * 
+   * @example
+   * 22
+   */
   y?: number;
   static names(): { [key: string]: string } {
     return {
@@ -3115,6 +3191,10 @@ export class ImageModerationResponseBodyDataExtPublicFigure extends $tea.Model {
    * xx
    */
   figureName?: string;
+  /**
+   * @remarks
+   * the data array of location info
+   */
   location?: ImageModerationResponseBodyDataExtPublicFigureLocation[];
   static names(): { [key: string]: string } {
     return {
@@ -3414,7 +3494,15 @@ export class ImageModerationResponseBodyDataResult extends $tea.Model {
   confidence?: number;
   /**
    * @remarks
-   * The labels returned after the image moderation.
+   * The description of the result.
+   * 
+   * @example
+   * no risk
+   */
+  description?: string;
+  /**
+   * @remarks
+   * The labels returned after the image moderation. Multiple risk labels and the corresponding scores of confidence levels may be returned for an image.
    * 
    * @example
    * violent_explosion
@@ -3423,6 +3511,7 @@ export class ImageModerationResponseBodyDataResult extends $tea.Model {
   static names(): { [key: string]: string } {
     return {
       confidence: 'Confidence',
+      description: 'Description',
       label: 'Label',
     };
   }
@@ -3430,6 +3519,7 @@ export class ImageModerationResponseBodyDataResult extends $tea.Model {
   static types(): { [key: string]: any } {
     return {
       confidence: 'number',
+      description: 'string',
       label: 'string',
     };
   }
@@ -3444,6 +3534,8 @@ export class ImageModerationResponseBodyData extends $tea.Model {
    * @remarks
    * The ID of the moderated object.
    * 
+   * >  If you specify the dataId parameter in the request, the value of the dataId parameter is returned in the response.
+   * 
    * @example
    * fb5ffab1-993b-449f-b8d6-b97d5e3331f2
    */
@@ -3455,7 +3547,7 @@ export class ImageModerationResponseBodyData extends $tea.Model {
   ext?: ImageModerationResponseBodyDataExt;
   /**
    * @remarks
-   * The results of image moderation parameters such as the label parameter and the confidence parameter.
+   * The results of image moderation parameters such as the label parameter and the confidence parameter, which are an array structure.
    */
   result?: ImageModerationResponseBodyDataResult[];
   /**
@@ -3548,7 +3640,7 @@ export class TextModerationResponseBodyData extends $tea.Model {
 export class TextModerationPlusResponseBodyDataAdvice extends $tea.Model {
   /**
    * @remarks
-   * Answer
+   * The answer.
    * 
    * @example
    * XXX
@@ -3594,7 +3686,7 @@ export class TextModerationPlusResponseBodyDataAdvice extends $tea.Model {
 export class TextModerationPlusResponseBodyDataResultCustomizedHit extends $tea.Model {
   /**
    * @remarks
-   * Hit keywords, comma separated.
+   * The terms that are hit. Multiple terms are separated by commas (,).
    * 
    * @example
    * xxx
@@ -3602,7 +3694,7 @@ export class TextModerationPlusResponseBodyDataResultCustomizedHit extends $tea.
   keyWords?: string;
   /**
    * @remarks
-   * Library Name
+   * The library name.
    * 
    * @example
    * test
@@ -3630,7 +3722,7 @@ export class TextModerationPlusResponseBodyDataResultCustomizedHit extends $tea.
 export class TextModerationPlusResponseBodyDataResult extends $tea.Model {
   /**
    * @remarks
-   * Confidence score, 0 to 100, reserved to 2 decimal places.
+   * The score of the confidence level. Valid values: 0 to 100. The value is accurate to two decimal places.
    * 
    * @example
    * 81.22
@@ -3638,12 +3730,20 @@ export class TextModerationPlusResponseBodyDataResult extends $tea.Model {
   confidence?: number;
   /**
    * @remarks
-   * Custom keyword hits
+   * The custom term hit by the moderated content.
    */
   customizedHit?: TextModerationPlusResponseBodyDataResultCustomizedHit[];
   /**
    * @remarks
-   * Labels.
+   * The description of the label.
+   * 
+   * @example
+   * none
+   */
+  description?: string;
+  /**
+   * @remarks
+   * The label.
    * 
    * @example
    * porn
@@ -3651,7 +3751,7 @@ export class TextModerationPlusResponseBodyDataResult extends $tea.Model {
   label?: string;
   /**
    * @remarks
-   * Risk words
+   * The term hit by the moderated content.
    * 
    * @example
    * XXX
@@ -3661,6 +3761,7 @@ export class TextModerationPlusResponseBodyDataResult extends $tea.Model {
     return {
       confidence: 'Confidence',
       customizedHit: 'CustomizedHit',
+      description: 'Description',
       label: 'Label',
       riskWords: 'RiskWords',
     };
@@ -3670,6 +3771,7 @@ export class TextModerationPlusResponseBodyDataResult extends $tea.Model {
     return {
       confidence: 'number',
       customizedHit: { 'type': 'array', 'itemType': TextModerationPlusResponseBodyDataResultCustomizedHit },
+      description: 'string',
       label: 'string',
       riskWords: 'string',
     };
@@ -3683,12 +3785,12 @@ export class TextModerationPlusResponseBodyDataResult extends $tea.Model {
 export class TextModerationPlusResponseBodyData extends $tea.Model {
   /**
    * @remarks
-   * Advice
+   * The suggestion.
    */
   advice?: TextModerationPlusResponseBodyDataAdvice[];
   /**
    * @remarks
-   * The moderation results.
+   * The results.
    */
   result?: TextModerationPlusResponseBodyDataResult[];
   /**
@@ -3701,7 +3803,7 @@ export class TextModerationPlusResponseBodyData extends $tea.Model {
   riskLevel?: string;
   /**
    * @remarks
-   * Score.
+   * The score.
    * 
    * @example
    * 1
@@ -4660,7 +4762,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询异步检测结果
+   * Obtains the moderation results of an Image Moderation 2.0 task.
+   * 
+   * @remarks
+   *   Billing: This operation is free of charge.
+   * *   QPS limit: You can call this operation up to 100 times per second per account. If the number of the calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
    * 
    * @param request - DescribeImageModerationResultRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -4691,7 +4797,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询异步检测结果
+   * Obtains the moderation results of an Image Moderation 2.0 task.
+   * 
+   * @remarks
+   *   Billing: This operation is free of charge.
+   * *   QPS limit: You can call this operation up to 100 times per second per account. If the number of the calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
    * 
    * @param request - DescribeImageModerationResultRequest
    * @returns DescribeImageModerationResultResponse
@@ -4780,7 +4890,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询 url 检测结果
+   * Queries the moderation results based on the ReqId returned by asynchronous URL moderation.
+   * 
+   * @remarks
+   *   Billing: This operation is free of charge.
+   * *   Query timeout: We recommend that you query moderation results at least 480 seconds after you send an asynchronous moderation request. Content Moderation retains moderation results for up to 3 days. After 3 days, the results are deleted.
+   * *   You can call this operation up to 100 times per second per account. If the number of the calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
    * 
    * @param request - DescribeUrlModerationResultRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -4811,7 +4926,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询 url 检测结果
+   * Queries the moderation results based on the ReqId returned by asynchronous URL moderation.
+   * 
+   * @remarks
+   *   Billing: This operation is free of charge.
+   * *   Query timeout: We recommend that you query moderation results at least 480 seconds after you send an asynchronous moderation request. Content Moderation retains moderation results for up to 3 days. After 3 days, the results are deleted.
+   * *   You can call this operation up to 100 times per second per account. If the number of the calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
    * 
    * @param request - DescribeUrlModerationResultRequest
    * @returns DescribeUrlModerationResultResponse
@@ -4914,7 +5034,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 图片审核
+   * Identifies whether an image contains content or elements that violate relevant regulations on network content dissemination, affect the content order of a specific platform, or affect user experience. Image Moderation 2.0 supports over 90 content risk labels and over 100 risk control items. Image Moderation 2.0 of Content Moderation allows you to develop further moderation or governance measures for specific image content based on business scenarios, platform-specific content governance rules, or rich risk labels and scores of confidence levels returned by API calls.
+   * 
+   * @remarks
+   * *Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/467826.html)[](https://www.aliyun.com/price/product?#/lvwang/detail/cdibag) of Image Moderation 2.0.
    * 
    * @param request - ImageModerationRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -4949,7 +5072,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 图片审核
+   * Identifies whether an image contains content or elements that violate relevant regulations on network content dissemination, affect the content order of a specific platform, or affect user experience. Image Moderation 2.0 supports over 90 content risk labels and over 100 risk control items. Image Moderation 2.0 of Content Moderation allows you to develop further moderation or governance measures for specific image content based on business scenarios, platform-specific content governance rules, or rich risk labels and scores of confidence levels returned by API calls.
+   * 
+   * @remarks
+   * *Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/467826.html)[](https://www.aliyun.com/price/product?#/lvwang/detail/cdibag) of Image Moderation 2.0.
    * 
    * @param request - ImageModerationRequest
    * @returns ImageModerationResponse
@@ -5006,7 +5132,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 文本检测Plus版
+   * Moderates the input command and generated text of large language models (LLMs). Specific model input commands can be used to retrieve standard answers. The feature of enabling and disabling the moderation labels is also available.
+   * 
+   * @remarks
+   * Before you call this operation, make sure that you have [activated the Content Moderation 2.0 service](https://common-buy.aliyun.com/?commodityCode=lvwang_cip_public_cn) and are familiar with the [billing](https://help.aliyun.com/document_detail/2671445.html?#section-6od-32j-99n) of the Text Moderation 2.0 Plus service.
    * 
    * @param request - TextModerationPlusRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -5041,7 +5170,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 文本检测Plus版
+   * Moderates the input command and generated text of large language models (LLMs). Specific model input commands can be used to retrieve standard answers. The feature of enabling and disabling the moderation labels is also available.
+   * 
+   * @remarks
+   * Before you call this operation, make sure that you have [activated the Content Moderation 2.0 service](https://common-buy.aliyun.com/?commodityCode=lvwang_cip_public_cn) and are familiar with the [billing](https://help.aliyun.com/document_detail/2671445.html?#section-6od-32j-99n) of the Text Moderation 2.0 Plus service.
    * 
    * @param request - TextModerationPlusRequest
    * @returns TextModerationPlusResponse