对象存储灰度图-数据处理接口-API 中心-腾讯云

功能概述
对象存储通过数据万象 imageMogr2/grayscale 接口将图片设置为灰度图。
授权说明
授权策略中 action 设置为 cos:GetObject 。查看所有 action。
服务开通
使用该功能将默认为您开通数据万象，并绑定存储桶，无需角色授权，即可直接使用。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
费用说明
该接口为付费服务，产生的费用将由数据万象收取，详细计费说明可参见 图片处理费用。
如果采用下载时处理的方式，且通过外网进行下载，调用会产生 流量费用。
接口示例
1. 下载时处理
GET /<ObjectKey>?imageMogr2/grayscale/<value> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
2. 上传时处理
PUT /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
Pic-Operations: 
{
  "is_pic_info": 1,
  "rules": [{
      "fileid": "exampleobject",
      "rule": "imageMogr2/grayscale/<value>"
  }]
}
3. 云上数据处理
POST /<ObjectKey>?image_process HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Content-length: Size
Authorization: Auth String
Pic-Operations: 
{
  "is_pic_info": 1,
  "rules": [{
      "fileid": "exampleobject",
      "rule": "imageMogr2/grayscale/<value>"
  }]
}
说明：
Authorization: 携带鉴权信息，用于验证请求的合法性的请求头，Pic-Operations 头部需签入签名信息中，详情请参见 请求签名 文档。
Pic-Operations 为 json 格式的字符串，具体参数信息可参考 图片持久化处理。
当 fileid 与 ObjectKey 相同时，处理后的图片将覆盖原图存储；不相同时将分别存储原图和处理后图片。
fileid  的值需要经过 URLEncode。
处理参数说明
操作名称：grayscale。
参数
含义
ObjectKey
对象文件名，例如 folder/sample.jpg。
/grayscale/<value>
将图片设置为灰度图。
value 取值为0表示不改变图片。
value 取值为1表示将图片变为灰度图。
/ignore-error/1
当处理参数中携带此参数时，针对文件过大导致处理失败的场景，会直接返回原图而不报错。
实际案例
将图片变为灰度图，示例如下：
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?imageMogr2/grayscale/1
最终效果如下：
﻿
﻿
﻿

参数	含义
ObjectKey	对象文件名，例如 folder/sample.jpg。
/grayscale/<value>	将图片设置为灰度图。 value 取值为0表示不改变图片。 value 取值为1表示将图片变为灰度图。
/ignore-error/1	当处理参数中携带此参数时，针对文件过大导致处理失败的场景，会直接返回原图而不报错。

灰度图

本页目录：

功能概述

授权说明

服务开通

使用限制

费用说明

接口示例

1. 下载时处理

2. 上传时处理

3. 云上数据处理

处理参数说明

实际案例