Programmable Media

Accessibility analysis

Last updated: Apr-18-2024

Analyzing your images for accessibility can help you to choose the best images for people with color blindness.

Important
Accessibility analysis is currently in Beta. Some implementation details may change before the official release. If you have a paid account, you can request to take part in the Beta trial. We invite you to share any feedback via our support team.

You can request accessibility analysis while uploading an image, or by using the explicit method on an already uploaded image.

Accessibility analysis while uploading

You can request accessibility analysis while uploading by specifying the accessibility_analysis parameter in the upload method.

For example, uploading the "user_photo.jpg" image and requesting accessibility analysis:

Accessibility analysis on already uploaded images

You can request quality analysis after uploading by specifying the accessibility_analysis parameter in the explicit method.

For example, requesting accessibility analysis on the image with a public ID of "user1":

Tip
You can also use the Update details of an existing resource method of the Admin API to update uploaded assets. Admin API methods require your API key and secret, so they shouldn't be used in client-side code. They're also rate-limited, so should only be used in server-side code where you're managing bulk assets.

Sample response

  • distinct_edges is a score between 0 and 1. A low score indicates that there are parts of the image that may be camouflaged to people with color blind conditions. For example, in this image, the grasshopper appears camouflaged to people with the color blind condition, deuteranopia:
Red flower with green grasshopper "distinct_edges": 0 Grasshopper camouflaged when simulating color blind condition Deuteranopia simulation
  • distinct_colors is a score between 0 and 1. A low score indicates that there are colors that color blind people would find hard to differentiate between. In this example, the red and green slices of the pie chart appear the same to someone with deuteranopia:
Pie chart in red, green, blue and yellow "distinct_colors": 0.33 Red and green indistinguishable when simulating color blind condition Deuteranopia simulation
  • most_indistinct_pair shows the two colors (in RGB hex format) that color blind people would find the hardest to tell apart.
  • colorblind_accessibility_score is an overall score, taking each of the components into account.

The accessibility_analysis.colorblind_accessibility_score field can be used in the search method when accessibility_analysis is set to true, in the upload request or an upload preset. Note that this score is not indexed for search when returned as part of an explicit request.

✔️ Feedback sent!

Rate this page: