All Products
Search

This Product

    ApsaraVideo Live:Pulled-stream relay

    Document Center

    ApsaraVideo Live:Pulled-stream relay

    Last Updated:Jan 16, 2026

    Pulled-stream relay lets you relay existing live streams or video on demand (VOD) sources to create new live streams, which is ideal for pseudo-live streaming.

    How it works

    Use pulled-stream relay to relay a third-party live stream or convert a recorded video into a live stream. This feature pulls content from live or VOD sources and rebroadcasts it in real time, bypassing the traditional stream ingest process. This simplifies content transmission and distribution.

    • You can create, view, and manage pulled-stream relay tasks in the console or by using the API.

    The following figure shows the workflow of a pulled-stream relay task:

    image

    Considerations

    • Pulled-stream relay is a paid feature. Billing starts at 00:00 on December 5, 2025. For more information, see Pulled-stream relay pricing.

    • Each task relays a single stream. To relay multiple streams, create a separate task for each.

    • Pulled-stream relay provides a relaying service only. You are responsible for ensuring that the relayed content complies with all applicable laws and regulations. ApsaraVideo Live reserves the right to stop the relay of any content that violates these requirements and to pursue legal action.

    • When pulling from or pushing to endpoints outside the Chinese mainland, select a region for the task that is also outside the Chinese mainland.

    • Pulled-stream relay supports callbacks. For more information, see Pulled-stream relay callbacks.

    • Each account is limited to a maximum of 100 concurrent tasks. For more information, see Limitations.

    Before you begin

    • Activate ApsaraVideo Live and log on to the console. For more information, see Activate service and purchase resource plans.

    • Get the required information for your live stream or VOD source.

      Source

      Information

      Live stream

      • Playback URL of the live stream.

      • Supported protocols: RTMP, SRT, HTTP-FLV.

      VOD

      Video URL

      • The URL of the video source.

        Note

        The URL must start with http:// or https:// and end with .mp4 or .flv.

      Note

      • You can add a maximum of 30 media asset IDs or URLs.

      • VOD sources must use H.264 or H.265 video codec.

      • VOD sources must use AAC audio codec, with a sample rate between 16 kHz and 44.1 kHz.

      • We recommend using the MP4 or FLV container format for VOD sources.

    • Generate an ingest URL based on your ingest domain. For instructions, see Generate live streaming URLs.

    Procedure

    Create a task

    1. Log on to the ApsaraVideo Live console.

    2. In the left navigation pane, choose Feature Management > Pulled-stream Relay.

    3. Select the region where you want to create the task.

    4. Click Create Task.

    5. Configure the task parameters.

      image

      Parameter

      Description

      Region

      Select a region based on the location of the source or the destination.

      Note

      Pulled-stream relay is available in the China (Shanghai), China (Beijing), China (Shenzhen), Singapore, and Indonesia (Jakarta) regions.

      Task Name

      A custom name for the task.

      Task Time

      The start time and end time for the task.

      Note

      The task automatically starts at the specified start time. If the task stops unexpectedly or fails to start, you can manually click Start or Restart in the console.

      Callback Information

      The callback URL for task events.

      Source Type

      The type of the source stream. For more information, see the following section. Valid values:

      • Live Stream

      • VOD Asset

      • Video Path

      Playback Times

      The number of times to play the videos in the playlist. You can choose to loop indefinitely or specify a number of plays.

      • Loop

      • Specified

      Note

      This parameter is available only for the VOD Asset and Video Path source types.

      Destination Ingest URL

      The destination to which the relayed stream is pushed. Only the RTMP protocol is supported.

      Note

      Example of an ApsaraVideo Live ingest URL:

      rtmp://ingestdomain.cn/***/***?auth_key=****922353-0-0-*****f68cba72490a3328a1167c9****

      The following list describes the parameters for each source type:

      1. If the source type is a live stream, RTMP, SRT, and HTTP-FLV are supported.image

      2. If the source type is VOD asset, enter the media asset ID. To obtain the media asset ID, see Obtain media asset information.image

      3. If the source type is a video URL, enter the URL of the video.

        Note

        The video URL must start with http:// or https:// and end with .mp4 or .flv.

        image

    6. Click Submit to create the task.

    Note

    As an alternative to the console, you can call the API to create a pulled-stream relay task. For more information, see CreateLivePullToPush.

    View a task

    1. Log on to the ApsaraVideo Live console.

    2. In the left navigation pane, navigate to Feature Management > Pulled-stream Relay.

    3. Select the region where you created the task. You can then search for the task by Task ID, Task Name, or Destination Ingest URL.image

    Note

    As an alternative to the console, you can call the API to query pulled-stream relay tasks. For more information, see DescribeLivePullToPush.

    Update a task

    1. Log on to the ApsaraVideo Live console.

    2. In the left navigation pane, navigate to Feature Management > Pulled-stream Relay.

    3. Find the task to update and click Edit in the Actions column.image

    4. On the edit page, modify the parameters as needed and click Submit.

      1. If the task status is Not Started, you can edit the Task Time, Callback Information, and Source Type sections.

      2. If the task status is Stopped, you can edit Callback Information and Source Type sections.

      3. Tasks with any other status cannot be edited.

    Note

    As an alternative to the console, you can call the API to update a pulled-stream relay task. For more information, see UpdateLivePullToPush.

    Delete a task

    Important

    Deleted pulled-stream relay tasks cannot be restored.

    1. Log on to the ApsaraVideo Live console.

    2. In the left navigation pane, navigate to Feature Management > Pulled-stream Relay.

    3. Find the task to delete and click Delete in the Actions column.image

    4. In the confirmation dialog box, click OK.

    Note

    As an alternative to the console, you can call the API to delete a task. For more information, see DeleteLivePullToPush.

    Start a task

    Note

    • You can only start tasks with the Stopped status.

    • A task automatically starts at its configured start time.

    1. Log on to the ApsaraVideo Live console.

    2. In the left navigation pane, navigate to Feature Management > Pulled-stream Relay.

    3. Find the task to start and click Start in the Actions column.image

    4. In the confirmation dialog box, click OK.

    Restart a task

    Note

    You can only restart tasks with the Running status.

    1. Log on to the ApsaraVideo Live console.

    2. In the left navigation pane, navigate to Feature Management > Pulled-stream Relay.

    3. Find the task to restart and click Restart in the Actions column.image

    4. In the confirmation dialog box, click OK.

    Note

    As an alternative to the console, you can call the API to restart a pulled-stream relay task. For more information, see RestartLivePullToPush.

    Stop a task

    Note

    You can only stop tasks with the Running status.

    1. Log on to the ApsaraVideo Live console.

    2. In the left-side navigation pane, navigate to Feature Management > Pulled-stream Relay.

    3. On the Pulled-stream Relay page, find the task to stop and click Stop in the Actions column.

    4. In the confirmation dialog box, click OK.

    Note

    As an alternative to the console, you can call the API to stop a pulled-stream relay task. For more information, see StopLivePullToPush.