All Products
Search
Document Center

:Job management

Last Updated:Jul 17, 2023

On the Tasks page of the ApsaraVideo Media Processing (MPS) console, you can submit a job with a few clicks to process a media file stored in Object Storage Service (OSS). For example, you can submit a job for transcoding, snapshots, video moderation, or media fingerprinting. This topic describes how to create and submit an MPS job, and how to view the status and details of an MPS job after the job is submitted.

Prerequisites

  • The input media bucket and output media bucket are specified. For more information, see Add media buckets.

  • An MPS queue is enabled based on the job type. For more information, see Manage MPS queues.

  • Optional. A template is created. If preset templates cannot meet your business requirements, you can create a custom template. For more information, see Transcoding templates.

Limits

The maximum size of a file that a job can process is 100 GB. If the file size exceeds the upper limit, the job fails.

Create a transcoding job

This section describes how to create a transcoding job in the MPS console. You can create a transcoding job to transcode a video into different formats so that the video can be played on various platforms. For more information about the complete process of submitting a transcoding job, see Submit a transcoding task.

Note

You can call the SubmitJobs operation to submit a transcoding job, or configure a workflow to automatically initiate multiple transcoding jobs after a file is uploaded. For more information, see Use a workflow.

  1. Log on to the MPS console.

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

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

  4. On the Encode tab, click Create Task.

  5. Configure parameters for the job. The following table describes the parameters.

Parameter

Description

Input File URL

The URL of the input file that is stored in an OSS bucket. Click Select next to the Input File URL field. In the Select File dialog box, select an OSS bucket from the Bucket drop-down list. Folders in the OSS bucket that you select are automatically displayed in the Path section. Select a file from a folder as the input file.

Note
  • If no bucket is displayed in the Bucket drop-down list, go to the OSS console and create a bucket in the specified region. For more information, see Add media buckets.

  • If no files are displayed after you select an OSS bucket, go to the OSS console and upload files to the specified bucket.

  • If you are prompted to activate OSS, go to the OSS console and activate OSS. For more information, see Activate OSS.

  • If an error message informs you that the current RAM role is invalid or you do not have the required permissions, go to the RAM console to grant the RAM user the permissions to access OSS. You can attach the AliyunOSSFullAccess policy to the RAM user to grant the RAM user full permissions on OSS, or you can customize permissions as needed. For more information, see Create a RAM user and grant permissions to the RAM user.

Encoding Pipeline

The MPS queue for transcoding. Select an MPS queue from the Encoding Pipeline drop-down list.

Note
  • If no MPS queue is displayed in the Encoding Pipeline drop-down list, enable an MPS queue for transcoding. For more information, see Manage MPS queues.

  • The maximum number of jobs that an MPS queue for transcoding can concurrently process is not guaranteed because the concurrent processing capability depends on available resources. By default, an MPS queue for transcoding can concurrently process a maximum of 200 jobs.

Output File Name

The name of the output file. Enter a name in the Output File Name field. You must include a file name extension for all types of files except for M3U8 files. Example: example_video01.mp4.

Output Path

The path of the output file to be stored in an OSS bucket. Click Select next to the Output Path field. In the Select Output Path dialog box, select an OSS bucket from the Bucket drop-down list. Folders in the OSS bucket that you select are automatically displayed in the Path section. Select a folder as the output path.

Note
  • If the output path is the same as the input path, specify an output file name that is different from the input file name. This way, the input file is not overwritten. If you specify an output file name that is the same as the input file name, you can configure OSS parameters to prevent the input file from being overwritten. For more information, see Prevent objects from being overwritten by objects that have the same names. If you disable file overwriting, the transcoded output file that shares the same name as the input file fails to be written to the OSS bucket. We recommend that you do not set the output file to the same name as the input file.

  • For more information about answers to other frequently asked questions, see the description of the Input File URL parameter.

  1. Click Next.

  2. Specify a transcoding template. The following table describes the parameters.

