Image Editing

Add image on imageAPI

Add a logo or image on top of an existing image. Parameters for fixed placement and dropshadow

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