ApsaraVideo VOD:GetAIMediaAuditJob - ApsaraVideo VOD - Alibaba Cloud - ApsaraVideo VOD

Queries an automated review job. After you submit an AI job, the job is processed asynchronously. You can call this operation to query job information in real time.

Operation description

This operation is supported only in the Singapore region.
Image resources in automated review job results are retained in the free storage provided by ApsaraVideo VOD for only two weeks. After two weeks, the images are automatically deleted.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

vod:GetAIMediaAuditJob

get

*All Resource

*

None

Request parameters

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

Response elements

Element	Type	Description	Example
	object	The response data.
RequestId	string	The request ID.	EAA3E96A-02E2-41*****85-08E1D568ED3A
MediaAuditJob	object	The automated review job information.
CreationTime	string	The time when the job started. The time is in the yyyy-MM-ddTHH:mm:ssZ format (UTC).	2017-01-11T12:00:00Z
Type	string	The job type. Only "automated review" is supported.	AIMediaAudit
Status	string	The job status. 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 ended. The time is in the yyyy-MM-ddTHH:mm:ssZ format (UTC).	2017-01-11T13:00:00Z
JobId	string	The job ID.	bdbc266af6894*****943a70176d92e9
Code	string	The error code of the job. This field is relevant when Status is fail.	0
Message	string	The error message of the job. This field is relevant when Status is fail.	OK
MediaId	string	The video ID.	fe028d09441d*****d1afffb138cd7e
Data	object	The job result data.
Suggestion	string	The review result suggestion. Valid values: block: Violation. review: Suspected violation. pass: Passed.	pass
AbnormalModules	string	The content that violates the moderation rules. Multiple values are separated by commas (,). Valid values: video: video. image-cover: thumbnail. text-title: title.	video
Label	string	The category of the review result. Multiple values are separated by commas (,). Valid values: porn: pornography. terrorism: terrorist content and political sensitivity. ad: image and text violations. live: undesirable scenes. logo: logo in images. audio: audio anti-spam. normal: normal.	normal
ImageResult	array<object>	The image review results.
	array<object>	The image review result data.
Type	string	The image category. Valid values: cover (thumbnail).	cover
Url	string	The URL of the image.	http://www.test.com/****.jpg
Suggestion	string	The review result suggestion. Valid values: block: Violation. review: Suspected violation. pass: Passed.	pass
Label	string	The category of the image review result. Multiple values are separated by commas (,). Valid values: porn: pornography. terrorism: terrorist content and political sensitivity. ad: image and text violations. live: undesirable scenes. logo: logo in images. normal: normal.	normal
Result	array<object>	The details of the image review result.
	object
Score	string	The score of the image that hits the label. Value range: `[0, 100]`. The score indicates the probability of the corresponding label. A higher value indicates higher accuracy.	0
Suggestion	string	The review result suggestion. Valid values: block: Violation. review: Suspected violation. pass: Passed.	pass
Label	string	The category of the review result. When scene is porn, valid values: porn: pornographic content. sexy: sexy content. normal: normal. When scene is terrorism, valid values: normal: normal. bloody: bloody content. explosion: explosions and smoke. outfit: special outfits. logo: special logos. weapon: weapons. politics: politically sensitive content. violence: fighting. crowd: crowds. parade: parades. carcrash: car accident scenes. flag: flags. location: landmarks. others: others. When scene is ad, valid values: normal: normal. ad: other advertisements. politics: text containing politically sensitive content. porn: text containing pornographic content. abuse: text containing abusive content. terrorism: text containing terrorist content. contraband: text containing prohibited content. spam: text containing other spam content. npx: psoriasis advertisements. qrcode: contains QR codes. programCode: contains mini program codes. When scene is live, valid values: normal: normal. meaningless: no content in the image (such as a black or white screen). PIP: Picture-in-Picture (PiP). smoking: smoking. drivelive: in-car live streaming. When scene is logo, valid values: normal: normal. TV: contains regulated logos. trademark: contains trademarks.	porn
Scene	string	The review scene. Valid values: porn: pornography detection. terrorism: terrorist content and political sensitivity. ad: image and text violations. live: undesirable scenes. logo: logo in images.	porn
TextResult	array<object>	The text review results.
	object
