🔄

Image Composite

Blend two images together with configurable blend mode and opacity

GET 10 credits /v1/image/composite

curl "https://image.toolkitapi.io/v1/image/composite?base_url=https://toolkitapi.io/static/samples/sample-image.png&overlay_url=https://toolkitapi.io/static/samples/sample-watermark.png&mode=multiply&opacity=0.5"

import httpx

resp = httpx.get(
    "https://image.toolkitapi.io/v1/image/composite?base_url=https://toolkitapi.io/static/samples/sample-image.png&overlay_url=https://toolkitapi.io/static/samples/sample-watermark.png&mode=multiply&opacity=0.5",
)
print(resp.json())

const resp = await fetch("https://image.toolkitapi.io/v1/image/composite?base_url=https://toolkitapi.io/static/samples/sample-image.png&overlay_url=https://toolkitapi.io/static/samples/sample-watermark.png&mode=multiply&opacity=0.5", {
});
const data = await resp.json();
console.log(data);

# See curl example

Response 200 OK

{
  "image": "iVBORw0KGgoAAAANSUhEUg...(base64 data)...",
  "format": "png",
  "size": {"width": 1920, "height": 1080},
  "blend_mode": "multiply"
}

Try It Live

Live Demo

Response

Description

Blend two images together with configurable blend mode and opacity

How to Use

1

1. Provide the base image via `base_url` and the overlay via `overlay_url` query parameters.

2

2. Choose a `mode`: normal, multiply, screen, overlay, or add.

3

3. Set `opacity` (0.0–1.0) to control the overlay's visibility.

4

4. The overlay is automatically resized to match the base image dimensions.

About This Tool

Use the Image Composite endpoint to blend two images together using professional blend modes. The overlay image is resized to match the base image dimensions and composited with adjustable opacity.

Supported blend modes include normal (alpha composite), multiply, screen, overlay, and add — covering the most common Photoshop-style layer blending operations. This is essential for texture overlays, double exposures, and creative photo effects.

Why Use This Tool

Texture overlays — Apply paper, grain, or light-leak textures to photos
Double exposure — Create artistic double-exposure effects
Branding — Composite graphics and logos onto product images
Tinting — Apply colour overlays using screen or multiply modes
Creative effects — Combine images for artistic compositions

Frequently Asked Questions

How do the blend modes work?

**Normal**: standard alpha compositing. **Multiply**: darkens by multiplying pixel values. **Screen**: lightens (inverse of multiply). **Add**: adds pixel values for a brighter result. **Overlay**: 50/50 blend.

Is the overlay resized to match the base?

Yes, if the overlay dimensions differ from the base, it is resized using Lanczos resampling to match the base image size.

Can I position the overlay at specific coordinates?

Yes, use the `x` and `y` parameters to offset the overlay from the top-left corner of the base image.

Start using Image Composite now

Get your free API key and make your first request in under a minute.

Get Free API Key View Docs