You need to enable JavaScript to run this app.
导航
创建拉流转推任务
最近更新时间:2023.10.12 17:39:57首次发布时间:2022.01.17 10:33:21

创建一个拉流转推任务,支持从点播拉流与从直播拉流两种方式。

说明

该接口属于历史版本 API,我们计划于 2023 年 12 月 25 日停止对其进行维护,并于 2024 年 3 月 25 日下线文档,建议您使用新版创建拉流转推任务接口。

注意事项

请求频率:单用户请求频率限制为 10 次/秒

请求说明

  • 请求方式:POST
  • 请求地址:https://live.volcengineapi.com?Action=CreatePullToPushTask&Version=2020-08-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

Query

参数类型是否必选示例值描述
ActionStringCreatePullToPushTask接口名称。当前 API 的名称为 CreatePullToPushTask
VersionString2020-08-01接口版本。当前 API 的版本为 2020-08-01

Body

参数类型是否必选示例值描述
TitleStringtask001标题,支持中英文字符、数字,最大长度为 10 个字符
StartTimeInteger1640891476开始时间,Unix 时间戳,单位为 s
EndTimeInteger1640841476结束时间,Unix 时间戳(秒)
CallbackURLStringhttp://example.mtime.cn/live/example/callbackapi回调地址,最大长度为 2000 个字符

Type

Integer

0

拉流来源类型。支持以下 2 种取值。

  • 0:直播源;
  • 1:点播视频。

CycleMode

Integer

-1

循环模式。当 "Type":1 时,为必选参数。当 "Type":0 时,该参数无效。参数取值及含义如下所示。

  • -1:默认值,表示无限循环,至任务结束;
  • 0:表示有限次循环,循环次数为 PlayTimes 的取值。
PlayTimesInteger3点播文件循环播放次数。当 "CycleMode":0 时,为必选参数。
DstAddrStringrtmp://example.mtime.cn/Video/2022/02/04/mp4/190204084208765161.mp4推流地址
DomainStringexample.mtime.cn推流域名,DstAddr 为空时必传;反之,则该参数不生效
AppStringlive推流 App 名称,DstAddr 为空时必传;反之,则该参数不生效
StreamStringstream-123转推的推流流名,DstAddr 为空时必传;反之,则该参数不生效

SrcAddr

String

http://example.mtime.cn/Video/2003/02/04/mp4/190204084208765161.mp4

拉流地址,与 SrcAddrS 二选一

最大长度为 1000 个字符。

SrcAddrSArray of String["https://pull.example.com/live/stream-123"]拉流地址列表,与 SrcAddr 二选一。最多支持传入 20 个拉流地址。
WatermarkObject of Watermark水印信息

PreDownload

Integer

1

是否开启点播预热,仅对点播地址生效。

  • 0:不开启;
  • 1: 开启(默认值)。
OffsetSArray of Float点播文件启播时间偏移值, 单位秒;数量与 SrcAddrS 列表数量相等。

ContinueStrategy

Integer

9

续播策略,支持以下配置项。

  • 0:从断流处续播(默认值);
  • 1:从断流处+自然流逝时长处续播。
OffsetFloat30点播文件启播时间偏移值,仅当 SrcAddr 不为空时生效。

Watermark

参数类型是否必选示例值描述

Picture

String

data:image/png;base64,iVBORw0KGg\*\*\*\*mCC

水印图片字符串,图片最大 2MB,最小 100Bytes,最大分辨率为 1080×1080。图片 Data URL 格式为:data:[<mediatype>];[base64],<data>

  • mediatype:图片类型,支持 png、jpg、jpeg 格式;
  • data:base64 编码的图片字符串。
    例如,data:image/png;base64,iVBORw0KGg****mCC
RelativePosXFloat0.1水平偏移,表示水印左侧边与转码流画面左侧边之间的距离,使用相对比率,取值范围为 [0,1)
RelativePosYFloat0.1垂直偏移,表示水印顶部边与转码流画面顶部边之间的距离,使用相对比率,取值范围为 [0,1)
RatioFloat0.1水印宽度,占直播原始画面宽度百分比,支持精度,小数点后两位

返回参数

下表仅列出本接口特有的返回参数。更多信息请见返回结构

参数类型示例值描述
TaskIdString8fde6aa0281d9f6e15e6059a6e242365任务 ID,任务的唯一标识

示例

请求示例

POST https://live.volcengineapi.com?Action=CreatePullToPushTask&Version=2020-08-01
{
    "Type":0,
    "DstAddr": "rtmp://example.mtime.cn/Video/2022/02/04/mp4/190204084208765161.mp4",
    "EndTime": 1640881476,
    "SrcAddr": "http://example.mtime.cn/Video/2003/02/04/mp4/190204084208765161.mp4",
    "StartTime": 1640841476,
    "Title": "sutest001",
    "CallbackURL":"http://example.mtime.cn/live/test/callbackapi"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202112311457430101742350380352BCB2",
    "Action": "CreatePullToPushTask",
    "Version": "2020-08-01",
    "Service": "live",
    "Region": "cn-north-1"
  },
  "Result": {
    "TaskId": "8fde6aa0281d*******9a6e242365"
  }
}

错误码

访问公共错误码获取详细信息。