Parameter

Description

Template Type

The type of the transcoding template. For more information about preset templates, see the "Preset template" section of the Transcoding template topic. For information about how to create a custom transcoding template, see Transcoding templates.

Output Format

The output format of the transcoded file. Default value: mp4.

Templates

The template to be used in the transcoding job. Default value: MP4-4K.

Watermark Templates

Optional. Specifies whether to turn on Watermark Templates. If you turn on this switch, you also need to perform the following operations:

  1. Select a watermark template from the Watermark Templates drop-down list. If no watermark template is displayed in the drop-down list, create one. For more information, see Manage watermark templates.

  2. Click Select next to the Watermark Image field. In the Select File dialog box, select an OSS bucket from the Bucket drop-down list. Folders in the OSS bucket that you select are automatically displayed in the Path section. Select a file as the watermark.

    Note

    Images in the PNG format and animated images in the PNG and MOV formats are supported.

Clip Output

Optional. Specifies whether to turn on Clip Output. In this example, this switch is turned on. You can configure the start time for video editing and the length to be trimmed out to specify the duration of the video clip.

  1. In the Start From time picker, select the hour, minute, and second for the time from which the video editing starts.

    Note

    The start time cannot be greater than the total duration of the video. Otherwise, the transcoding job fails.

  2. In the Clip Length time picker, select the hour, minute, and second for the duration of a video clip.

    Note

    If the specified duration of the video clip exceeds the length of the rest part of the video, the video clip from the start time to the ending part of the video is retained.

Rotate Angle

Optional. The clockwise rotation angle for video images. Valid values: 0 to 360.

  1. Click Submit. The transcoding job is created and submitted.

    After the transcoding job is submitted, you can view the execution status and configurations of the job. You can also click the name of the job to view other information, such as the input and output paths.

    Note

    If Failed is displayed in the Encoding Status column for a transcoding job after the job is submitted but no details are provided for the failure, check the network condition and submit the job again after the network condition is back to normal.

Create an intelligent thumbnail job

The intelligent thumbnail feature integrates video AI-based understandings of video content and images with analysis of large amounts of user behavioral data. It selects an optimum keyframe or key clip of a video as the video thumbnail to improve the click-through rate and user experience of the video.

Note

You can create an intelligent thumbnail job in the China (Beijing), China (Shanghai), China (Hangzhou), or Singapore region.

  1. Log on to the MPS console.

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

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

  4. On the Intelligent Thumbnail tab, click Create Task.

  5. Configure parameters for the job. The following table describes the parameters.

Parameter

Description

Input File URL

The URL of the input file that is stored in an OSS bucket. Click Select next to the Input File URL field. In the Select File dialog box, select an OSS bucket from the Bucket drop-down list. Folders in the OSS bucket that you select are automatically displayed in the Path section. Select a file from a folder as the input file.

Note
  • If no bucket is displayed in the Bucket drop-down list, go to the OSS console and create a bucket in the specified region. For more information, see Add media buckets.

  • If no files are displayed after you select an OSS bucket, go to the OSS console and upload files to the specified bucket.

  • If you are prompted to activate OSS, go to the OSS console and activate OSS. For more information, see Activate OSS.

  • If an error message informs you that the current RAM role is invalid or you do not have the required permissions, go to the RAM console to grant the RAM user the permissions to access OSS. You can attach the AliyunOSSFullAccess policy to the RAM user to grant the RAM user full permissions on OSS, or you can customize permissions as needed. For more information, see Create a RAM user and grant permissions to the RAM user.

Intelligent Thumbnail Pipeline

The MPS queue for intelligent thumbnail creation. Select an MPS queue from the Intelligent Thumbnail Pipeline drop-down list.

