Blending

Whether you're adding a custom watermark, layering in a texture, or composing multi-image layouts for eCommerce or social media, Blend service turns simple images into sophisticated visuals with just one call.
This endpoint lets you seamlessly combine a base image with another visual layer - like an overlay, mask, or logo - while giving you full control over how the two interact. Think of it as your virtual creative layer engine: the same power you'd expect from a professional design tool, now embedded into your workflow or platform.
No need for manual edits or complex graphic design tools. With the blend API, your app or service can automate visually rich output that's both fast and fully customizable.

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

From branding consistency to storytelling visuals, here are just a few ways teams and platforms use this service:

  • Custom Masks for Stylized Photos: Overlay shape masks or frames to give user-uploaded images a consistent look and feel - perfect for seasonal campaigns or photo templates.
  • Dynamic Watermarks for Content Protection: Automatically apply branded watermarks to images uploaded by your users or generated by your AI workflows to maintain ownership and brand visibility.
  • Texture Layers for Realistic Effects: Add grain, paper, canvas, or grunge overlays on top of your product visuals to simulate physical material or add a tactile feel.
  • Social Media Ready Graphics: Pre-build templates that dynamically layer in user data - like quotes, names, or avatars - over backgrounds to generate post-ready, shareable content in seconds.
  • eCommerce Visual Personalization: Show product previews with customers’ names, designs, or logos blended directly into product mockups like t-shirts, mugs, or packaging in real time.

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.)

file | null

Overlay image file (binary). (If this parameter is present, the other image source parameters must be empty.) This only has an effect when output=cutout.

uri | null

Overlay image URL. (If this parameter is present, the other image source parameters must be empty.) If this has a value, the output value is dismissed.

string | null
deprecated

Deprecated. Overlay 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.) See /upload method. If this has a value, the output value is dismissed.

integer | null
0 to 100
Defaults to 100

Define the opacity of the overlay added to the main image.
Takes values from 0 to 100. Default is 100 (opaque). Set to 0 to make it transparent.

string | null
enum
Defaults to normal

The blend mode. Choose one of normal, darken, multiply, lighten, screen, color_dodge, overlay, soft_light, hard_light, hue, saturation, color, luminosity. Defaults to normal.

string
enum
Defaults to JPG

Optionally select one of the image formats (JPG is chosen if left blank). Options are as follows:

  • JPG
  • PNG
  • WEBP
Allowed:
Responses

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