图片服务模块

图片上传对象

字段名称 类型 描述
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]]这个区间的图片
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-08 00:44:11","2017-01-08 23: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***"
            }
        ]
    }
}