API Reference
Erase Contents

Erase content from pictures

Action RemoveContents

Introduction

This interface is used to erase the content in a picture

Request

Parameter NameTypeDescriptionRequired
ActionStringThe corresponding API instruction name
PublicKeyStringUser's public key, which can be obtained from the PICPIK User Center (opens in a new tab)
SignatureStringUser's signature generated based on the public key and API instruction, see Signature for details
request_uuidStringRequest UUID, randomly generated by using the UUID generation method. This parameter can be utilized to manage the requests of your business and clients.
Parameter NameTypeDescriptionRequired
RawImageBase64The raw image encoded in Base64.
MaskBase64A mask encoded in Base64 defines contents to be erased. The mask is a monochrome image where the white part represents the redrawn part.
InvertMaskBoolWhether to invert the mask, default: false
MaskBlurIntMask edge blur radius (0~64), default: 12

Request Example

{
	"Action": "RemoveContents",
	"PublicKey": "ALLak9M4cNdHXKOJAJJ4k8Hh1hZS2EgJF1D0FlPwfl",
	"Signature": "2e3ded4d95337e8e0e76c05f056ff958eb98f062",
	"request_uuid": "15ba36f2-2d69-40bd-9e0c-3e73f0f5acd0",
	"RawImage": "data:image/png;base64,xxx",
	"Mask": "data:image/png;base64,xxx"
}

Response

Field NameTypeDescriptionRequired
RetCodeIntReturn status code: 0 indicates a successful return, while non-zero indicates a failure
ActionStringInstruction name
MessageStringThe error message is returned when RetCode is non-zero, providing a detailed description
request_uuidStringReturns the UUID that was included in the request
Parameter NameTypeDescriptionRequired
TaskUIDStringTask UID, used to query task details and get results

Response Example

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