Type	string	The text categorization. Valid values: title (title).	title
Suggestion	string	The review result suggestion. Valid values: block: Violation. review: Suspected violation. pass: Passed.	pass
Score	string	The score of the image that hits the label. Value range: `[0, 100]`. The score indicates the probability of the corresponding label. A higher value indicates higher accuracy.	100
Label	string	The category of the review result. Valid values: spam: spam. ad: advertisement. abuse: abuse. flood: flooding. contraband: prohibited content. meaningless: meaningless content. normal: normal.	ad
Content	string	The text content.	Test
Scene	string	The review scene. Fixed value: antispam.	antispam
AudioResult	array<object>	The audio review results.
	object
Score	string	The result score.	99.91
Suggestion	string	The review result suggestion. Valid values: block: Violation. review: Suspected violation. pass: Passed.	pass
Label	string	The category of the review result: normal: normal. spam: spam. ad: advertisement. politics: politically sensitive content. terrorism: terrorist content. abuse: abuse. porn: pornographic content. flood: flooding. contraband: prohibited content. meaningless: meaningless content.	normal
Scene	string	The review scene. Fixed value: antispam.	antispam
VideoResult	object	The video review results.
Label	string	The category of the review result. Valid values: porn: pornography. terrorism: terrorist content and political sensitivity. ad: image and text violations. live: undesirable scenes. logo: logo in images. normal: normal.	normal
Suggestion	string	The video review result suggestion. Valid values: block: Violation. review: Suspected violation. pass: Passed.	pass
TerrorismResult	object	The terrorism and political sensitivity review result.
Suggestion	string	The terrorism and political sensitivity review suggestion. Valid values: block: Violation. review: Suspected violation. pass: Passed.	pass
AverageScore	string	The average score of video snapshots that hit the label. Value range: `[0, 100]`, with a precision of 10 decimal places. The score indicates the probability of the corresponding label. A higher value indicates higher accuracy.	100
Label	string	The terrorism and political sensitivity review result. Valid values: normal: normal. bloody: bloody content. explosion: explosions and smoke. outfit: special outfits. logo: special logos. weapon: weapons. politics: politically sensitive content. violence: fighting. crowd: crowds. parade: parades. carcrash: car accident scenes. flag: flags. location: landmarks. others: others.	normal
MaxScore	string	The highest score of video snapshots that hit the label. Value range: `[0, 100]`, with a precision of 10 decimal places. The score indicates the probability of the corresponding label. A higher value indicates higher accuracy.	100
CounterList	array<object>	The terrorism and political sensitivity result categories and the number of video snapshots for each category.
	object
Label	string	The terrorism and political sensitivity review result. Valid values: normal: normal. bloody: bloody content. explosion: explosions and smoke. outfit: special outfits. logo: special logos. weapon: weapons. politics: politically sensitive content. violence: fighting. crowd: crowds. parade: parades. carcrash: car accident scenes. flag: flags. location: landmarks. others: others.	terrorism
Count	integer	The number of video snapshots.	0
TopList	array<object>	The information about the video snapshots with the highest scores that hit the label.
	object
