All Products
Search
Document Center

ApsaraVideo VOD:GetAIMediaAuditJob

Last Updated:Mar 27, 2024

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.

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.
OperationAccess levelResource typeCondition keyAssociated operation
vod:GetAIMediaAuditJobRead
  • All Resources
    *
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
JobIdstringYes

The ID of the intelligent review job.

bdbc266af6894*****943a70176d92e9

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

EAA3E96A-02E2-41*****85-08E1D568ED3A
MediaAuditJobobject

The information about the intelligent review job.

CreationTimestring

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
Typestring

Only the job type is supported.

AIMediaAudit
Statusstring

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
CompleteTimestring

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
JobIdstring

The ID of the job.

bdbc266af6894*****943a70176d92e9
Codestring

The error code. This parameter is returned if the value of Status is fail.

0
Messagestring

The error message. This parameter is returned if the value of Status is fail.

OK
MediaIdstring

The ID of the video.

fe028d09441d*****d1afffb138cd7e
Dataobject

The job result data.

Suggestionstring

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
AbnormalModulesstring

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
Labelstring

The category of the review result. Separate multiple values with commas (,). Valid values:

  • porn
  • terrorism
  • ad
  • live: undesirable scenes
  • logo
  • audio: audio anti-spam
  • normal
normal
ImageResultobject []

The results of image review.

Typestring

The type of the image. Valid value: cover.

cover
Urlstring

The URL of the image.

http://www.test.com/****.jpg
Suggestionstring

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
Labelstring

The category of the review result. Separate multiple values with commas (,). Valid values:

  • porn
  • terrorism
  • ad
  • live: undesirable scenes
  • logo
  • audio: audio anti-spam
  • normal
normal
Resultobject []

Details of image review results.

Scorestring

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
Suggestionstring

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
Labelstring

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
  • ad
  • politics
  • porn
  • abuse
  • terrorism
  • contraband
  • spam
  • npx: illegal ad
  • qrcode: QR code
  • programCode

Valid values if scene is live:

  • normal
  • meaningless
  • PIP
  • smoking
  • drivelive

Valid values if scene is logo:

  • normal
  • TV
  • trademark
porn
Scenestring

The review scenario. Valid values:

  • porn
  • terrorism
  • ad
  • live: undesirable scenes
  • logo
porn
TextResultobject []

The results of text review.

Typestring

The type of the text. The value is title.

title
Suggestionstring

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
Scorestring

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
Labelstring

The category of the review result. Valid values:

  • spam
  • ad
  • abuse
  • flood: spam posts
  • contraband
  • meaningless
  • normal
ad
Contentstring

The text.

Test
Scenestring

The review scenario. Valid value: antispam.

antispam
AudioResultobject []

The results of audio review.

Scorestring

The score.

99.91
Suggestionstring

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
Labelstring

The category of the review result. Valid values:

  • normal
  • spam
  • ad
  • politics
  • terrorism
  • abuse
  • porn
  • flood: spam posts
  • contraband
  • meaningless
normal
Scenestring

The review scenario. Valid value: antispam.

antispam
VideoResultobject

The results of video review.

Labelstring

The category of the review result. Valid values:

  • ad
  • normal
normal
Suggestionstring

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
TerrorismResultobject

The results of terrorism content review.

Suggestionstring

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
AverageScorestring

The average score of the images 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
Labelstring

The category of the review result. Valid values:

  • normal
  • bloody
  • explosion
  • outfit
  • logo
  • weapon
  • politics
  • violence
  • crowd
  • parade
  • carcrash
  • flag
  • location
  • others
normal
MaxScorestring

The highest score of the image 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
CounterListobject []

The categories of the review results and the number of images.

Labelstring

The category of the review result. Valid values:

  • terrorism
  • outfit
  • logo
  • weapon
  • politics
  • others
  • normal
terrorism
Countinteger

The number of images.

0
TopListobject []

The information about the image with the highest score of the category that is indicated by Label.

Urlstring

The URL of the image.

http://ali*****.com/aivideocensor/yytysursrutyrxuq/****.jpg
Scorestring

The score of the image 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
Timestampstring

The position in the video. Unit: milliseconds.

5
Labelstring

The category of the review result. Valid values:

  • normal
  • bloody
  • explosion
  • outfit
  • logo
  • weapon
  • politics
  • violence
  • crowd
  • parade
  • carcrash
  • flag
  • location
  • others
normal
PornResultobject

The results of pornography content review.

Suggestionstring

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
AverageScorestring

The average score of the images 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
Labelstring

The category of the review result. Valid values:

  • porn
  • sexy
  • normal
porn
MaxScorestring

The highest score of the image 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
CounterListobject []

The categories of the review results and the number of images.

Labelstring

The category of the review result. Valid values:

  • porn
  • sexy
  • normal
porn
Countinteger

The number of images.

0
TopListobject []

The information about the image with the highest score of the category that is indicated by Label.

Urlstring

The URL of the image.

http://temp-****bucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg
Scorestring

The score of the image 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
Timestampstring

The position in the video. Unit: milliseconds.

3005
Labelstring

The category of the review result. Valid values:

  • porn
  • sexy
  • normal
porn
AdResultobject

The results of ad review.

Suggestionstring

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
AverageScorestring

The average score of the review results.

100
Labelstring

The category of the review result. Valid values:

  • ad
  • normal
ad
MaxScorestring

The highest review score.

100
CounterListobject []

The statistics about tag frames.

Labelstring

The category of the review result. Valid values:

  • ad
  • normal
ad
Countinteger

The number of images.

10
TopListobject []

The information about the image with the highest score of the category that is indicated by Label.

Urlstring

The URL of the image.

http://temp-****bucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg
Scorestring

The score of the image of the category that is indicated by Label.

100
Timestampstring

The position in the video. Unit: milliseconds.

500
Labelstring

The category of the review result. Valid values:

  • ad
  • normal
ad
LiveResultobject

The results of undesired content review.

Suggestionstring

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
AverageScorestring

The average score of the review results.

100
Labelstring

The category of the review result. Valid values:

  • live: The content contains undesirable scenes.
  • normal
live
MaxScorestring

The highest review score.

100
CounterListobject []

The categories of the review results and the number of images.

Labelstring

The category of the review result. Valid values:

  • live: The content contains undesirable scenes.
  • normal
live
Countinteger

The number of images.

0
TopListobject []

The information about the image with the highest score of the category that is indicated by Label.

Urlstring

The URL of the image.

http://temp-****bucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg
Scorestring

The score of the image of the category that is indicated by Label.

100
Timestampstring

The position in the video. Unit: milliseconds.

500
Labelstring

The category of the review result. Valid values:

  • live: The content contains undesirable scenes.
  • normal
live
LogoResultobject

The results of logo review.

Suggestionstring

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
AverageScorestring

The average score of the images of the category that is indicated by Label.

100
Labelstring

The category of the review result. Valid values:

  • logo
  • normal
logo
MaxScorestring

The highest score of the image of the category that is indicated by Label.

100
CounterListobject []

The categories of the review results and the number of images.

Labelstring

The category of the review result. Valid values:

  • logo
  • normal
logo
Countinteger

The number of images.

2
TopListobject []

The information about the image with the highest score of the category that is indicated by Label.

Urlstring

The URL of the image.

http://temp-****bucket.oss-cn-shanghai.aliyuncs.com/aivideocensor/****.jpg
Scorestring

The score of the image of the category that is indicated by Label.

100
Timestampstring

The position in the video. Unit: milliseconds.

5000
Labelstring

The category of the review result. Valid values:

  • logo
  • normal
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.