Image Editing and Cropping

Add image on imageAPI

Seamlessly overlay watermarks, brand logos, or secondary layers onto your base images. Features precision pixel positioning and customizable dropshadow effects.

Test in Dashboard View Docs ← All Tools

Three ways to use this tool

REST API

One POST request. Get the result back directly — as an image, video, or JSON depending on the tool.

terminal
curl -X POST https://apiai.me/api/workflow/add-image-on-image \
     -H "X-API-Key: YOUR_API_KEY" \
     -F "image=@input.jpg" \
     -F "dropshadow=false" \
     -F "margin=20" \
     -F "opacity=1.0" \
     -F "overlay_image=@image.jpg" \
     -F "position=bottom-right" \
     -F "scale=0.2"
     --output result.png

Dashboard Playground

Test this tool visually before writing any code. Upload an image, set parameters, and see the result live. When it looks right, copy the auto-generated curl command and paste it into your app.

  1. Open the dashboard → API Toolbox
  2. Find Add image on image and click it
  3. Upload your input and adjust parameters
  4. Copy the curl command and ship
Open Dashboard →

Batch Processing

Process hundreds of images at once without writing a loop. Upload a CSV with one row per item, set your parameters, and download the results as a ZIP when they're done.

  1. Open the dashboard → Batches
  2. Select Add image on image
  3. Add your content and start the batch
  4. Download results ZIP when complete
Go to Batches →

Parameters

Name Required Description Default / Options
dropshadow optional Add a soft drop shadow beneath the logo truefalse
margin optional Gap from the nearest edges in pixels 20
opacity optional Logo opacity from 0.0 (invisible) to 1.0 (fully opaque) 1.0
overlay_image required PNG or JPEG logo / watermark to place on the image
position optional Where to place the logo on the background image top-lefttop-centertop-rightcenter-leftcenter-centercenter-rightbottom-leftbottom-centerbottom-right
scale optional Logo size: 0.01–1.0 = fraction of background width (0.2 = 20%), values above 1 = pixel width 0.2

Ready to integrate?

Get an API key, test Add image on image in the dashboard, and copy the curl command.

Get API Key Full API Reference