Url	string	The URL of the video snapshot.	http://ali***.com/aivideocensor/yytysursrutyrxuq/**.jpg
Score	string	The score of the video snapshot that hits the label. Value range: `[0, 100]`, with a precision of 10 decimal places. The score indicates the probability of the corresponding label. A higher value indicates higher accuracy.	100
Timestamp	string	The position of the video snapshot in the video. Unit: milliseconds.	5
Label	string	The terrorism and political sensitivity review result. Valid values: normal: normal. bloody: bloody content. explosion: explosions and smoke. outfit: special outfits. logo: special logos. weapon: weapons. politics: politically sensitive content. violence: fighting. crowd: crowds. parade: parades. carcrash: car accident scenes. flag: flags. location: landmarks. others: others.	normal
PornResult	object	The pornography detection result.
Suggestion	string	The pornography detection suggestion. Valid values: block: Violation. review: Suspected violation. pass: Passed.	pass
AverageScore	string	The average score of video snapshots that hit the label. Value range: `[0, 100]`, with a precision of 10 decimal places. The score indicates the probability of the corresponding label. A higher value indicates higher accuracy.	100
Label	string	The pornography detection result. Valid values: porn: pornographic content. sexy: sexy content. normal: normal.	porn
MaxScore	string	The highest score of video snapshots that hit the label. Value range: `[0, 100]`, with a precision of 10 decimal places. The score indicates the probability of the corresponding label. A higher value indicates higher accuracy.	100
CounterList	array<object>	The review result categories and the number of video snapshots for each category.
	object
Label	string	The pornography detection result. Valid values: porn: pornographic content. sexy: sexy content. normal: normal.	porn
Count	integer	The number of video snapshots.	0
TopList	array<object>	The information about the video snapshots with the highest scores that hit the label.
	object
Url	string	The URL of the video snapshot.	http://temp-testbucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg
Score	string	The score of the video snapshot that hits the label. Value range: `[0, 100]`, with a precision of 10 decimal places. The score indicates the probability of the corresponding label. A higher value indicates higher accuracy.	100
Timestamp	string	The position of the video snapshot in the video. Unit: milliseconds.	3005
Label	string	The pornography detection result. Valid values: porn: pornographic content. sexy: sexy content. normal: normal.	porn
AdResult	object	The advertisement review result.
Suggestion	string	The review result suggestion. Valid values: block: Violation. review: Suspected violation. pass: Passed.	block
AverageScore	string	The average score of the advertisement review result.	100
Label	string	The category of the advertisement review result. Valid values: normal: normal. ad: other advertisements. politics: text containing politically sensitive content. porn: text containing pornographic content. abuse: text containing abusive content. terrorism: text containing terrorist content. contraband: text containing prohibited content. spam: text containing other spam content. npx: psoriasis advertisements. qrcode: contains QR codes. programCode: contains mini program codes.	ad
MaxScore	string	The highest review score.	100
CounterList	array<object>	The review result categories and the number of video snapshots for each category.
	object
Label	string	The category of the advertisement review result. Valid values: normal: normal. ad: other advertisements. politics: text containing politically sensitive content. porn: text containing pornographic content. abuse: text containing abusive content. terrorism: text containing terrorist content. contraband: text containing prohibited content. spam: text containing other spam content. npx: psoriasis advertisements. qrcode: contains QR codes. programCode: contains mini program codes.	ad
Count	integer	The number of video snapshots.	10
TopList	array<object>	The information about the video snapshots with the highest scores that hit the label.
	object
Url	string	The URL of the video snapshot.	http://temp-testbucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg
Score	string	The score of the video snapshot that hits the label.	100
Timestamp	string	The position of the video snapshot in the video. Unit: milliseconds.	500
Label	string	The category of the advertisement review result. Valid values: normal: normal. ad: other advertisements. politics: text containing politically sensitive content. porn: text containing pornographic content. abuse: text containing abusive content. terrorism: text containing terrorist content. contraband: text containing prohibited content. spam: text containing other spam content. npx: psoriasis advertisements. qrcode: contains QR codes. programCode: contains mini program codes.	ad
LiveResult	object	The review results for inappropriate content.
Suggestion	string	The review result suggestion. Valid values: block: Violation. review: Suspected violation. pass: Passed.	block
AverageScore	string	The average score of the review result.	100
Label	string	The category of the review result. Valid values: normal: Normal. meaningless: No content in the image (for example, black screen or white screen). PIP: Picture-in-Picture (PiP). smoking: Smoking. drivelive: In-car live streaming.	smoking
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. meaningless: No content in the image (for example, black screen or white screen). PIP: Picture-in-Picture (PiP). smoking: Smoking. drivelive: In-car live streaming.	smoking
Count	integer	The number of video snapshots.	4
TopList	array<object>	The information about the video snapshots with the highest scores that hit the label.
	object