Note
  • If no MPS queue is displayed in the Intelligent Thumbnail Pipeline drop-down list, enable an MPS queue for intelligent thumbnail creation. For more information, see Manage MPS queues.

  • The maximum number of jobs that an MPS queue for intelligent thumbnail creation can concurrently process is not guaranteed because the concurrent processing capability depends on available resources. By default, an MPS queue for intelligent thumbnail creation can concurrently process a maximum of 10 jobs.

Output Path

The path of the output file to be stored in an OSS bucket. Click Select next to the Output Path field. In the Select Output Path dialog box, select an OSS bucket from the Bucket drop-down list. Folders in the OSS bucket that you select are automatically displayed in the Path section. Select a folder as the output path.

Note
  • If the output path is the same as the input path, specify an output file name that is different from the input file name. This way, the input file is not overwritten. If you specify an output file name that is the same as the input file name, you can configure OSS parameters to prevent the input file from being overwritten. For more information, see Prevent objects from being overwritten by objects that have the same names. If you disable file overwriting, the transcoded output file that shares the same name as the input file fails to be written to the OSS bucket. We recommend that you do not set the output file to the same name as the input file.

  • For more information about answers to other frequently asked questions, see the description of the Input File URL parameter.

  1. Click Submit. The intelligent thumbnail job is created and submitted.

    After the transcoding job is submitted, you can view the execution status and configurations of the job. You can also click the name of the job to view other information, such as the input and output paths.

    Note

    If Failed is displayed in the Encoding Status column for a transcoding job after the job is submitted but no details are provided for the failure, check the network condition and submit the job again after the network condition is back to normal.

Create a video moderation job

MPS intelligently detects pornographic content, terrorist content, ads, and undesirable content in a video. This feature helps you reduce manpower costs for manual review and lower the risks that may be brought by non-compliant content. You can create a job to perform video moderation.

Note

You can create a video moderation job in the China (Beijing), China (Shanghai), or Singapore region.

  1. Log on to the MPS console.

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

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

  4. Click the Content Moderation tab. On the tab that appears, click Create Task.

  5. Configure the parameters in the Input and Output sections. The following table describes the parameters.

Parameter

Description

Input File URL

The URL of the input file that is stored in an OSS bucket. Click Select next to the Input File URL field. In the Select File dialog box, select an OSS bucket from the Bucket drop-down list. Folders in the OSS bucket that you select are automatically displayed in the Path section. Select a file from a folder as the input file.

Note
  • If no bucket is displayed in the Bucket drop-down list, go to the OSS console and create a bucket in the specified region. For more information, see Add media buckets.

  • If no files are displayed after you select an OSS bucket, go to the OSS console and upload files to the specified bucket.

  • If you are prompted to activate OSS, go to the OSS console and activate OSS. For more information, see Activate OSS.

  • If an error message informs you that the current RAM role is invalid or you do not have the required permissions, go to the RAM console to grant the RAM user the permissions to access OSS. You can attach the AliyunOSSFullAccess policy to the RAM user to grant the RAM user full permissions on OSS, or you can customize permissions as needed. For more information, see Create a RAM user and grant permissions to the RAM user.

Content Moderation Pipeline

The MPS queue for video moderation. Select an MPS queue from the Content Moderation Pipeline drop-down list.

Note
  • If no MPS queue is displayed in the drop-down list, enable an MPS queue for video moderation. For more information, see Manage MPS queues.

  • The maximum number of jobs that an MPS queue for video moderation can concurrently process is not guaranteed because the concurrent processing capability depends on available resources. By default, an MPS queue for video moderation can concurrently process a maximum of 10 jobs.

Moderation Type

The types of prohibited content to be detected. By default, Pornography and Terrorism are selected.

Storage Path

The path of the output file to be stored in an OSS bucket. Click Select next to the Output Path field. In the Select Output Path dialog box, select an OSS bucket from the Bucket drop-down list. Folders in the OSS bucket that you select are automatically displayed in the Path section. Select a folder as the output path.

