Changelog
User-facing changes to the Akator Image Matcher API. Internal-only releases (monitoring, tooling, dependencies, deployment) are omitted, so version numbers may skip.
v1.4.1
patch 2026-10-31- Unknown routes (404), unsupported methods (405) and rejected form data (400) now return the standard error format instead of {"detail": ...}
- Match results are now reproducible: the same request against the same collection returns the same matches in the same order
- Image download: a missing image file now returns 404 instead of an incomplete response, and storage outages return 503 with a Retry-After header
- Some error messages for image storage failures have new wording; status codes and the error format are unchanged
- Image metadata: the two deprecated fields now always return null
- The API root (GET /) now returns only status, version and documentation_url
v1.4.0
minor 2026-10-30- Fixed HTTP 500 errors on Match when a hit had to be verified; these matches are returned again
- A single unreadable candidate image no longer fails the whole match
- Match: the default min_ssim_score is now 0.6 (was 0.5); requests that set min_ssim_score explicitly are not affected
- Storage outages now return 503 with a Retry-After header instead of 500; short interruptions are retried automatically
- Image URLs (Compare and upload by URL) that point to private or internal network addresses are now rejected with 400
- Updated image-decoding libraries, including security fixes
- Image metadata: two internal fields are deprecated and will be removed in API v2.0
- URL-encoded form fields larger than 1 MB are now rejected with 400; file uploads are not affected
- Faster matching on large collections
v1.3.0
minor 2026-07-15- JPEG 2000 uploads are now supported; HEIC/HEIF and JPEG XL uploads that previously failed now work
- Unsupported formats (RAW, EPS, SVG) are rejected with a clear "Unsupported image format" message
- Compare: error responses now use the same error format as all other endpoints (breaking change: read "error" instead of "detail")
- The original creation date is now read correctly from the image EXIF data
- More stable service under sustained load
v1.2.18
patch 2026-06-08- Compare now detects horizontally mirrored images
- Upload size limit raised to 25 MB
- Under heavy load the API now returns 503 with a Retry-After header instead of 500, so clients can back off and retry
- Oversized uploads to Compare now return 413 (Payload Too Large) instead of 400
- Fixed several cases that could return HTTP 500: very low-detail reference images (solid colours, simple logos), the first request from certain email addresses, and match scores that could exceed 100%
- Collection timestamps (created_at, updated_at) are now valid ISO 8601
v1.2.17
patch 2026-04-20- Fixed 502 Bad Gateway errors on the Match endpoint under concurrent load
v1.2.15
patch 2026-02-24- Fixed an error when deleting certain older images
- Faster matching: non-matching candidates are now rejected earlier in the pipeline
v1.2.10
patch 2026-01-09- Fixed match results that could fail for crops and partial overlaps (matched region extending beyond the image bounds)
- Cleaner error responses: internal stack traces are no longer exposed, and each error carries a request ID
- Faster matching through pipeline optimizations
v1.2.9
patch 2026-01-06- Fixed image upload by URL when the remote server does not support HEAD requests
v1.2.8
patch 2025-12-11- Fixed Compare failing for non-square images
v1.2.0
minor 2025-12-10- API v1.1: every response now includes a request_id for easier support and tracing
- New standardized error format (structured errors with code, message and field)
- Compare: response status changed from "ok" to "success" (breaking change)
- Faster matching via new caching layers
- Expanded, more detailed API documentation
v1.1.0
minor 2025-05-30- More reliable Compare results when only a few matching features are found
- Clearer error message for corrupted PNG uploads
v1.0.0
major 2024-12-12- Initial release
- Match images against your own collections — even after resize, crop, rotation, mirroring, recompression and colour changes
- Compare two images directly
- Organize reported images in collections
- Real-time matching for upload screening
- Hosted in Germany, GDPR-compliant
Stay Updated
For the latest updates and announcements, contact us at info@akator.de to subscribe to our changelog notifications.