DocsICP FilingConsole
官方文档
首页

Stream pulling and pushing

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

The stream pulling and pushing feature of ApsaraVideo Live lets you pull existing live or video-on-demand (VOD) sources and push them as new live streams (pseudo-live streaming).

Overview

Stream pulling and pushing pulls content from third-party live streams or recorded videos and broadcasts it to viewers in real time, without traditional ingest steps.

  • You can create, view, and manage tasks in the ApsaraVideo Live console or by calling API operations.

Stream pulling and pushing flow:

image

Usage notes

  • Stream pulling and pushing is a paid feature. Billing starts at 00:00 on December 05, 2025. Pricing: Stream pulling and pushing fees.

  • Each task pushes one stream. To push multiple streams, create multiple tasks.

  • You are responsible for ensuring that the content used with the stream pulling and pushing feature complies with all applicable laws and regulations. ApsaraVideo Live provides only the stream transmission service. If any legal threats are identified, ApsaraVideo Live will stop the service for the related content and reserves the right to take legal action.

  • To pull or push streams outside China, set the task region to a region outside China.

  • Stream pulling and pushing supports event callbacks. Stream pulling and pushing event callbacks.

  • Each account can run up to 100 concurrent tasks. Limits.

Prerequisites

  • ApsaraVideo Live is activated and you are logged on to the console. Activate and purchase ApsaraVideo Live.

  • You have the required information about the live or VOD source.

    Scenario

    Information

    Live

    • The playback URL of the live stream.

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

    VOD

    Video

    • The URL path of the video source.

      Note

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

    • Maximum 30 VOD media asset IDs or video source URL paths.

    • Supported video codecs: H.264 and H.265.

    • Supported audio codec: AAC. Sampling rate: 16 kHz to 44.1 kHz.

    • VOD sources must use MP4 or FLV format.

  • An ingest URL is generated from your ingest domain. Generate streaming URLs.

Procedure

Create a task

  1. Log on to the ApsaraVideo Live console.

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

  3. Select a live center region.

  4. Click Create Task.

  5. Configure the task parameters.

    image

    The following table describes the task parameters.

    Parameter

    Description

    Region

    The task region. Select based on the source data region or the target push region.

    Note

    Supported regions: China (Shanghai), China (Beijing), China (Shenzhen), Singapore, and Indonesia (Jakarta).

    Task Name

    A custom name for the task.

    Task Time

    Specify the start and end times for the job.

    Note

    The task starts automatically at the specified start time. If it stops or fails to start, click Enable or Restart in the console.

    Callback Information

    Required. The webhook URL for task event notifications.

    Source Type

    The source stream type. Parameter details: this list item.

    • Live.

    • VOD.

    • Video URL Path.

    Playback Times

    Loop count for the playlist videos. Select infinite loop or specify a count.

    • Infinite loop.

    • Playback at a specified time.

    Note

    Available only when Source Stream Type is set to VOD or Video URL Path.

    Destination Ingest URL

    The RTMP destination URL to push the stream to.

    Note

    Example of an ApsaraVideo Live ingest URL:

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

    Parameters by source stream type:

    1. If Source Stream Type is set to Live, the source supports RTMP, SRT, and HTTP-FLV.image

    2. If Source Stream Type is set to VOD, enter the media asset ID. Obtain or update media asset information.image

    3. If Source Stream Type is set to Video URL Path, enter the video URL.

      Note

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

      image

  6. Click Submit to create the task.

Note

You can also use the Create a stream pulling and pushing task API operation.

Query a task

  1. Log on to the ApsaraVideo Live console.

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

  3. Select the region where you created the Pulled-stream Relay task. Then, you can perform a term query by Task ID, Task Name, or Destination Ingest URL.image

Note

You can also use the Query stream pulling and pushing tasks API operation.

Modify a task

  1. Log on to the ApsaraVideo Live console.

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

  3. On the Pulled-stream Relay page, find the task that you want to modify and click Edit in the Actions column.image

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

    1. If a task is in the Not Started state, you can edit its Task Time, Callback Information, and Source Type.

    2. If a task is in the Stopped state, you can edit its Callback Information and Source Type.

    3. If the task is in any other state, you cannot edit the task.

Note

You can also use the Update a stream pulling and pushing task API operation.

Delete a task

Important

Deleted stream pulling and pushing tasks cannot be recovered.

  1. Log on to the ApsaraVideo Live console.

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

  3. On the Pulled-stream Relay page, find the task that you want to delete and click Delete in the Actions column.image

  4. In the dialog box that appears, click Delete to delete the task.

Note

You can also use the Delete a stream pulling and pushing task API operation.

Start a task

Note

  • Only tasks in the Stopped state can be enabled.

  • The task starts automatically at the specified start time.

  1. Log on to the ApsaraVideo Live console.

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

  3. On the Pulled-stream Relay page, find the task that you want to start and click Enable in the Actions column.image

  4. In the dialog box that appears, click Enable to start the task.

Restart a task

Note

Only tasks in the Running state can be restarted.

  1. Log on to the ApsaraVideo Live console.

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

  3. On the Pulled-stream Relay page, find the task that you want to restart and click Restart in the Actions column.image

  4. In the dialog box that appears, click Restart to restart the task.

Note

You can also use the Restart a stream pulling and pushing task API operation.

Stop a task

Note

You can Stop a task with the Running status.

  1. Log on to the ApsaraVideo Live console.

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

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

  4. In the dialog box that appears, click Stop to stop the task.

Note

You can also use the Stop a stream pulling and pushing task API operation.

Previous：Live stream encapsulationNext：Real-Time Captions (Public Preview)