百度信息流推广API

    图片服务模块

    图片上传对象

    字段名称 类型 描述
    content string Base64编码后的图片内容;
    不能为空;支持jpg/jpeg/png格式;最大不超过1M
    desc string 图片描述,不超过200个字符

    图片对象

    字段名称 类型 描述
    imageId string 图片标识id
    url string 图片上传成功后生成的链接
    width number 宽, 要求(宽_高)
    370px_245px1116px_627px
    644px_280px600px_248px
    190px_190px220px_220px
    629px_90px120px_90px
    560px_170px218px_146px
    120px_120px
    height number 高, 规格同上
    size number 图片大小, 1M以内
    format string 图片格式, jpg/jpeg/png
    date string 图片上传时间
    desc string 图片描述, 不超过200个字符
    注:英文字母占1个字符,1个汉字占2个字符
    signature string 图片MD5值
    source number 图片来源
    1:web
    2:api
    3:版权库
    4:霓裳
    isCollected number 图片收藏,
    0:代表不收藏
    1:代表收藏

    分页对象

    字段名称 类型 描述
    page number 当前页,默认为1
    desc string 当前页面大小,默认10,取值范围[1, 100]
    totalNumber number 总条数
    totalPage number 总页数

    上传图片

    接口描述

    图片批量上传接口,一次可以上传最多5张图片,每天最多上传5000张图片,账户累计上传图片不能超过20万张图片。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/ImageService/addImage

    请求参数说明

    字段名称 类型 描述
    images array(object) 图片上传对象数组,请参考其定义。最大长度为5,对应5张图片

    响应参数说明

    响应为图片对象数组,请参考其定义。

    响应结果中的创意对象与请求参数中一一对应(其中失败的不会包含在data中,但会在error中提供错误信息)

    请求示例

    POST /v1/feed/cloud/ImageService/addImage 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": {
    		"images": [
           		{
               		"content": "图片的base64编码",
               		"desc": "图片的描述"
           		}
       		]
    	}
    }

    响应示例

    {
        "header":{
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
        },
        "body":{
            "data":[
                {
    				"imageId": "1233-1dcca23355272056f04fe8bf20edf***",
                    "url": "http://bj.bcebos.com/fc-feed/***",
    				"width": 370,
    				"height": 245,
    				"size": 1233,
    				"format": "jpg",
    				"date": "2016-12-08 00:44:11",
    				"signature": "1dcca23355272056f04fe8bf20edf***"
                }
            ]
        }
    }

    查询图片

    接口描述

    通过图片规格、大小、格式、时间区间等条件,筛选出合适的图片返回。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/ImageService/getImage

    请求参数说明

    字段名称 类型 描述
    resolution array((number)) 图片规格,选填,二维数组,支持多个分辨率,分别表示为:[[宽,高],…,[宽,高]]
    size array(number) 图片大小区间,选填,数组长度为2,表示获取大小在[size[0],size[1]]这个区间的图片
    format array(string) 图片格式,选填,可选范围为上传图片时限定的范围。["jpg","png"]
    date array(string) 时间区间, 选填,数组长度为2,表示获取上传日期在[date[0], date[1]]这个区间的图片,时间格式为yyyy-MM-ddTHH:mm:ss
    page number 当前页
    pageSize number 当前页大小
    isCollected number 图片收藏

    响应参数说明

    字段名称 类型 描述
    images array(object) 图片对象数组,请参考其定义。
    pageInfo array(object) 分页对象数组,请参考其定义。

    请求示例

    POST /v1/feed/cloud/ImageService/getImage 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": {
    		"pageSize": 15,
       		"page": 1,
       		"date": ["2016-12-08T00:44:11","2017-01-08T23:44:11"],
       		"resolution": [
           		[370,245],
           		[120,120]],
       		"size": [1,10000],
       		"format": ["jpg"]
    	}
    }

    响应示例

    {
        "header":{
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
        },
        "body":{
            "data":[
                {
    				"imageId": "1233-1dcca23355272056f04fe8bf20edf***",
                    "url": "http://bj.bcebos.com/fc-feed/***",
    				"width": 370,
    				"height": 245,
    				"size": 1233,
    				"format": "jpg",
    				"date": "2016-12-08 00:44:11",
    				"signature": "1dcca23355272056f04fe8bf20edf***",
    				"desc": "图片需要的描述"
                }
            ]
        }
    }

    修改图片

    接口描述

    更新图片描述。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/ImageService/updateImage

    请求参数说明

    字段名称 类型 描述
    imageTypes array(object) 图片对象数组,请参考其定义。

    响应参数说明

    响应为图片对象数组,请参考其定义。

    响应结果中的创意对象与请求参数中一一对应(其中失败的不会包含在data中,但会在error中提供错误信息)

    请求示例

    POST /v1/feed/cloud/ImageService/updateImage 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": {
    		"imageTypes": [{
    			"imageId": "1233-1dcca23355272056f04fe8bf20edf***",
    			"desc": "图片需要修改的描述"
    
    		}]
    	}
    }

    响应示例

    {
        "header":{
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
        },
        "body":{
            "data":[
                {
    				"imageId": "1233-1dcca23355272056f04fe8bf20edf***",
                    "url": "http://bj.bcebos.com/fc-feed/***",
    				"width": 370,
    				"height": 245,
    				"size": 1233,
    				"format": "jpg",
    				"date": "2016-12-08 00:44:11",
    				"signature": "1dcca23355272056f04fe8bf20edf***",
    				"desc": "图片需要的描述"
                }
            ]
        }
    }

    删除图片

    接口描述

    删除图片。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/ImageService/deleteImage

    请求参数说明

    字段名称 类型 描述
    imageIds array(string) 需要删除的图片id数组

    响应参数说明

    响应为图片对象数组,请参考其定义(只返回被删除的图片id)。 响应结果中的创意对象与请求参数中一一对应(其中失败的不会包含在data中,但会在error中提供错误信息)

    请求示例

    POST /v1/feed/cloud/ImageService/deleteImage 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": {
    		"imageIds": ["1233-1dcca23355272056f04fe8bf20edf***"]
    	}
    }

    响应示例

    {
        "header":{
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
        },
        "body":{
            "data":[
                {
    				"imageId": "1233-1dcca23355272056f04fe8bf20edf***"
                }
            ]
        }
    }

    图片尺寸适配

    接口描述

    图片尺寸适配,根据传入的目标宽高,裁剪已有图片,并存入图片库。采用等比例居中裁剪缩放方式。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/ImageProcessingService/addCropImage

    请求参数说明

    字段名称 类型 描述
    srcUrl string 原始图片URL,要求为图片库中已有图片
    width number 目标图片宽度,需小于等于原始图片宽度
    height number 目标图片高度,需小于等于原始图片高度
    desc string 图片描述, 不超过200个字符
    注:英文字母占1个字符,1个汉字占2个字符

    响应参数说明

    响应为图片对象数组,请参考其定义。

    请求示例

    POST /v1/feed/cloud/ImageProcessingService/addCropImage 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": {
    		"srcUrl": "http://bj.bcebos.com/fc-feed/***",
    		"width": 370,
    		"height": 245,
    		"desc": "图片描述"
    	}
    }

    响应示例

    {
        "header":{
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
        },
        "body":{
            "data":[
                {
    				"imageId": "1233-1dcca23355272056f04fe8bf20edf***",
    				"url": "http://bj.bcebos.com/fc-feed/***",
    				"width": 370,
    				"height": 245,
    				"size": 1233,
    				"format": "jpg",
    				"date": "2016-12-08 00:44:11",
    				"signature": "1dcca23355272056f04fe8bf20edf***"
                }
            ]
        }
    }
    上一篇
    批量物料下载模块
    下一篇
    视频模块