GetAIMediaAuditJob - ApsaraVideo VOD - Alibaba Cloud Documentation Center

Queries the information about an intelligent review job. After the job is submitted, it is processed asynchronously. You can call this operation to query the job information in real time.

Operation description

ApsaraVideo VOD stores the snapshots of the intelligent review results free of charge for two weeks. After this period, the snapshots are automatically deleted.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Associated operation
vod:GetAIMediaAuditJob	get	All Resources *	none	none

Request parameters

Parameter	Type	Required	Description	Example
JobId	string	Yes	The ID of the intelligent review job.	bdbc266af6894*****943a70176d92e9

Response parameters

Parameter	Type	Description	Example
	object	The response parameters.
RequestId	string	The ID of the request.	EAA3E96A-02E2-41*****85-08E1D568ED3A
MediaAuditJob	object	The information about the intelligent review job.
CreationTime	string	The time when the job started to run. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.	2017-01-11T12:00:00Z
Type	string	The type of the job. The value is AIMediaAudit.	AIMediaAudit
Status	string	The status of the job. Valid values: success: The job is successful. fail: The job failed. init: The job is being initialized. Processing: The job is in progress.	success
CompleteTime	string	The time when the job is complete. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.	2017-01-11T13:00:00Z
JobId	string	The ID of the job.	bdbc266af6894*****943a70176d92e9
Code	string	The error code. This parameter is returned if the value of Status is fail.	0
Message	string	The error message. This parameter is returned if the value of Status is fail.	OK
MediaId	string	The ID of the video.	fe028d09441d*****d1afffb138cd7e
Data	object	The job result.
Suggestion	string	The recommendation for review results. Valid values: block: The content violates the regulations. review: The content may violate the regulations. pass: The content passes the review.	pass
AbnormalModules	string	The content that violates the regulations. Separate multiple values with commas (,). Valid values: video: the video. image-cover: the cover. text-title: the title.	video
Label	string	The category of the review result. Multiple values are separated by commas (,). Valid values: porn: pornographic content terrorism: terrorist or politically sensitive content ad: ad violation live: undesirable scene logo: logo audio: audio anti-spam normal: normal content	normal
ImageResult	array<object>	The results of image review.
	object
Type	string	The type of the image. Valid value: cover.	cover
Url	string	The URL of the image.	http://www.test.com/****.jpg
Suggestion	string	The recommendation for review results. Valid values: block review pass	pass
Label	string	The categories of the image review results. Multiple values are separated by commas (,). Valid values: porn: pornographic content terrorism: terrorist or politically sensitive content ad: ad violation live: undesirable scene logo: logo normal: normal content	normal
Result	array<object>	Details of image review results.
	object
Score	string	The score of the image of the category that is indicated by Label. Valid values: `[0, 100]`. The score is representative of the confidence.	0
Suggestion	string	The recommendation for review results. Valid values: block review pass	pass
Label	string	The category of the review result. Valid values if scene is porn: porn sexy normal Valid values if scene is terrorism: normal bloody explosion outfit logo weapon politics violence crowd parade carcrash flag location others Valid values if scene is ad: normal: normal content ad: ads politics: political content porn: pornographic content abuse: verbal abuse terrorism: terrorist content contraband: prohibited content spam: spam content npx: illegal ad qrcode: QR code programCode: mini program code Valid values if scene is live: normal: normal content meaningless: meaningless content, such as a black or white screen. PIP: picture-in-picture smoking: smoking drivelive: live broadcasting in a running vehicle Valid values if scene is logo: normal: normal content TV: controlled TV station logo trademark: trademark	porn
Scene	string	The review scenario. Valid values: porn: pornographic content terrorism: terrorist or politically sensitive content ad: ad violation live: undesirable scene logo: logo	porn
TextResult	array<object>	The text moderation results.
	object
