视频直播拉流转推功能可以帮助您将已有的直播源或点播源进行转推（伪直播场景），本文将详细为您介绍如何使用拉流转推功能。
功能说明
当您需要将第三方直播源转推出去，或者希望将录制好的视频转换成直播形式推流时，可以利用拉流转推功能，借助这一功能，您可以从不同的直播源或点播源中抓取内容，并将其实时转播给观众。整个过程中无需执行传统的直播推流步骤。这样便能高效地实现内容的传输与分发。
拉流转推功能支持内容拉取和转推，您可以通过控制台或API接口实现创建任务、查看任务和管理任务。
拉流转推任务处理流程：
典型场景
车载监控接入
车载设备若输出 JT/T 1078 或苏标等私有协议视频流，需先通过协议转换网关将其转换为 RTMP 标准格式，再接入拉流转推功能。创建拉流转推任务时，源流类型选择直播，源流协议选择 RTMP，填写转换后的 RTMP 源流地址和目标推流地址。任务创建完成后，移动端可通过阿里云播放器 SDK 拉流播放。
注意事项
拉流转推属于收费功能，于 2025年12月05日 00:00 起正式计费。费用详情请参见拉流转推费用。
一条拉流转推任务，只支持进行一路流的转推操作，多路流需要创建多个任务。
同一时间内，同一目标推流地址仅允许一条有效任务运行。两条任务的目标推流地址除
auth_key外完全相同时，视为推流至同一StreamName。此时并发运行会发生推流冲突，后一路推流可能覆盖或抢占前一路，导致直播画面中断或异常。拉流转推功能只提供转推服务，您需要确保转推内容符合相关法律法规，若存在法律风险，视频直播会停止相关内容的转推服务，并保留追究法律责任的权利。
在使用拉流转推功能进行海外流的拉取或向海外推送时，务必调整任务的区域设置为海外，以确保操作顺利进行。
拉流转推提供回调功能，具体可参考拉流转推事件回调。
每个账号最多支持 100 路任务并发，具体信息请参见使用限制。
前提条件
开通视频直播功能，并登录到视频直播控制台开通与购买视频直播。
已获取直播源或点播源的相关信息。
场景
信息
直播
直播播放地址。
直播的源流协议包括：RTMP、SRT、HTTP-FLV。
点播
点播源的媒资ID，获取方式请参见获取/更新媒资信息。
视频
视频源的地址路径。
说明视频路径地址固定前缀 http:// 或 https:// ，以 .mp4 或 .flv 结尾
说明点播源的媒资ID或视频源的地址路径最多可添加30个。
点播源视频编码格式仅支持H.264与H.265格式。
点播源音频编码格式仅支持AAC格式，音频采样率需要控制在16 kHz - 44.1 kHz。
点播源的VOD文件格式建议使用MP4或FLV格式。
根据添加的推流域名生成推流地址，具体方式可参见生成直播地址。
操作步骤
创建拉流转推任务
- 登录视频直播控制台。
在左侧导航栏选择功能管理 > 拉流转推，进入拉流转推页面。
选择直播中心区域。
单击创建任务。
配置拉流转推任务参数。
拉流转推任务参数及说明如下表所示。
参数
描述
地域
拉流转推任务所属地域，用户可根据需要拉取的源数据所属地域或推流所属地域配置。
说明当前拉流转推支持华东2（上海）、华北2（北京）、华南1（深圳）、亚太东南1（新加坡）和印度尼西亚（雅加达）五个地域。
任务名称
用户自定义当前任务名称。
任务时间
任务的开始时间与结束时间，默认开始时间为当前时间后 5 分钟、结束时间为开始时间后 24 小时。时间选择器提供5 分钟、30 分钟和1 小时快捷项，单击后按当前时间调整开始时间，结束时间保持不变。
说明当前时间到达用户设置的开始时间时，任务将自动启动，若任务因其他原因出现异常停止或启动失败。则用户可通过控制台手动执行启用或重启操作。
事件回调信息
拉流转推任务事件的回调地址，需要用户提供并填写。
源流类型
当前拉流转推任务的源视频流类型，具体参数填写可参考此列表项。
直播：支持RTMP、SRT、HTTP-FLV源流协议。
点播：支持MP4视频格式。同一视频ID下，存在多条视频时，优先选择最高分辨率转码视频，若转码视频分辨率相同，随机选择其中一条；无转码视频时，选择原视频。
视频地址路径。
播放次数
由用户选择播放列表中视频的循环播放次数，可选择无限循环或指定循环次数。
无限循环。
指定播放。仅当源流类型为点播或视频地址路径时配置播放次数。
目标推流地址
当前拉流转推任务转推的目标地址，源流类型为直播时支持 rtmp:// 和 rtmps:// 协议；点播或视频地址路径仅支持 rtmp:// 协议。
说明以阿里云视频直播推流地址为例：
rtmp://tuiliuyuming.cn/***/***?auth_key=****922353-0-0-*****f68cba72490a3328a1167c9****
回调配置参数说明如下：
视频切换通知：仅当源流类型为点播或视频地址路径时显示，默认关闭。开启后，切换文件时通过回调地址通知业务方。
回调鉴权：默认关闭。开启后，回调请求携带签名头
ALI-LIVE-TIMESTAMP和ALI-LIVE-SIGNATURE。ALI-LIVE-SIGNATURE计算方法
ALI-LIVE-SIGNATURE=LOWERCASE_HEX(MD5(SIGNCONTENT)) SIGNCONTENT=拉流转推任务ID|ALI-LIVE-TIMESTAMP取值|鉴权KEY字段说明
拉流转推任务ID：完成创建后可在控制台获取。
ALI-LIVE-TIMESTAMP：回调请求发起的UNIX时间戳（单位：秒）。
鉴权KEY：用户为对应回调地址配置的鉴权KEY。
鉴权 Key：仅当开启回调鉴权时显示，必须填写 16～32 位字符（包含大写字母、小写字母和数字）。
源流类型参数说明如下：
当源流类型为直播时，源流协议支持RTMP、SRT和HTTP-FLV三种。
当源流类型为点播时，需要输入所需视频的点播媒资ID，相关ID获取可参考获取/更新媒资信息。在视频列表中输入点播媒资 ID，最多可添加 30 个视频，系统将按顺序轮播。在播放次数中选择无限循环或指定播放。
当源流类型为视频地址路径时，输入所需视频地址路径。
说明视频路径地址固定前缀 http:// 或 https:// ，以 .mp4 或 .flv 结尾。
单击提交，完成创建。
要创建拉流转推任务除控制台操作外，您还可通过API接口实现，具体可参考创建拉流转推任务。
查询任务
- 登录视频直播控制台。
在左侧导航栏选择功能管理 > 拉流转推，进入拉流转推页面。
选择创建拉流转推任务时所选的地域，然后您可根据任务ID、任务名称和目标流地址进行精确查询。
要查询拉流转推任务除控制台操作外，您还可通过API接口实现，具体可参考查询拉流转推任务。
复制任务
在左侧导航栏选择功能管理 > 拉流转推，进入拉流转推页面。
选择任务所在的直播中心区域，在任务列表中找到要复制的任务，在操作列单击复制。
在创建任务页面确认或调整预填的配置，然后单击提交创建新任务。复制规则如下：
原任务处于未开始状态时，除任务名称外，原任务的配置以及开始时间和结束时间都会预填。
原任务处于运行中、运行异常或停止运行状态时，除任务名称外，原任务的配置会预填；开始时间默认设置为当前时间后 5 分钟，结束时间沿用原任务的设置。
原任务处于已结束状态时，不提供复制入口。
所有复制场景都会清空任务名称。如果不填写任务名称，系统会自动生成
taskname_+当前时间戳格式的名称。
修改任务
- 登录视频直播控制台。
在左侧导航栏选择功能管理 > 拉流转推，进入拉流转推页面。
在拉流转推页面找到需要修改的任务，点击操作列编辑按钮。
在编辑页面上根据您的需求进行相关参数修改，修改完成后点击提交。
当任务处于未开始状态时，您可以修改任务时间、回调地址、播放次数、配置源流信息中允许编辑的源流内容、回调鉴权、鉴权 Key和视频切换通知。
当任务处于停止运行状态时，您可以修改回调地址、播放次数、配置源流信息中允许编辑的源流内容、回调鉴权、鉴权 Key和视频切换通知。
无论任务处于何种状态，地域、目标地址、源流类型和源流协议均不可修改；任务处于其他状态时，不能修改任务配置。
要修改拉流转推任务除控制台操作外，您还可通过API接口实现，具体可参考更新拉流转推任务。
删除任务
注意拉流转推任务删除后无法再次找回。
- 登录视频直播控制台。
在左侧导航栏选择功能管理 > 拉流转推，进入拉流转推页面。
在拉流转推页面找到需要删除的任务，点击操作列删除按钮。
在弹框中选择删除，即可删除当前任务。
要删除拉流转推任务除控制台操作外，您还可通过API接口实现，具体可参考删除拉流转推任务。
启动任务
当任务处于停止运行状态时，可对任务进行启用操作。
当到达开始时间时，任务会自动启动。
- 登录视频直播控制台。
在左侧导航栏选择功能管理 > 拉流转推，进入拉流转推页面。
在拉流转推页面找到需要启动的任务，点击操作列启用按钮。
在弹框中选择启用，即可启动当前任务。
重启任务
当任务处于运行中状态时，可对任务进行重启操作。
- 登录视频直播控制台。
在左侧导航栏选择功能管理 > 拉流转推，进入拉流转推页面。
在拉流转推页面找到需要重启的任务，点击操作列重启按钮。
在弹框中选择重启，即可重启当前任务。
要重启拉流转推任务除控制台操作外，您还可通过API接口实现，具体可参考重启拉流转推任务。
停用任务
当任务处于运行中状态时，可对任务进行停止操作。
- 登录视频直播控制台。
在左侧导航栏选择功能管理> 拉流转推，进入拉流转推页面。
在拉流转推页面找到需要重启的任务，点击操作列停止按钮。
在弹框中选择停止，即可停止当前任务。
要停用拉流转推任务除控制台操作外，您还可通过API接口实现，具体可参考停止拉流转推任务。
常见问题
创建拉流转推任务后，如何生成直播播放地址？
拉流转推的直播播放地址须基于“目标推流地址”对应的关联播流域名、AppName 和 StreamName 生成。您可以使用控制台的地址生成器或通过自定义拼接生成，详情请参见生成直播地址。
第三方源流断开后，拉流转推任务会自动恢复吗？
当第三方源流断开后，任务进入 Recovering（异常运行）状态，系统默认每 1 分钟尝试重新拉流一次，最多重试 3 次。
若 3 分钟内源流恢复且拉流成功，任务状态自动恢复为 Running（正常运行）。
若 3 次重试均未成功，任务状态变为 Offline（已停止），系统不再自动尝试拉流。此时必须通过控制台单击重启按钮或调用 RestartLivePullToPush 接口手动重启任务。