对象存储商品抠图-API 文档-文档中心-腾讯云

功能概述
对象存储通过数据万象 GoodsMatting 接口对图像中的商品主体进行抠图。
注意：
本接口属于 GET 请求，为同步请求方式，需携带签名，具体签名设置请参见 请求签名。
 授权说明
下载时处理：授权策略中 action 设置为 cos:GetObject、ci:CreateGoodsMattingJob。
上传时处理：授权策略中 action 设置为 cos:PutObject、ci:CreateGoodsMattingJob。
云上数据处理：授权策略中 action 设置为 cos:GetObject、cos:PutObject、ci:CreateGoodsMattingJob（注意 GetObject 对应的 resource 为源文件，PutObject 对应的 resource 为转存的文件）。
查看所有 action。
服务开通
使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
费用说明
该接口为付费服务，产生的费用将由数据万象收取，详细计费说明可参见 内容识别费用。
1. 下载时处理
GET /<ObjectKey>?ci-process=GoodsMatting 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": "ci-process=GoodsMatting"
  }]
}
说明
Pic-Operations 为 json 格式的字符串，具体参数信息可参考 图片持久化处理。
处理后的图片存至存储桶，并以 fileid 字段的值作为对象名称。
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: 
{
  "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 链接，无需再填写 ObjectKeydetect-url 示例：http://www.example.com/abc.jpg ，需要进行UrlEncode，处理后为http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg。
String
否
ignore-error
当此参数为1时，针对文件过大等导致处理失败的场景，会直接返回原图而不报错。
int
否
注意
通过 ObjectKey 进行商品抠图为内网操作，不会产生额外的外网流量。
通过 detect-url 进行商品抠图，会产生图片所在源站对应的外网流量。
实际案例
案例一：对存储桶内的图片进行商品抠图
内容识别相关接口需要携带签名访问，并与获取参数以“&”连接，示例如下：
https://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=<signature>?ci-process=GoodsMatting
说明
<signature>为签名部分，获取方式请参考 请求签名。
案例二：对第三方图片进行商品抠图
将第三方图片（链接为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
﻿

参数	含义	类型	是否必选
ObjectKey	对象文件名，例如：folder/document.jpg。	String	是
ci-process	数据万象处理能力，商品抠图固定为 GoodsMatting。	String	是
detect-url	您可以通过填写 `detect-url` 处理任意公网可访问的图片链接。不填写 `detect-url` 时，后台会默认处理 `ObjectKey` ，填写了 `detect-url` 时，后台会处理 `detect-url` 链接，无需再填写 `ObjectKeydetect-url` 示例：`http://www.example.com/abc.jpg` ，需要进行UrlEncode，处理后为`http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg`。	String	否
ignore-error	当此参数为1时，针对文件过大等导致处理失败的场景，会直接返回原图而不报错。	int	否

商品抠图

本页目录：

功能概述

授权说明

服务开通

使用限制

费用说明

1. 下载时处理

2. 上传时处理

3. 云上数据处理

处理参数说明

实际案例

案例一：对存储桶内的图片进行商品抠图

案例二：对第三方图片进行商品抠图