Type	string	The type of the text. The value is title.	title
Suggestion	string	The recommendation for review results. Valid values: block review pass	pass
Score	string	The score of the image of the category that is indicated by Label. Valid values: `[0, 100]`. The score is representative of the confidence.	100
Label	string	The category of the review result. Valid values: spam: spam content ad: ads abuse: abuse flood: excessive junk content contraband: prohibited content meaningless: meaningless content normal: normal content	ad
Content	string	The text content.	Test
Scene	string	The review scenario. The value is antispam.	antispam
AudioResult	array<object>	The results of audio review.
	object
Score	string	The score.	99.91
Suggestion	string	The recommendation for review results. Valid values: block review pass	pass
Label	string	The category of the review result. normal: normal content spam: spam ad: ads politics: political content terrorism: terrorist content abuse: abuse porn: pornographic content. flood: excessive junk content contraband: prohibited content meaningless: meaningless content	normal
Scene	string	The review scenario. The value is antispam.	antispam
VideoResult	object	The results of video review.
Label	string	The category of the review result. Valid values: porn: pornographic content terrorism: terrorist or politically sensitive content ad: ad violation live: undesirable scene logo: logo normal	normal
Suggestion	string	The recommendation for video review results. Valid values: block review pass	pass
TerrorismResult	object	The results of terrorist content review.
Suggestion	string	The recommendation for terrorist content review results. Valid values: block review pass	pass
AverageScore	string	The average score of the snapshots of the category that is indicated by Label. Valid values: `[0, 100]`. The value is accurate to 10 decimal places. The score is representative of the confidence.	100
Label	string	The category of the review result. Valid values: normal bloody explosion outfit logo weapon politics violence crowd parade carcrash flag location others	normal
MaxScore	string	The highest score of the snapshot of the category that is indicated by Label. Valid values: `[0, 100]`. The value is accurate to 10 decimal places. The score is representative of the confidence.	100
CounterList	array<object>	The categories of terrorist content review results and the number of video snapshots in each category.
	object
Label	string	The results of terrorist content review. Valid values: normal bloody explosion outfit logo weapon politics violence crowd parade carcrash flag location others	terrorism
Count	integer	The number of video snapshots.	0
TopList	array<object>	The information about the snapshot that has the highest score in the category.
	object
Url	string	The URL of the video snapshot.	http://ali***.com/aivideocensor/yytysursrutyrxuq/**.jpg
Score	string	The score of the snapshot in the category that is indicated by Label. Valid values: `[0, 100]`. The value is accurate to 10 decimal places. The score is representative of the confidence.	100
Timestamp	string	The timestamp of the snapshot in the video. Unit: milliseconds.	5
Label	string	The results of terrorist content review. Valid values: normal bloody explosion outfit logo weapon politics violence crowd parade carcrash flag location others	normal
PornResult	object	The results of pornographic content review.
Suggestion	string	The recommendation for review results. Valid values: block: The content violates the regulations. review: The content may violate the regulations. pass: The content passes the review.	pass
AverageScore	string	The average score of the snapshots of the category that is indicated by Label. Valid values: `[0, 100]`. The value is accurate to 10 decimal places. The score is representative of the confidence.	100
Label	string	The category of the review result. Valid values: porn sexy normal	porn
MaxScore	string	The highest score of the snapshot of the category that is indicated by Label. Valid values: `[0, 100]`. The value is accurate to 10 decimal places. The score is representative of the confidence.	100
CounterList	array<object>	The number of snapshots of each category in the review result.
	object
Label	string	The results of pornographic content review. Valid values: porn sexy normal	porn
Count	integer	The number of video snapshots.	0
TopList	array<object>	The information about the snapshot that has the highest score in the category.
	object
