Generate Image Difference
Generate Image Difference is a documented APIAny Free API tool: try it in the browser, then call the same operation with an API key.
Generate a PNG heatmap that highlights pixel differences between two images.
POST /api/free/image-diffSources
Which official references does this page cite?
The quotations below are from official API documentation that APIAny implements against.
The Fetch API provides an interface for fetching resources (including across the network).
The typical use case for this high speed Node.js module is to convert large images in common formats to smaller, web-friendly JPEG, PNG, WebP and AVIF images of varying dimensions.
The Images API provides several endpoints that let you generate images from text prompts or create edits of existing images.
Use Generate Image Difference online
Upload, configure, preview and download without an API key.
1. Upload and settings
Use this tool online without an API key. Files are sent only when you run the request.
2. Preview and download
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.
POST /api/free/image-diffOnline use is keyless. Programmatic calls to this endpoint require an APIAny key.
- The second image is resized to the first image dimensions.
- Unchanged pixels are dark and larger differences appear brighter.
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
| Parameter | Requirement | Default | Accepted values |
|---|---|---|---|
imageAFirst image | Required | — | file |
imageBSecond image | Required | — | file |
thresholdDifference threshold | Optional | 16 | number |
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/image-diff" \ -H "Authorization: Bearer $API_KEY" \ -F "imageA=@a.png" \ -F "imageB=@b.png" \ --output diff.png
Frequently asked questions
Do I need an API key for Generate Image Difference?
No key is required in the online Playground. Programmatic requests use Authorization: Bearer or X-API-Key.
What are the limits for Generate Image Difference?
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 Generate Image Difference accept?
Use the required and optional fields in the parameter table. Unsupported formats and out-of-range values are rejected.
What does Generate Image Difference return?
Successful requests return a image response. Errors use the HTTP status codes listed above.