All Products
Search
Document Center

ApsaraVideo VOD:GetAIMediaAuditJob

最終更新日:Jul 29, 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:GetAIMediaAuditJobget
  • All Resources
    *
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
JobIdstringYes

The ID of the intelligent review job.

bdbc266af6894*****943a70176d92e9

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

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

The type of the job. The value is AIMediaAudit.

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.

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. 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
ImageResultarray<object>

The results of image review.

object
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
  • review
  • pass
pass
Labelstring

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
Resultarray<object>

Details of image review results.

object
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
  • review
  • pass
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: 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
Scenestring

The review scenario. Valid values:

  • porn: pornographic content
  • terrorism: terrorist or politically sensitive content
  • ad: ad violation
  • live: undesirable scene
  • logo: logo
porn
TextResultarray<object>

The text moderation results.

object
Typestring

The type of the text. The value is title.

title
Suggestionstring

The recommendation for review results. Valid values:

  • block
  • review
  • pass
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: spam content
  • ad: ads
  • abuse: abuse
  • flood: excessive junk content
  • contraband: prohibited content
  • meaningless: meaningless content
  • normal: normal content
ad
Contentstring

The text content.

Test
Scenestring

The review scenario. The value is antispam.

antispam
AudioResultarray<object>

The results of audio review.

object
Scorestring

The score.

99.91
Suggestionstring

The recommendation for review results. Valid values:

  • block
  • review
  • pass
pass
Labelstring

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
Scenestring

The review scenario. The value is antispam.

antispam
VideoResultobject

The results of video review.

Labelstring

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
Suggestionstring

The recommendation for video review results. Valid values:

  • block
  • review
  • pass
pass
TerrorismResultobject

The results of terrorist content review.

Suggestionstring

The recommendation for terrorist content review results. Valid values:

  • block
  • review
  • pass
pass
AverageScorestring

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
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 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
CounterListarray<object>

The categories of terrorist content review results and the number of video snapshots in each category.

object
Labelstring

The results of terrorist content review. Valid values:

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

The number of video snapshots.

0
TopListarray<object>

The information about the snapshot that has the highest score in the category.

object
Urlstring

The URL of the video snapshot.

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

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
Timestampstring

The timestamp of the snapshot in the video. Unit: milliseconds.

5
Labelstring

The results of terrorist content review. Valid values:

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

The results of pornographic 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 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
Labelstring

The category of the review result. Valid values:

  • porn
  • sexy
  • normal
porn
MaxScorestring

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
CounterListarray<object>

The number of snapshots of each category in the review result.

object
Labelstring

The results of pornographic content review. Valid values:

  • porn
  • sexy
  • normal
porn
Countinteger

The number of video snapshots.

0
TopListarray<object>

The information about the snapshot that has the highest score in the category.

object
Urlstring

The URL of the video snapshot.

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

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
Timestampstring

The timestamp of the snapshot in the video. Unit: milliseconds.

3005
Labelstring

The results of pornographic content review. 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 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
MaxScorestring

The highest review score.

100
CounterListarray<object>

The number of snapshots of each category in the review result.

object
Labelstring

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
Countinteger

The number of video snapshots.

10
TopListarray<object>

The information about the snapshot that has the highest score in the category.

object
Urlstring

The URL of the video snapshot.

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

The score of the snapshot in the category that is indicated by Label.

100
Timestampstring

The timestamp of the snapshot in the video. Unit: milliseconds.

500
Labelstring

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
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:

  • 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
MaxScorestring

The highest review score.

100
CounterListarray<object>

The categories of the review results and the number of video snapshots in each category.

object
Labelstring

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
Countinteger

The number of video snapshots.

0
TopListarray<object>

The information about the snapshot that has the highest score in the category.

object
Urlstring

The URL of the video snapshot.

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

The score of the snapshot in the category that is indicated by Label.

100
Timestampstring

The timestamp of the snapshot in the video. Unit: milliseconds.

500
Labelstring

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
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 snapshots in the category indicated by Label.

100
Labelstring

The category of the review result. Valid values:

  • normal: normal content
  • TV: controlled TV station logo
  • trademark: trademark
logo
MaxScorestring

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

100
CounterListarray<object>

The categories of the review results and the number of video snapshots in each category.

object
Labelstring

The category of the review result. Valid values:

  • normal: normal content
  • TV: controlled TV station logo
  • trademark: trademark
logo
Countinteger

The number of video snapshots.

2
TopListarray<object>

The information about the snapshot that has the highest score in the category.

object
Urlstring

The URL of the video snapshot.

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

The score of the snapshot in the category that is indicated by Label.

100
Timestampstring

The timestamp of the snapshot in the video. Unit: milliseconds.

5000
Labelstring

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.