Url	string	The URL of the video snapshot.	http://temp-**bucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/**.jpg
Score	string	The score of the snapshot in the category that is indicated by Label. Valid values: `[0, 100]`. The value is accurate to 10 decimal places. The score is representative of the confidence.	100
Timestamp	string	The timestamp of the snapshot in the video. Unit: milliseconds.	3005
Label	string	The results of pornographic content review. Valid values: porn sexy normal	porn
AdResult	object	The results of ad review.
Suggestion	string	The recommendation for review results. Valid values: block: The content violates the regulations. review: The content may violate the regulations. pass: The content passes the review.	block
AverageScore	string	The average score of the review results.	100
Label	string	The categories of the ad review results. Valid values: normal: normal content ad: other ads politics: political content porn: pornographic content abuse: abuse terrorism: terrorist content contraband: prohibited content spam: spam content npx: illegal ad qrcode: QR code programCode: mini program code	ad
MaxScore	string	The highest review score.	100
CounterList	array<object>	The number of snapshots of each category in the review result.
	object
Label	string	The categories of the ad review results. Valid values: normal: normal content ad: other ads politics: political content porn: pornographic content abuse: abuse terrorism: terrorist content contraband: prohibited content spam: spam content npx: illegal ad qrcode: QR code programCode: mini program code	ad
Count	integer	The number of video snapshots.	10
TopList	array<object>	The information about the snapshot that has the highest score in the category.
	object
Url	string	The URL of the video snapshot.	http://temp-**bucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/**.jpg
Score	string	The score of the snapshot in the category that is indicated by Label.	100
Timestamp	string	The timestamp of the snapshot in the video. Unit: milliseconds.	500
Label	string	The categories of the ad review results. Valid values: normal: normal content ad: other ads politics: political content porn: pornographic content abuse: abuse terrorism: terrorist content contraband: prohibited content spam: spam content npx: illegal ad qrcode: QR code programCode: mini program code	ad
LiveResult	object	The results of undesired content review.
Suggestion	string	The recommendation for review results. Valid values: block: The content violates the regulations. review: The content may violate the regulations. pass: The content passes the review.	block
AverageScore	string	The average score of the review results.	100
Label	string	The category of the review result. Valid values: normal: normal content meaningless: meaningless content, such as a black or white screen. PIP: picture-in-picture smoking: smoking drivelive: live broadcasting in a running vehicle	live
MaxScore	string	The highest review score.	100
CounterList	array<object>	The categories of the review results and the number of video snapshots in each category.
	object
Label	string	The category of the review result. Valid values: normal: normal content meaningless: meaningless content, such as a black or white screen. PIP: picture-in-picture smoking: smoking drivelive: live broadcasting in a running vehicle	live
Count	integer	The number of video snapshots.	0
TopList	array<object>	The information about the snapshot that has the highest score in the category.
	object
Url	string	The URL of the video snapshot.	http://temp-**bucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/**.jpg
Score	string	The score of the snapshot in the category that is indicated by Label.	100
Timestamp	string	The timestamp of the snapshot in the video. Unit: milliseconds.	500
Label	string	The category of the review result. Valid values: normal: normal content meaningless: meaningless content, such as a black or white screen. PIP: picture-in-picture smoking: smoking drivelive: live broadcasting in a running vehicle	live
LogoResult	object	The results of logo review.
Suggestion	string	The recommendation for review results. Valid values: block: The content violates the regulations. review: The content may violate the regulations. pass: The content passes the review.	block
AverageScore	string	The average score of the snapshots in the category indicated by Label.	100
Label	string	The category of the review result. Valid values: normal: normal content TV: controlled TV station logo trademark: trademark	logo
MaxScore	string	The highest score of the snapshot of the category that is indicated by Label.	100
CounterList	array<object>	The categories of the review results and the number of video snapshots in each category.
	object
Label	string	The category of the review result. Valid values: normal: normal content TV: controlled TV station logo trademark: trademark	logo
Count	integer	The number of video snapshots.	2
TopList	array<object>	The information about the snapshot that has the highest score in the category.
	object
