API参考
批量背景去除

批量图片背景去除

Action RemoveBackgroundsInBatch

简介

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

请求

参数名类型描述信息必填
ActionString对应的 API 指令名称
PublicKeyString用户公钥,可从 PICPIK用户中心 (opens in a new tab) 获取
SignatureString根据公钥及 API 指令生成的用户签名,参见 签名算法
request_uuidString请求uuid,采用uuid生成方式随机生成,可用于管理您业务和客户的请求
参数名类型描述信息必填
RawImages[]Base64需要去除背景的图片列表,以Base64编码
ErodeSizeInt主体边缘像素模糊区域(0~40),默认值: 15
ForegroundThresholdInt前景的阈值(0~255),默认值: 240
BackgroundThresholdInt背景的阈值(0~255),默认值: 15
HairOptimizationString毛发提取优化,参考值: auto、on、off,默认值: auto
OnlyMaskBool是否只返回蒙版图片,默认值: 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"]
}

响应

字段名类型描述信息必填
RetCodeInt返回状态码,为 0 则为成功返回,非 0 为失败
ActionString操作指令名称
MessageString返回错误消息,当 RetCode 非 0 时提供详细的描述信息
request_uuidString返回请求时填写的uuid
参数名类型描述信息必填
TaskUIDString任务UID,用于查询任务详情与获取结果

响应示例

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