All Products
Search
Document Center

:Activate and configure ApsaraVideo VOD

Last Updated:Jan 22, 2026

Before you use the Qvideo Demo, you must configure templates and other settings in the ApsaraVideo VOD console. This topic describes the required configuration.

Prerequisites

  • An Alibaba Cloud account is created and real-name verification is complete. To create an Alibaba Cloud account, visit the Alibaba Cloud official website. For more information, see Create an Alibaba Cloud account.

  • ApsaraVideo VOD is activated. For more information, see Activate ApsaraVideo VOD.

  • A domain name for Alibaba Cloud Content Delivery Network (CDN) is added in the ApsaraVideo VOD console. For more information, see Add an accelerated domain name.

  • You can store the source content for your accelerated domain name in the storage service provided by ApsaraVideo VOD or in Object Storage Service (OSS). If your source content is not stored on Alibaba Cloud, you must submit a request on Yida for assistance before you proceed.

Video-on-demand service configuration

  1. Configure a transcoding template group.

    For the Qvideo Demo, you must create a transcoding template group to ensure a good video experience and resource security in short video scenarios. This topic uses a low definition, watermark-free template and a standard definition, watermarked template as examples. For more information about how to create a transcoding template group, see Transcoding templates.

    • To configure a low definition, watermark-free template, set Definition to Low Definition, disable Watermark, and click Save.Watermark-free

    • To configure a watermarked template with a standard definition, set Definition to Standard Definition, enable Watermark, use the default Watermarks, and click Save.有水印

    Note
    • The Qvideo Demo supports recommending Narrowband HD transcoded videos in the console. To use this feature, you must create another transcoding template group and configure a Narrowband HD transcoding template.

    • The transcoding template group ID must be configured in the server-side source code configuration file. Record the ID for later use. For more information, see Server-side integration.

  2. Configure callback settings.

    The Qvideo Demo uses callbacks for operations such as transcoding, snapshotting, video AI processing, and automated review. It uses HTTP requests to send status notifications. After you configure a URL in the console, the ApsaraVideo VOD server sends an HTTP POST request to that URL when an event occurs. The content is delivered in the HTTP body. The Qvideo Demo server-side has basic callback processing capabilities. You can set the URL to the callback service endpoint of the server-side ECS instance to handle callbacks. You can also deploy a separate HTTP server to receive and process callback messages. For more information, see Callback settings.

    1. Set the callback method to HTTP request.

    2. Set the callback URL to the callback service endpoint of the server-side ECS instance. This lets you use the callback processing logic that is included in the Qvideo Demo server-side source code.

      Example: http://<Public IP address of the ECS instance>:8080/vodcallback/callback.

    3. For the Qvideo Demo, you must set the following callback events: Single Definition Transcoding Completed, All Definitions Transcoding Completed, Video Snapshot Completed, Video AI Processing Completed, Live Stream Recording Completed, Manual Review Completed, and Video Composition Completed. You can select other events as needed. After the configuration is complete, an HTTP POST request is sent to the configured URL to notify your application server when a selected callback event occurs.回调设置

    4. Configure callback authentication

      When you use HTTP requests for callbacks, you can configure callback authentication. This feature adds a specific signature header to HTTP and HTTPS callbacks. The receiving server can use this header to authenticate the signature and prevent unauthorized or invalid requests.

      Enable Callback Authentication, set a custom authentication key, and click OK.回调配置

    Note
    • The callback URL and authentication key are configured in the server-side source code configuration file in a later step. Record them for later use. For more information, see Server-side integration.

    • An incorrect configuration of the callback URL, callback events, or callback authentication can cause issues. For example, the video status may remain in the 'reviewing' or 'transcoding' state, or other callback processing failures may occur.

  3. Download settings.

    If you want to allow users to download videos, you must enable the download feature. For more information, see Offline download.

    Important

    If the download feature is not enabled, the message 'Download switch is off' is displayed when a user tries to download a video on a mobile device.