All Products
Search

This Product

    ApsaraVideo VOD:GetAIMediaAuditJob

    Document Center

    ApsaraVideo VOD:GetAIMediaAuditJob

    Last Updated:Jul 19, 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

    There is currently no authorization information disclosed in the API.

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

    The results of text review.

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

    The results of audio review.

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

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

    object
    Labelstring

    The category of the review result. Valid values:

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

    The number of images.

    		0
    TopListarray<object>

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

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

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

    object
    Labelstring

    The category of the review result. Valid values:

    • porn
    • sexy
    • normal
    		porn
    Countinteger

    The number of images.

    		0
    TopListarray<object>

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

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

    The statistics about tag frames.

    object
    Labelstring

    The category of the review result. Valid values:

    • ad
    • normal
    		ad
    Countinteger

    The number of images.

    		10
    TopListarray<object>

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

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

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

    object
    Labelstring

    The category of the review result. Valid values:

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

    The number of images.

    		0
    TopListarray<object>

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

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

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

    object
    Labelstring

    The category of the review result. Valid values:

    • logo
    • normal
    		logo
    Countinteger

    The number of images.

    		2
    TopListarray<object>

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

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