URL 拉取视频上传

最近更新时间:2019-05-31 14:38:35

接口名称

MultiPullVodFile

功能说明

  1. 通过传递视频 URL,把已经存在于网络上的视频批量拉取到腾讯云。
  2. 支持批量拉取多个视频文件(最多50个),通过输入参数中的n值区分是第几个视频。
  3. 视频拉取格式,请参见 音视频上传

注意:

请务必确保 URL 为视频文件,而不是包含视频文件的网页地址。

事件通知

文件上传成功可触发 事件通知 - URL 转拉完成。App 后台可据此监听点播系统中的 URL 拉取行为。

更多请参见 服务端事件通知简介

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
pullset.n.url String 需要拉取的第 n 个视频的 URL。n 从0开始,依次递增,下同。
pullset.n.fileName String 视频文件的名称。
pullset.n.fileMd5 string 视频文件的 MD5。
pullset.n.isTranscode Integer 是否转码,0:否,1:是,默认为0;如果不执行转码,可在上传后,在管理控制台视频文件管理进行转码。
pullset.n.isScreenshot Integer 是否截图,0:否,1:是,默认为0。
pullset.n.isWatermark Integer 是否打水印,0:否,1:是,默认为0;如果选择打水印,请务必在管理控制台提前完成水印文件选择和位置设定,否则可能导致上传失败。
pullset.n.classId Integer 视频的分类 ID。
pullset.n.tags String 视频的标签,有多个标签的话采用英文逗号分隔。
pullset.n.priority Integer 优先级:0:中;1:高;2:低。
COMMON_PARAMS 请参见 公共参数

请求示例

https://vod.api.qcloud.com/v2/index.php?Action=MultiPullVodFile
&pullset.0.url=http://www.demo.com/1.mp4
&pullset.0.fileName=MyTestVideo
&pullset.0.isTranscode=1
&pullset.0.priority=1
&pullset.0.isScreenshot=1
&pullset.0.isWatermark=1
&pullset.0.classId=0
&COMMON_PARAMS

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码。
message String 错误信息说明。
data Array 拉取上传文件任务信息集合,每个元素代表一个拉取文件的信息。
data.source_url String 视频的源 URL。
data.file_id String 视频的文件 ID。
data.file_name String 上传视频的文件名称。
data.vod_task_id String 上传任务的任务 ID。

错误码说明

错误码 含义说明
4000 - 7000 请参见 公共错误码
1 内部错误。
1000 无效参数。
1001 用户信息错误。
1010 内部错误。
1011 内部错误。
1018 拉取任务过多,请稍后再试。
1100 内部错误。
1159 内部错误。
1163 没有水印,但请求中指定了要设置水印。
10003 内部错误。

应答示例

{
    "code": 0,
    "message": "",
    "data": [
        {
            "source_url": "http://www.demo.com/1.mp4",
            "file_id": "11624759161874546966",
            "file_name": "MyTestVideo",
            "vod_task_id": "pull-d4eeccd2563c711d14405f217ea4f82e"
        }
    ]
}