New users get free credits - no credit card required Get started
APIAny logoAPIAny

Join Images

Join up to 20 images horizontally or vertically with optional spacing.

POST /api/free/join-images

Use Join Images online

Upload, configure, preview and download without an API key.

No sign-in or API key

1. Upload and settings

Use this tool online without an API key. Files are sent only when you run the request.

Image files *
Direction
Gap
Background color
Output format
Complete the required fields to run the tool.POST /api/free-online/join-images

2. Preview and download

Your result will appear here

Preview, size changes and download controls are shown here

Integrate with the API

Only programmatic calls require an API key. Parameters, responses and errors are documented below.

API endpoint
POST /api/free/join-images

Online use is keyless. Programmatic calls to this endpoint require an APIAny key.

How it works
  • Images are aligned without upscaling.
  • The final canvas is limited to 8192 pixels per side.

Response

A successful request returns a image response with the Content-Type described by this page.

Common errors

400
A file or parameter is missing, invalid or outside the documented limit.
401
The API key is missing, invalid or disabled for programmatic API calls.
429
The online or authenticated shared rate limit has been reached.

Parameters and limits

ParameterRequirementDefaultAccepted values
filesImage filesRequired—file
directionDirectionOptionalhorizontalhorizontal, vertical
gapGapOptional0number
backgroundBackground colorOptional#fffffftext
formatOutput formatOptionalwebpwebp, png, jpeg

API example

Use this authenticated example in code. The online Playground above intentionally does not request or expose your key.

curl -X POST "https://apiany.ai/api/free/join-images" \
  -H "Authorization: Bearer $API_KEY" \
  -F "files=@a.png" \
  -F "files=@b.png" \
  -F "direction=horizontal" \
  --output joined.webp

Frequently asked questions

Do I need an API key for Join Images?

No key is required in the online Playground. Programmatic requests use Authorization: Bearer or X-API-Key.

What are the limits for Join Images?

Online use is limited to 3 requests per minute and 30 per day. Authenticated free accounts receive 5 RPM and paid accounts receive 500 RPM across free APIs.

Which inputs does Join Images accept?

Use the required and optional fields in the parameter table. Unsupported formats and out-of-range values are rejected.

What does Join Images return?

Successful requests return a image response. Errors use the HTTP status codes listed above.

Source: APIAny free API catalog and live route behavior. Content reviewed 2026-07-17.