Note
  • If the output path is the same as the input path, specify an output file name that is different from the input file name. This way, the input file is not overwritten. If you specify an output file name that is the same as the input file name, you can configure OSS parameters to prevent the input file from being overwritten. For more information, see Prevent objects from being overwritten by objects that have the same names. If you disable file overwriting, the transcoded output file that shares the same name as the input file fails to be written to the OSS bucket. We recommend that you do not set the output file to the same name as the input file.

  • For more information about answers to other frequently asked questions, see the description of the Input File URL parameter.

  1. Click Submit. The video moderation job is created and submitted.

    After the transcoding job is submitted, you can view the execution status and configurations of the job. You can also click the name of the job to view other information, such as the input and output paths.

    Note

    If Failed is displayed in the Encoding Status column for a transcoding job after the job is submitted but no details are provided for the failure, check the network condition and submit the job again after the network condition is back to normal.

Create a media fingerprinting job

You can create a media fingerprinting job to extract fingerprint features such as images and audio from a video to generate a media fingerprint. Media fingerprints can be used to find and remove duplicate videos, trace the source of video clips, filter videos that infringe copyright, and identify user-generated content (UGC).

Note

You can create a media fingerprinting job in the China (Beijing), China (Hangzhou), China (Shanghai), or Singapore region.

  1. Log on to the MPS console.

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

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

  4. Click the Video DNA tab. On the tab that appears, click Create Task.

  5. Configure parameters for the job. The following table describes the parameters.

Parameter

Description

Input File URL

The URL of the input file that is stored in an OSS bucket. Click Select next to the Input File URL field. In the Select File dialog box, select an OSS bucket from the Bucket drop-down list. Folders in the OSS bucket that you select are automatically displayed in the Path section. Select a file from a folder as the input file.

Note
  • If no bucket is displayed in the Bucket drop-down list, go to the OSS console and create a bucket in the specified region. For more information, see Add media buckets.

  • If no files are displayed after you select an OSS bucket, go to the OSS console and upload files to the specified bucket.

  • If you are prompted to activate OSS, go to the OSS console and activate OSS. For more information, see Activate OSS.

  • If an error message informs you that the current RAM role is invalid or you do not have the required permissions, go to the RAM console to grant the RAM user the permissions to access OSS. You can attach the AliyunOSSFullAccess policy to the RAM user to grant the RAM user full permissions on OSS, or you can customize permissions as needed. For more information, see Create a RAM user and grant permissions to the RAM user.

Video DNA Pipeline

The MPS queue for media fingerprinting. Select an MPS queue from the Video DNA Pipeline drop-down list.

Note
  • If no MPS queue is displayed in the Video DNA Pipeline drop-down list, enable an MPS queue for media fingerprinting. For more information, see Manage MPS queues.

  • The maximum number of jobs that an MPS queue for media fingerprinting can concurrently process is not guaranteed because the concurrent processing capability depends on available resources. By default, an MPS queue for media fingerprinting can concurrently process a maximum of 10 jobs.

Inbound Rule for DNA Library

The rule of adding fingerprints to the media fingerprint library. Default value: Save Non-duplicated Content Only.

  1. Click Submit. The media fingerprinting job is created and submitted.

    After the transcoding job is submitted, you can view the execution status and configurations of the job. You can also click the name of the job to view other information, such as the input and output paths.

    Note

    If Failed is displayed in the Encoding Status column for a transcoding job after the job is submitted but no details are provided for the failure, check the network condition and submit the job again after the network condition is back to normal.

Query a snapshot job

You can query the status of a snapshot job in a workflow that is run. For more information about how to add a snapshot node to a workflow, see Create a workflow.

  1. Log on to the MPS console.

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

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

  4. Click the Snapshot tab. Select Search by Time or Search by ID from the drop-down list.

  5. If you select Search by Time, set the Start Date and End Date parameters. If you select Search by ID, enter the ID of the snapshot job that you want to query. Then, click Search.

Related API operations