Link Search Menu Expand Document

Duplicate image detection

Learn how we protect your image quota from endless loops and bugs.

What happens if I create the same image multiple times?

The API will automatically detect if an API key is creating the same image repeatedly within a short time period. When this happens, a new image will not be created and you will get back the URL to the existing image.

  • This protects you from accidentally using up your image quota due to a bug in a script or abuse from a user/robot.

  • We use the entire payload sent to the API to determine duplicates. If there a single character difference between images, it will not be considered a duplicate.


This feature should not be relied on for stopping the creation of duplicate images. Duplicate detection happens on our Edge CDN. This means it is geographically dependent. If you create identical images from servers in two different locations, we won’t be able to detect that they are the same.

URL Images

Duplicate image detection is not enabled for images created from a URL. It only works for images generated with the html parameter.

Need help?

Talk to a human. Please email us with any questions and we’ll gladly help you get started.

Back to top

Built with extensive integration tests and serious care for developer happiness.
© 2018-2024 Code Happy, LLC.

Page last modified: Apr 9 2024 at 11:04 PM.

Edit this page on GitHub.