EyeQuant image analyses require images in a specific format and within certain size limits to produce accurate predictions. Submitting an image that falls outside these boundaries is likely to result in an error or unreliable results, so it is worth validating your images before sending them to the API.
To be accepted for analysis, your image must meet all of the following criteria:
- Format: PNG or JPEG
- File size: 5 MB or less
- Minimum dimension: 40px on the shortest side
- Maximum dimension: 2000px on the longest side
PNG is strongly recommended over JPEG. Lossy JPEG compression can introduce visual artifacts that affect prediction accuracy. Where you have the choice, always supply a PNG.
What Happens If Limits Are Exceeded
If your image falls outside these criteria, EyeQuant’s predictions are unlikely to be accurate. The API will return an error rather than silently produce unreliable results. If your use case requires images that don’t fit within these limits — for example, very large or very small canvases — contact EyeQuant to discuss your specific requirements.
For the full list of image-related error codes, including unreadable_input_image, invalid_input_image_dimensions, and blank_input_image, see the Errors reference.
Web Page URL Screenshots
These format limits apply to directly uploaded images using type: image. When you use type: webPageUrl, the screenshot is captured by EyeQuant’s own screenshot service, which handles sizing and format internally — you do not need to manage image dimensions yourself in that case. 