Url	string	The URL of the video snapshot.	http://temp-**bucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/**.jpg
Score	string	The score of the snapshot in the category that is indicated by Label.	100
Timestamp	string	The timestamp of the snapshot in the video. Unit: milliseconds.	5000
Label	string	The category of the review result. Valid values: normal: normal content TV: controlled TV station logo trademark: trademark	logo

Examples

Sample success responses

JSONformat

{
  "RequestId": "EAA3E96A-02E2-41*****85-08E1D568ED3A",
  "MediaAuditJob": {
    "CreationTime": "2017-01-11T12:00:00Z",
    "Type": "AIMediaAudit",
    "Status": "success",
    "CompleteTime": "2017-01-11T13:00:00Z",
    "JobId": "bdbc266af6894*****943a70176d92e9",
    "Code": "0",
    "Message": "OK",
    "MediaId": "fe028d09441d*****d1afffb138cd7e",
    "Data": {
      "Suggestion": "pass",
      "AbnormalModules": "video",
      "Label": "normal",
      "ImageResult": [
        {
          "Type": "cover",
          "Url": "http://www.test.com/****.jpg",
          "Suggestion": "pass",
          "Label": "normal",
          "Result": [
            {
              "Score": "0",
              "Suggestion": "pass",
              "Label": "porn",
              "Scene": "porn"
            }
          ]
        }
      ],
      "TextResult": [
        {
          "Type": "title",
          "Suggestion": "pass",
          "Score": "100",
          "Label": "ad",
          "Content": "Test\n",
          "Scene": "antispam"
        }
      ],
      "AudioResult": [
        {
          "Score": "99.91",
          "Suggestion": "pass",
          "Label": "normal",
          "Scene": "antispam"
        }
      ],
      "VideoResult": {
        "Label": "normal",
        "Suggestion": "pass",
        "TerrorismResult": {
          "Suggestion": "pass",
          "AverageScore": "100",
          "Label": "normal",
          "MaxScore": "100",
          "CounterList": [
            {
              "Label": "terrorism",
              "Count": 0
            }
          ],
          "TopList": [
            {
              "Url": "http://ali*****.com/aivideocensor/yytysursrutyrxuq/****.jpg",
              "Score": "100",
              "Timestamp": "5",
              "Label": "normal"
            }
          ]
        },
        "PornResult": {
          "Suggestion": "pass",
          "AverageScore": "100",
          "Label": "porn",
          "MaxScore": "100",
          "CounterList": [
            {
              "Label": "porn",
              "Count": 0
            }
          ],
          "TopList": [
            {
              "Url": "http://temp-****bucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg",
              "Score": "100",
              "Timestamp": "3005",
              "Label": "porn"
            }
          ]
        },
        "AdResult": {
          "Suggestion": "block",
          "AverageScore": "100",
          "Label": "ad",
          "MaxScore": "100",
          "CounterList": [
            {
              "Label": "ad",
              "Count": 10
            }
          ],
          "TopList": [
            {
              "Url": "http://temp-****bucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg",
              "Score": "100",
              "Timestamp": "500",
              "Label": "ad"
            }
          ]
        },
        "LiveResult": {
          "Suggestion": "block",
          "AverageScore": "100",
          "Label": "live",
          "MaxScore": "100",
          "CounterList": [
            {
              "Label": "live",
              "Count": 0
            }
          ],
          "TopList": [
            {
              "Url": "http://temp-****bucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg",
              "Score": "100",
              "Timestamp": "500",
              "Label": "live"
            }
          ]
        },
        "LogoResult": {
          "Suggestion": "block",
          "AverageScore": "100",
          "Label": "logo",
          "MaxScore": "100",
          "CounterList": [
            {
              "Label": "logo",
              "Count": 2
            }
          ],
          "TopList": [
            {
              "Url": "http://temp-****bucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg",
              "Score": "100",
              "Timestamp": "5000",
              "Label": "logo"
            }
          ]
        }
      }
    }
  }
}

Error codes

For a list of error codes, visit the Service error codes.