AI Image Alt Text
Genera texto alternativo para campos de imagen utilizando modelos de visión de IA, con soporte para generación manual y automática con salida adaptada al idioma.
ai_image_alt_text
Instalar
composer require 'drupal/ai_image_alt_text:^1.0'
Overview
El módulo AI Image Alt Text forma parte del ecosistema de módulos AI y permite la generación automática de texto alternativo compatible con estándares de accesibilidad para campos de imagen utilizando modelos de visión de IA. El módulo se integra perfectamente con el widget de campo de imagen de Drupal, añadiendo un botón "Generar con IA" que permite a los editores de contenido generar texto alternativo descriptivo con un solo clic.
El módulo admite un flujo de trabajo con intervención humana donde el texto alternativo generado puede ser revisado y editado antes de guardar. Detecta automáticamente el idioma de la entidad y genera el texto alternativo en el idioma correspondiente, lo que lo hace ideal para sitios multilingües. El prompt personalizable utiliza plantillas Twig para mayor flexibilidad, y las imágenes pueden ser preprocesadas usando estilos de imagen para optimizar costos y compatibilidad con los proveedores de IA.
Un submódulo opcional (AI Image Bulk Alt Text) proporciona una interfaz de procesamiento masivo para encontrar y corregir todas las imágenes sin texto alternativo en todo el sitio, facilitando la mejora del cumplimiento de accesibilidad para contenido existente.
Features
- Genera texto alternativo descriptivo para campos de imagen utilizando modelos de visión de IA (OpenAI, Anthropic, Fireworks AI, etc.)
- Flujo de trabajo con intervención humana mediante botón "Generar con IA" en los widgets de campo de imagen para revisión manual antes de guardar
- Generación automática de texto alternativo al subir imágenes con modo opcional de botón oculto
- Generación adaptada al idioma que produce texto alternativo en el idioma de la entidad para soporte multilingüe
- Prompt de IA personalizable utilizando plantillas Twig con tokens para el nombre del idioma de la entidad y el nombre del archivo
- Preprocesamiento configurable con estilos de imagen para optimizar la resolución y formato antes de enviar a la IA (reduce costos)
- Soporte para seleccionar un proveedor/modelo de IA específico o usar el modelo de visión predeterminado
- Submódulo de generación masiva de texto alternativo para encontrar y corregir todas las imágenes sin texto alternativo en todo el sitio
Use Cases
Flujo de trabajo del editor de contenido para nuevas imágenes
Cuando un editor de contenido sube una imagen a un artículo, ve un botón 'Generar con IA' junto al campo de texto alternativo. Al hacer clic, se envía la imagen al proveedor de IA configurado y se rellena el campo de texto alternativo con una descripción descriptiva y compatible con accesibilidad. El editor puede revisar y modificar el texto antes de guardar el contenido.
Texto alternativo automatizado para sitios de alto volumen
Para sitios con muchas imágenes siendo subidas, los administradores pueden habilitar 'Generar automáticamente al subir' en la configuración. Esto genera automáticamente texto alternativo cuando se suben imágenes, opcionalmente ocultando el botón de generación. Los editores solo necesitan revisar el texto generado.
Generación de texto alternativo multilingüe
Al editar contenido en diferentes idiomas (por ejemplo, traducciones en alemán o francés), el módulo detecta automáticamente el idioma de la entidad e instruye a la IA para generar texto alternativo en ese idioma, asegurando una localización adecuada del contenido de accesibilidad.
Remediación masiva de accesibilidad
Para sitios existentes con muchas imágenes sin texto alternativo, los administradores pueden habilitar el submódulo AI Image Bulk Alt Text, navegar a /admin/config/media/ai_image_bulk_alt_text y usar el botón 'Generación masiva de texto alternativo con IA' para generar sugerencias para hasta 50 imágenes a la vez. Pueden revisar cada sugerencia, hacer ediciones y guardar todos los cambios juntos.
Prompt personalizado para consistencia de marca
Las organizaciones con directrices específicas de texto alternativo pueden personalizar el prompt de IA en la configuración para aplicar la voz de la marca, incluir terminología específica o seguir estándares de accesibilidad más allá de los predeterminados. Las plantillas Twig permiten incluir contenido dinámico como el nombre del archivo de imagen en los prompts.
Tips
- Usar un estilo de imagen (como el predeterminado 'AI Image Alt Text') para reducir la resolución de la imagen antes de enviarla a la IA - esto reduce significativamente los costos de API mientras mantiene buena calidad de texto alternativo
- Personalizar el prompt predeterminado para que coincida con las directrices de accesibilidad o la voz de marca de tu organización
- Para sitios multilingües, el módulo genera automáticamente texto alternativo en el idioma de la entidad - asegúrate de que tu proveedor de IA soporte los idiomas que necesitas
- Revisar el texto alternativo generado antes de guardar, ya que la IA puede ocasionalmente malinterpretar imágenes complejas o ambiguas
- El submódulo de generación masiva procesa las imágenes secuencialmente para evitar sobrecargar al proveedor de IA - permitir tiempo para lotes grandes
- Considerar habilitar la generación automática para roles de usuario que suben imágenes frecuentemente pero pueden olvidar añadir texto alternativo
Technical Details
Admin Pages 2
/admin/config/ai/ai_image_alt_text
Configura cómo se genera el texto alternativo para imágenes utilizando IA. Esta página permite personalizar el prompt enviado a la IA, seleccionar opciones de preprocesamiento de imágenes, elegir qué modelo de IA usar y configurar el comportamiento de generación automática.
/admin/config/media/ai_image_bulk_alt_text
Encuentra y corrige todas las imágenes en el sitio que no tienen texto alternativo. Muestra una tabla de hasta 50 imágenes sin texto alternativo, permitiendo generar texto alternativo individualmente o en masa, revisar las sugerencias y guardar los cambios.
Permisos 2
Hooks 1
hook_field_widget_single_element_form_alter
Modifica los widgets de campo de imagen para añadir el botón 'Generar con IA' y adjuntar el JavaScript necesario. Solo se aplica a instancias de ImageWidget con el campo alt habilitado.
Troubleshooting 5
Verificar que el usuario tiene el permiso 'Generate AI Alt Tags', que el campo alt está habilitado para la configuración del campo de imagen, y que hay un proveedor de IA funcional con capacidad de visión de imágenes configurado (ya sea en la configuración de AI Image Alt Text o como predeterminado en el módulo AI).
Navegar a /admin/config/ai/ai_image_alt_text y seleccionar un proveedor/modelo de IA específico, o configurar un proveedor predeterminado 'Chat with Image Vision' en la configuración del módulo AI en /admin/config/ai.
Verificar que el proveedor de IA seleccionado soporta visión de imágenes y está configurado correctamente con credenciales de API válidas. Algunos proveedores tienen limitaciones de tamaño o formato; intentar usar un estilo de imagen para reducir la resolución.
El módulo utiliza el idioma de la entidad para la generación. Asegurarse de que el contenido se está editando en la variante de idioma correcta. El idioma se pasa al prompt de IA mediante el token {{ entity_lang_name }}.
Esto significa que todos los campos de imagen con texto alternativo habilitado en todo el contenido ya tienen texto alternativo rellenado. La página solo muestra imágenes donde el campo alt está vacío.
Security Notes 3
- Los archivos de imagen se envían a proveedores de IA externos para su análisis - asegúrate de que esto sea aceptable para tu contenido y requisitos de privacidad
- El endpoint de generación (/admin/config/ai/ai_image_alt_text/generate/{file}/{lang_code}) está protegido por el permiso 'generate ai alt tags'
- El acceso a archivos se verifica antes del procesamiento - los usuarios solo pueden generar texto alternativo para archivos que tienen permiso de ver