批量图片背景去除

Action RemoveBackgroundsInBatch

简介

此接口主要用于批量去除背景，也可以用于获取主体内容的蒙版。

请求

参数名	类型	描述信息	必填
Action	`String`	对应的 API 指令名称	✓
PublicKey	`String`	用户公钥，可从 PICPIK用户中心 (opens in a new tab) 获取	✓
Signature	`String`	根据公钥及 API 指令生成的用户签名，参见签名算法	✓
request_uuid	`String`	请求uuid，采用uuid生成方式随机生成，可用于管理您业务和客户的请求

参数名	类型	描述信息	必填
RawImages	`[]Base64`	需要去除背景的图片列表，以Base64编码	✓
ErodeSize	`Int`	主体边缘像素模糊区域(0~40)，默认值: 15
ForegroundThreshold	`Int`	前景的阈值(0~255)，默认值: 240
BackgroundThreshold	`Int`	背景的阈值(0~255)，默认值: 15
HairOptimization	`String`	毛发提取优化，参考值: auto、on、off，默认值: auto
OnlyMask	`Bool`	是否只返回蒙版图片，默认值: false

请求示例

{
	"Action": "RemoveBackgroundsInBatch",
	"PublicKey": "ALLak9M4cNdHXKOJAJJ4k8Hh1hZS2EgJF1D0FlPwfl",
	"Signature": "2e3ded4d95337e8e0e76c05f056ff958eb98f062",
	"request_uuid": "15ba36f2-2d69-40bd-9e0c-3e73f0f5acd0",
	"ErodeSize": 15,
	"ForegroundThreshold": 240,
	"BackgroundThreshold": 15,
	"HairOptimization": "auto",
    "OnlyMask": false,
	"RawImages": ["data:image/jpeg;base64,xxx","data:image/jpeg;base64,yyyy"]
}

响应

字段名	类型	描述信息	必填
RetCode	`Int`	返回状态码，为 0 则为成功返回，非 0 为失败	✓
Action	`String`	操作指令名称	✓
Message	`String`	返回错误消息，当 `RetCode` 非 0 时提供详细的描述信息
request_uuid	`String`	返回请求时填写的uuid

参数名	类型	描述信息	必填
TaskUID	`String`	任务UID，用于查询任务详情与获取结果	✓

响应示例

{
	"Action": "RemoveBackgroundsInBatch",
	"RetCode": 0,
	"Message": "",
	"request_uuid": "8482d350-04f9-421b-817b-1d98b3a4dcfa",
	"TaskUID": "cktlm6lrh4xxx8ng9nf0"
}

背景去除内容提取