图片服务模块
所有文档

          百度信息流推广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***"
                      }
                  ]
              }
          }
          上一篇
          批量物料下载模块
          下一篇
          视频模块