百度信息流推广API

    视频模块

    相关请求对象描述

    通过URL上传视频请求对象描述

    字段名称 类型 描述
    videoName string 必填,视频名称
    url string 必填,视频URL

    视频上传新接口

    接口描述

    视频分片上传新接口,无需预上传

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/VideoFeedService/sliceUploadVideoFeed/

    请求参数说明

    字段名称 类型 描述
    fileMd5 string 视频文件的md5,必填
    base64Content string 分片文件的base64内容,必填
    partMd5 string 当前分片的md5,必填
    partNo number 分片号,>=1,必填
    partSize number 分片大小,单位Byte,必须为1MB的整数倍,最大5MB,必填(最后一个分片无需是1MB的整数倍)
    maxPartNo number 最大分片号,>=1,必填
    format string 文件格式,目前仅支持mp4
    videoName string 视频名称,必填
    reqId string 请求id,客户自行指定,建议使用UUID,同一视频每一个分片的reqId必须一致,必填

    响应参数说明

    说明: 最后上传完的分片请求才有具体响应数据

    字段名称 类型 描述
    videoid number 视频id
    userid number userid
    videoName string 视频名称
    url string 视频url
    videoMd5 string 视频md5值
    source number 视频来源产品线
    format string 视频格式
    capacity number 视频大小,单位MB
    height number 视频高
    width number 视频宽
    bitRate number 视频比特率kbps
    frameRate number 视频帧率fps
    audioRate number 视频音频码率kbps
    duration number 视频时长,单位s
    thumbnail string 视频缩率图url
    addTime string 添加时间
    uploadStatus number 上传状态,0上传成功,1上传中,2上传成功但信息不完整
    videoCodec string 视频编码容器
    audioCodec string 音频编码容器
    videoRate number 视频码率kbps
    previewUrl string 预览url
    uploaded boolean 是否上传过,true: 已上传过,false: 未上传过

    请求示例

    POST /v1/feed/cloud/VideoFeedService/sliceUploadVideoFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
    	"header": {
    		"opUsername": "example",
    		"tgUsername": "example",
    		"bceUser": "example",
    		"opPassword": "example",
    		"tgPassword": "example"
    	},
    	"body": {
                "format": "mp4",
                "fileMd5": "1be7c92ea4239ddb302ffe55419f6f73",
                "reqId": "111111111222",
                "partNo": 1,
                "partMd5": "1be7c92ea4239ddb302ffe55419f6f73",
                "partSize": 1164822,
                "maxPartNo": 1,
                "videoName": "视频.mp4",
                "base64Content": "AAAAAAA"
        }
    }

    响应示例

    {
    	"body": {
            "data": [
                {
                    "audioCodec": "aac",
                    "width": 1920,
                    "uploadStatus": 0,
                    "userid": 1234,
                    "uploaded": false,
                    "audioRate": 131.8125,
                    "format": "mp4",
                    "videoName": "视频.mp4",
                    "url": "http://baidu.com/hasdfg456.mp4",
                    "videoMd5": "1be7c92ea4239ddb302ffe55419f6f73",
                    "previewUrl": "http://baidu.com/1be7c92ea4239ddb302ffe55419f6f73.mp4",
                    "duration": 15,
                    "thumbnail": "http://baidu.com/1be7c92ea4239ddb302ffe55419f6f73.png",
                    "height": 1080,
                    "source": 2,
                    "videoRate": 468.962890625,
                    "capacity": 1.11,
                    "frameRate": 25,
                    "bitRate": 605.708984375,
                    "videoid": 31421729,
                    "videoCodec": "h264",
                    "addTime": "Mar 2, 2020 3:06:50 PM"
                }
            ]
        },
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }

    视频素材查询

    接口描述

    获取视频素材信息,括视频id、规格、大小、格式、上传日期、最后修改时间、长度、名称、视频URL等等

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/VideoFeedService/getVideoFeed

    请求参数说明

    字段名称 类型 描述
    ids array(number) 视频id集合,不填则不限定视频id
    pageSize number 每页记录的数量
    pageNo number 第几页,从1开始

    响应参数说明

    字段名称 类型 描述
    userid number 账户id
    videoid number 视频id
    url string 视频url
    videoName string 视频名称
    source number 来源,2:信息流视频,7:百度推广客户端,8:信息流推荐视频,10:创意中心视频,11:聚屏,13:凤巢视频,16:凤巢模板制作,18:多镜头模板制作,19:慧合平台,21:视频片段,23:慧视自定义模板合成,24:信息流站点挖掘,25:信息流尺寸转置,31:慧拍,32:视频编辑器
    capacity number 视频大小,单位MB
    format string 视频格式
    width number 宽度
    height number 高度
    duration number 时长,单位s
    addTime number 添加时间,unix时间戳,单位毫秒
    modTime number 修改时间,unix时间戳,单位毫秒
    thumbnail string 封面图片url,为空代表该视频没有没有封面图,客户上传的视频肯定有
    deliverStatus number 投放状态,0:投放中,表示有创意正在引用该视频 1:未投放
    istranscode number 转码状态,0:转码成功,可在创意中添加该视频,1:转码中,可在创意中添加该视频,但需等转码成功之后才会审核,2:转码失败,不可在创意中添加该视频,请检查视频是否有问题,或者删除重新上传,若重新上传仍失败请发工单
    fromUserId number 由谁分享,非分享的视频不返回此字段
    videoMd5 string 视频文件md5

    说明: 原有toUserIds字段不再返回

    请求示例

    POST /v1/feed/cloud/VideoFeedService/getVideoFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
        "header": {
            "opUsername": "example",
            "tgUsername": "example",
            "bceUser": "example",
            "opPassword": "example",
            "tgPassword": "example"
        },
        "body": {
            "ids":[1321],
            "pageNo":2,
            "pageSize":10
        }
    }

    响应示例

    {
        "body": {
            "data": [
                {
                    "userid": 4323,
                    "videoId": 1321,
                    "url": "http://baidu.com/asd132fas123dfkj.mp4",
                    "videoName": "3s-video",
                    "source": 8,
                    "capacity": 12.8,
                    "format": "mp4",
                    "width": 720,
                    "height": 360,
                    "duration": 12,
                    "addTime": 723849242312,
                    "modTime": 723849232312,
                    "thumbnail": "http://baidu.com/98asdf23nbafeb.jpg",
                    "deliverStatus": 0,
                    "isTranscode": 1
                }
            ]
        },
        "header": {
            "oprs": 1,
            "failures": [],
            "succ": 1,
            "oprtime": 0,
            "desc": "success",
            "status": 0
        }
    }

    视频素材删除

    接口描述

    根据视频id删除视频

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/VideoFeedService/deleteVideoFeed

    请求参数说明

    字段名称 类型 描述
    videoids array(number) 需要删除的id集合

    响应参数说明

    返回删除的视频id

    请求示例

    POST /v1/feed/cloud/VideoFeedService/deleteVideoFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
        "header": {
            "opUsername": "example",
            "tgUsername": "example",
            "bceUser": "example",
            "opPassword": "example",
            "tgPassword": "example"
        },
        "body": {
        	"videoids":[11983201]
    	}
    }

    响应示例

    {
        "body": {
            "data": [11983201]
        },
        "header": {
            "oprs": 1,
            "failures": [],
            "succ": 1,
            "oprtime": 0,
            "desc": "success",
            "status": 0
        }
    }

    通过URL上传视频素材

    接口描述

    通过URL上传视频素材

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/VideoFeedService/uploadVideoByUrlFeed

    请求参数说明

    字段名称 类型 描述
    uploadVideoByUrls array(object) URL上传视频对象数组

    (URL上传视频对象的参数格式,见页面顶部 相关请求对象描述 -> 通过URL上传视频请求对象描述)

    响应参数说明

    响应参数与请求参数相同
    (可通过 ① 信息流推广API视频素材查询接口 http://sem.baidubce.com/v1/feed/cloud/VideoFeedService/getVideoFeed ② Web端信息流推广平台视频库列表页 ,两种方式查询视频素材是否上传成功)

    请求示例

    POST /v1/feed/cloud/VideoFeedService/uploadVideoByUrlFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
        "header": {
            "opUsername": "example",
            "tgUsername": "example",
            "bceUser": "example",
            "opPassword": "example",
            "tgPassword": "example"
        },
        "body": {
            "uploadVideoByUrls": [
                {
                    "videoName": "20200407-test",
                    "url": "http://nadvideo2.baidu.com/6c4abf8eab8a718b834a3bf250abf551_720_1280.mp4"
                },
                {
                    "videoName": "11111x22222xxxx",
                    "url": "http://nadvideo.baidu.com/c1b32fa32289d97f0bafcde736511111111111b6222.mp4"
                }
            ]
        }
    }

    响应示例

    {
        "header": {
            "desc": "success",
            "failures": [],
            "oprs": 2,
            "succ": 2,
            "status": 0,
            "oprtime": 0
        },
        "body": {
            "data": [
                {
                    "videoName": "20200407-test",
                    "url": "http://nadvideo2.baidu.com/6c4abf8eab8a718b834a3bf250abf551_720_1280.mp4"
                },
                {
                    "videoName": "11111xx2213213213213xxx2222222222xxxx",
                    "url": "http://nadvideo.baidu.com/c1b32fa32289d97f0bafcde736511111111111b6222.mp4"
                }
            ]
        }
    }
    上一篇
    图片服务模块
    下一篇
    资产分享模块