AIDmi - AI, describe my image! logo
CKEditor5 toolbar showing AI, describe my image! button for content.
Example showing images for content.
Example of the AI, describe my image! button with a DrupalCon 2025 logo.
Example of AI, describe my image! providing text for image alt.
Example chart used in app to show ability to describe: A bar chart titled \"Disability\" that shows the number of people with different disabilities.The bars are ordered from highest to lowest.The bars represent: - Psychological: 1389 people- ADD/ADHD: 748 people - Chronic Systemic Conditions: 349 people- Learning Disabled: 237 people- Other: 209 people- Mobility: 150 people- Autism/Asperger/PDD: 140 people- Not Listed: 60 people- Acquired Brain Injury: 48 people - Low Vision: 25 people- Multiple: 25 people
Example showing alt text for graph.

AIDmi - AI, describe my image!

See it in action on YouTube!

AIDmi leverages AI to generate comprehensive image accessibility text. From the toolbar, the "AI, describe my image!" button will evaluate all images within the content, including Media images, and provide appropriate alt text descriptions. You can make changes to the suggested text prior to selecting and inserting the test into the image alt tag.

For individual image uploads (not Media), a button is placed next to the CKEditor 5 Alternative Text box. Clicking this button sends the selected image to the AI for description generation.

Currently, only the Gemini AI is available due to its ability to provide detailed descriptions through its API.

How much does Gemini AI cost?

Please review the cost information provided by Google [here](https://ai.google.dev/pricing). There is a free tier suitable for smaller implementations, but it will be used to train the AI. The pay-as-you-go plan does not contribute to AI training.

**Protect your API Key!** It is recommended to limit usage to specific IPs through Google API configuration.

Installation and Configuration

Select API:

Currently, only Google Gemini is supported. Additional AI services may be integrated in the future based on their output quality and integration feasibility.

Select Model:

Currently, only Gemini 1.5 Flash is supported. Others had some issues providing the same image detail. Still making this part of configuration for future changes and new models.

Gemini API Key

Set the API Key under Configuration > Web services > AIDmi Settings. More information can be found [here](https://ai.google.dev/gemini-api/docs/api-key).

API Key Input Method

- **API Key in Settings (Testing Only)**: Directly add the API key in Drupal settings. This method is not recommended for production environments.
- **File Path (Recommended)**: Specify the path to a text file containing your API key. It's recommended to place this file outside of your root directory. For example, if your web root is `web/`, you should use `/../` to indicate a path outside of this directory.

API Instructions:

This setting allows you to customize the instructions provided to the AI for generating alt text. The current default works well for most cases.

How Does It Work?

In CKEditor, you will see a link labeled "AI, describe my image!" next to the Alternative Text box. Clicking this link will generate a description and display a preview. If you accept the description, it will be inserted into the Alternative Text box.

Add "AI, describe my image!" button to the CKEditor 5 Toolbar

Go to: Configuration > Content authoring > Text formats and editors

From there, you can select Configure on each CKEditor5 toolbar and add the "AI, describe my image!" button. This is the button that will review your entire piece of content and evaluate all images.

Future Plans

Long form detailed description ability optionally attached to an image.
 
Additional AI services may be incorporated based on their ability to provide comprehensive descriptions beyond simple OCR capabilities.

Project information

Releases