All Products
Search
Document Center

ApsaraVideo VOD:SubmitDigitalWatermarkExtractJob

Last Updated:Jul 19, 2024

Submits a digital watermark extraction job. You can call this operation to asynchronously extract a copyright watermark or user-tracing watermark.

Operation description

  • Make sure that you understand the billing methods and price of ApsaraVideo VOD before you call this operation. You are charged for generating and extracting digital watermarks. For more information, see Billing .

  • This operation is supported only in the China (Shanghai) and China (Beijing) regions.

  • Before you submit a digital watermark extraction job, make sure that the following conditions are met:

    • The video from which you want to extract the watermark is uploaded to the ApsaraVideo VOD.
    • The video from which you want to extract the watermark is longer than 6 minutes.

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
MediaIdstringYes

The ID of the video from which you want to extract the watermark. You can specify only one ID. You can use one of the following methods to obtain the ID:

  • Log on to the ApsaraVideo VOD console. In the left-side navigation pane, choose Media Files > Audio/Video to view the video ID.
  • Obtain the VideoId from the response to the SearchMedia operation.
0222e203cf80f9c22870a4d2c****
ExtractTypestringYes

The type of the watermark that you want to extract. Valid values:

  • TraceMark: user-tracing watermark
  • CopyrightMark: copyright watermark
TraceMark

Response parameters

ParameterTypeDescriptionExample
object
JobIdstring

The ID of the watermark extraction job.

ad90a501b1b9472374ad005046****
RequestIdstring

The ID of the request.

04F0F334-1335-436C-****-6C044FE73368

Examples

Sample success responses

JSONformat

{
  "JobId": "ad90a501b1b9472374ad005046****",
  "RequestId": "04F0F334-1335-436C-****-6C044FE73368"
}

Error codes

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