Url	string	The URL of the video snapshot.	http://temp-testbucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg
Score	string	The score of the video snapshot that hits the label.	100
Timestamp	string	The position of the video snapshot in the video. Unit: milliseconds.	500
Label	string	The category of the review result. Valid values: normal: Normal. meaningless: No content in the image (for example, black screen or white screen). PIP: Picture-in-Picture (PiP). smoking: Smoking. drivelive: In-car live streaming.	smoking
LogoResult	object	The logo review result.
Suggestion	string	The logo review suggestion. Valid values: block: Violation. review: Suspected violation. pass: Passed.	block
AverageScore	string	The average score of video snapshots that hit the label.	100
Label	string	The category of the logo review result. Valid values: normal: Normal. TV: Contains a regulated logo. trademark: Contains a trademark.	TV
MaxScore	string	The highest score of video snapshots that hit the 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 logo review result. Valid values: normal: Normal. TV: Contains a regulated logo. trademark: Contains a trademark.	TV
Count	integer	The number of video snapshots.	2
TopList	array<object>	The information about the video snapshots with the highest scores that hit the label.
	object
Url	string	The URL of the video snapshot.	http://temp-testbucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg
Score	string	The score of the video snapshot that hits the label.	100
Timestamp	string	The position of the video snapshot in the video. Unit: milliseconds.	5000
Label	string	The category of the logo review result. Valid values: normal: Normal. TV: Contains a regulated logo. trademark: Contains a trademark.	TV
GreenEnhancedResult	object	The GreenEnhanced review result.
Suggestion	string	The frame review conclusion mapped from frameResult.riskLevel: high→block, medium/low→review, none→pass.
Label	string	The union of hit Green native labels (comma-separated, such as pornographic_adultContent_tii). The value is normal if no label is hit.
MaxScore	string	The highest confidence score of hit frames. This field is not returned if no frame is hit.
AverageScore	string	The average confidence score of hit frames. This field is not returned if no frame is hit.
CounterList	array<object>	The violation label count aggregation: Label (Green label) / Count (number of hit frames for the label).
	object
Label	string	The review result category.
Count	integer	The number of captured video frames for the corresponding label.
TopList	array<object>	The hit frame details (sorted by confidence in descending order).
	object
Label	string	The review result category.
Score	string	The confidence score of the video snapshot that hit the label.
Timestamp	string	The position of the video snapshot in the video.
Url	string	The URL of the video snapshot.

Examples

Success response

JSON format

{
  "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",
          "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-testbucket.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-testbucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg",
              "Score": "100",
              "Timestamp": "500",
              "Label": "ad"
            }
          ]
        },
        "LiveResult": {
          "Suggestion": "block",
          "AverageScore": "100",
          "Label": "smoking",
          "MaxScore": "100",
          "CounterList": [
            {
              "Label": "smoking",
              "Count": 4
            }
          ],
          "TopList": [
            {
              "Url": "http://temp-testbucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg",
              "Score": "100",
              "Timestamp": "500",
              "Label": "smoking"
            }
          ]
        },
        "LogoResult": {
          "Suggestion": "block",
          "AverageScore": "100",
          "Label": "TV",
          "MaxScore": "100",
          "CounterList": [
            {
              "Label": "TV",
              "Count": 2
            }
          ],
          "TopList": [
            {
              "Url": "http://temp-testbucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg",
              "Score": "100",
              "Timestamp": "5000",
              "Label": "TV"
            }
          ]
        },
        "GreenEnhancedResult": {
          "Suggestion": "",
          "Label": "",
          "MaxScore": "",
          "AverageScore": "",
          "CounterList": [
            {
              "Label": "",
              "Count": 0
            }
          ],
          "TopList": [
            {
              "Label": "",
              "Score": "",
              "Timestamp": "",
              "Url": ""
            }
          ]
        }
      }
    }
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.