API Reference
Console

Masks

post
https://api.picsart.io/tools/1.0/masks

The masks service applies a mask to an image.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

  • Supported input image formats are JPG, PNG, WEBP, TIFF, BMP, MPO, MJPEG, and HEIC (HEIF).
    • Blend: determines the appearance of the mask (7 choices)
    • Mask type: determines the mask type (11 choices)
    • Opacity: determines the opaqueness of the mask (0 to 100)
    • Hue: determines the hue of the mask (-180 to 180)
    • Mask flip: gives options to flip the mask (5 choices)

Let's give this a try ⬇️

Try below

Fill the form below and use the Try it! from the right hand side.

Postman
Run in Postman
CLI

Run with the Command Line Interface.

Body Params
file

Source image file (binary). (If this parameter is present, the other image source parameters must be empty.)

uri
length between 1 and 2083

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

string
deprecated

Deprecated. Source image ID of an image previously uploaded to Picsart or result image ID from a different API. (If this parameter is present, the other image source parameters must be empty.)

string
enum
Defaults to PNG

Optionally select one of the image formats. Options are as follows:

  • JPG
  • PNG
  • WEBP
Allowed:
string
enum
Defaults to screen

Select one of the appearance types from the list (screen is chosen if left blank). The options are as follows:

  • normal
  • screen
  • overlay
  • multiply
  • darken
  • lighten
  • add
Allowed:
string
enum
required

Select one of the mask types from the list. The options are as follows:

  • lace1
  • lace2
  • lace3
  • lace4
  • shdw2
  • shdw17
  • rpl3
  • rpl5
  • prsm3
  • prsm9
  • prsm10
integer
0 to 100
Defaults to 100

Enter an integer value from 0 to +100. The larger the number, the greater the opacity. Default is 100.

integer
-180 to 180
Defaults to 0

Enter an integer value from -180 to +180. Default is 0.

string
enum

Choose a mask flip option. The choices are as follows.

  • left
  • right
  • mirror horizontal
  • mirror vertical
  • turnaround
Allowed:
Responses

Updated 15 days ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 15 days ago