功能概述
对象存储通过数据万象 GoodsMatting 接口对图像中的商品主体进行抠图。注意:本接口属于 GET 请求,为同步请求方式,需携带签名,具体签名设置请参见 请求签名。
授权说明
下载时处理:授权策略中 action 设置为 cos:GetObject
、ci:CreateGoodsMattingJob
。上传时处理:授权策略中 action 设置为 cos:PutObject
、ci:CreateGoodsMattingJob
。云上数据处理:授权策略中 action 设置为 cos:GetObject
、cos:PutObject
、ci:CreateGoodsMattingJob
(注意 GetObject 对应的 resource 为源文件,PutObject 对应的 resource 为转存的文件)。查看所有 action。
服务开通
使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶。
使用限制
使用该接口时,请先确认相关限制条件。详情请参见 使用限制。
1. 下载时处理
GET /<ObjectKey>?ci-process=GoodsMatting HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
说明 处理后的图片直接返回至响应体。
2. 上传时处理
PUT /<ObjectKey> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth StringPic-Operations: { "is_pic_info": 1, "rules": [{ "fileid": "exampleobject", "rule": "ci-process=GoodsMatting" }]}
说明Pic-Operations 为 json 格式的字符串,具体参数信息可参考 图片持久化处理。处理后的图片存至存储桶,并以 fileid 字段的值作为对象名称。
3. 云上数据处理
POST /<ObjectKey>?image_process HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateContent-length: SizeAuthorization: Auth StringPic-Operations: { "rules": [{ "fileid": "exampleobject", "rule": "ci-process=GoodsMatting", "ignore-error": 1 }]}
说明 处理后的图片存至存储桶,并以 fileid 字段的值作为对象名称。
处理参数说明
操作名称:GoodsMatting。
参数 | 含义 | 类型 | 是否必选 |
ObjectKey | 对象文件名,例如:folder/document.jpg。 | String | 是 |
ci-process | 数据万象处理能力,商品抠图固定为 GoodsMatting。 | String | 是 |
detect-url | 您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时,后台会默认处理 ObjectKey ,填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKey detect-url 示例:http://www.example.com/abc.jpg ,需要进行UrlEncode,处理后为http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg 。 |
String | 否 |
ignore-error | 当此参数为1时,针对文件过大等导致处理失败的场景,会直接返回原图而不报错。 | int | 否 |
注意通过 ObjectKey 进行商品抠图为内网操作,不会产生额外的外网流量。通过 detect-url 进行商品抠图,会产生图片所在源站对应的外网流量。
实际案例
案例一:对存储桶内的图片进行商品抠图
内容识别相关接口需要携带签名访问,并与获取参数以“&”连接,示例如下:
img/sample.jpeg?q-sign-algorithm=?ci-process=GoodsMatting
说明为签名部分,获取方式请参考 请求签名。
案例二:对第三方图片进行商品抠图
将第三方图片(链接为http://www.example.com/abc.jpg
)在下载时进行抠图,示例如下:
https://examples-1251000004.cos.ap-shanghai.myqcloud.com/?q-sign-algorithm=<signature>?ci-process=GoodsMatting&detect-url=http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg
对象存储官网1折活动,限时活动,即将结束,速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠
转转请注明出处:https://www.yunxiaoer.com/145219.html