DocsICP FilingConsole
官方文档
首页

Video DNA

更新时间：
复制 MD 格式
产品详情
我的收藏

A media fingerprint is a binary string that uniquely identifies a video. The media fingerprinting service extracts and compares image and audio fingerprint features to find duplicate videos and trace video clip sources. Use cases include originality detection, video deduplication, rapid content review, ad revenue sharing, and video source tracking.

Overview

Use cases

  • Originality detection: Identifies original videos, edited versions, and remixed content. Protects copyrights in the short-video industry and prevents infringing content from harming original creators and platforms.

  • Video deduplication: Build a media fingerprint library to compare sample videos and identify duplicates in real time. Prevents excessive identical or similar videos from degrading the content distribution experience.

  • Rapid content review: Maintain a library of non-compliant videos or a custom blacklist and compare new videos against it to detect prohibited content. Significantly improves review efficiency and accuracy while reducing costs.

  • Ad revenue sharing: Search a revenue-sharing ad library to monitor and identify specific ads. Controls ad delivery times and frequencies while protecting both copyright holders and ad platforms.

    Note

    MPS can only identify ads already stored in a media fingerprint library. Upload ad material to the library before submitting identification jobs.

Features

  • Feature list: Media fingerprinting

  • Key features:

    • Uniqueness: Different videos have different media fingerprints.

    • Robustness: A media fingerprint is unaffected by transformations such as format conversion, editing, splicing, compression, or rotation.

  • Online demo: Online demo

Limitations

  • Available in the China (Beijing), China (Hangzhou), China (Shanghai), and Asia Pacific SE 1 (Singapore) regions.

  • Concurrency limits are documented in mps queue limits.

Prerequisites

Ensure the following are in place before you begin.

  • Create an mps queue for media fingerprinting if none exists in your queue list.

  • Call the CreateFpShotDB API operation to create a media fingerprint library.

  • Upload the video to be processed to OSS.

    • If you want to create a job, directly upload the video to OSS. For more information, see Upload a video.

    • If you want to create a workflow and automatically trigger the workflow, you must add media buckets and create a workflow before you upload the video. After you specify the input and output media buckets and upload a media file to the input media bucket, MPS receives a message about the upload and triggers the associated workflow. After the workflow is complete, the processed media file is uploaded to the output media bucket. For more information, see Add media buckets.

  • Optional. Enable the notification feature. If you want MPS to send notifications on jobs and workflows to MNS topics or queues, configure an MNS queue or topic as required. For more information, see Set up notifications.

Submit jobs in the console

Note

The MPS console does not allow you to specify a media fingerprint library when creating a job. MPS uses the most recently created library by default.

Single job

  1. Log on to the MPS console.

  2. In the top navigation bar, select a region from the drop-down list.Region

  3. In the left-side navigation pane, choose Job Management.

  4. On the Video DNA tab, click Create Task.

  5. Configure the parameters.

Parameter

Description

Input File URL

Click Select, choose a bucket from the Bucket drop-down list, and then select an input file from the Path list.

Video DNA Pipeline

Select an mps queue from the drop-down list.

Note

If no mps queue is available in the Video DNA Pipeline drop-down list, create a media fingerprinting mps queue first. Create an mps queue.

Inbound Rule for DNA Library

Select a rule from the Inbound Rule for DNA Library options. The default is Save Non-duplicated Content Only.

  1. Click Submit to submit the media fingerprinting job.

After submitting the job, go to the Job Management > Video DNA tab. The task list shows the Job Status and Is Duplicate result for each job. If a job is marked as Duplicate, click Details in the Actions column.

