Merge / Stitch Images API
Join images horizontally, vertically or in a grid with spacing and a background.
Environment
| Environment | Base URL |
|---|---|
| Production | https://api.sadafiles.com/v1 |
There is one environment and no sandbox, so every request here is real and counts toward your limits.
Request
POSThttps://api.sadafiles.com/v1/tools/merge-images
- Content type
- multipart/form-data
- Auth
- X-API-Key with tools:run
- Accepts
- jpg, png, webp, avif, gif, bmp, tiff, heic and 1 more
- Files per request
- 1 to 500
- Largest file
- 2 GB
- Job timeout
- 120 s
- Rate weight
- 2 units
Parameters
Send these as a JSON string in the options form field. Anything else is rejected.
| Name | Type | Default | Allowed |
|---|---|---|---|
direction | string | vertical | horizontal, vertical, grid |
columns | integer | 2 | min 1, max 12 |
gap | integer | 0 | min 0, max 200, px |
background | string | #FFFFFF | — |
align | string | center | start, center, end |
Response
| Status | Body | When |
|---|---|---|
201 | same | The run finished within 60 seconds |
202 | Job summary JSON | Still running; poll the job |
4xx, 5xx | Error JSON | See error codes |
A file response carries X-Sada-Job and X-Sada-Expires-At. For long work, post to /v1/tools/merge-images/jobs instead. See jobs and webhooks.
Also runs on the device
In the web tool and apps, Merge / Stitch Images can run locally with no upload. The API always processes on the server.
Try it yourself!
Pick a file, set the options and run a real request with your key. The code follows your changes.