Workflow

  1. Log on to the MPS console.

  2. In the top navigation bar, select a region from the drop-down list.Region

  3. In the left-side navigation pane, choose Workflows > Workflow Setup.

  4. Click Create Workflow.

  5. Configure the basic workflow settings.

    Parameter

    Description

    Workflow Name

    Enter a name for the workflow.

    Configuration Plan

    Select Custom from the drop-down list.

  6. Configure the trigger and other settings.

    Parameter

    Description

    Input Path

    Click Select and choose a bucket from the Bucket drop-down list. The folders in the selected bucket are displayed under Path. Select a path to use as the input path.

    Note

    If no bucket is available, add a media bucket first.

    MPS Queue for Transcoding

    Select an mps queue from the drop-down list.

    Note

    • This setting specifies the mps queue used for transcoding and snapshot jobs. You must set the mps queue for media fingerprinting jobs in a subsequent node.

    • If no mps queue is available, create an mps queue first.

    Publish Media File

    Set Publish Media File to Automatic Publishing.

    • Manual Publishing: After the workflow runs successfully, MPS sets the media status to unpublished. You can then publish the media manually from Manage media assets.

    • Automatic Publishing: After the workflow runs successfully, MPS sets the media status to published.

      Note

      • Published: The media asset's playback resources and snapshot files inherit access permissions from their parent bucket.

      • Unpublished: The media asset's playback resources and snapshot files have private access permissions.

    (Optional) Notifications

    Click the toggle, select a message queue or topic, and then select a specific queue or topic notification from the drop-down list.

    Note

    If no queue or topic notification is available, set up notifications first.

  7. Add a Video DNA node.

    1. Click the plus sign (+) next to the Input node and select Video DNA.

    2. Click the pencil icon next to the Video DNA node.

    3. Configure the Video DNA parameters.

      Parameter

      Description

      Video DNA Pipeline

      Select an mps queue from the drop-down list.

      Note

      If no mps queue is available in the Video DNA Pipeline drop-down list, create a dedicated media fingerprinting mps queue first. Create an mps queue.

      Inbound Rule for DNA Library

      • Save Non-duplicated Content Only: The media fingerprint library stores fingerprints of unique videos only. Fingerprints of duplicate videos are not added.

      • Do Not Save Any Media Content: The service only compares the video and does not add its media fingerprint to the library.

      Workflow Termination

      Select whether to terminate the workflow upon detecting a duplicate video.

    4. Click OK to finish configuring the Video DNA node.

  8. Click Save to create the workflow.

    After you save the workflow, it runs automatically when a file is uploaded to the specified input path.

After a workflow instance finishes, click Details in the Actions column. On the details page, copy the Task Name, then navigate to Job Management > Video DNA, select Search by ID, and paste the job name to locate the job.

The topology diagram shows each node's execution status: Input → Video DNA → Publish. Click the Video DNA node to view details including PipelineId, Library Entry Rule, Terminate, Job Name, Job Status, and Start Time.

Submit jobs by API

image

  1. Create a media fingerprint library.

    The API returns the new library's information upon creation, and the library becomes active immediately. Bind this library when submitting a job. Parameter details are in the CreateFpShotDB API reference.

    Note

    A media fingerprint library stores fingerprints. The service supports:

    • Creating libraries per user ID (UID).

    • Multiple libraries per UID for different business needs.

  2. Submit a media fingerprinting job.

    • If you have fewer than 2,000 hours of existing video content, call the SubmitFpShotJob API to submit a job. To process larger volumes, submit a ticket to request additional resources.

    • To process new videos in real time, call SubmitFpShotJob. This operation works for both incremental and existing videos. Alternatively, import existing videos first, then process them with SubmitFpShotJob.

  3. Query the job result.

    • Query results by calling QueryFpShotJobList or by receiving a callback. Results include:

      • Whether the job matched a duplicate video.

      • If a duplicate is matched, the API returns information about the duplicate video.

      • The timecode ranges of the duplication between videos.

      • The degree of duplication (a value between 0 and 1).

    • Receive callbacks: After a job completes, if MNS notifications are configured for the mps queue, the system sends a message to the specified queue or topic in Simple Message Queue (formerly MNS). Receive notifications.

Previous：Automated reviewNext：Smart tagging