AI Alt Text

Texto alternativo generado por IA para la biblioteca de medios mediante API cloud gestionada, sin clave API propia.

¿Qué es AI Alt Text?

Sugiere alt para imágenes raster (PNG, JPEG, WebP, GIF). Las peticiones pasan por el proxy cloud de EZZE. No admite SVG. No sustituye la revisión humana, no detecta automáticamente si una imagen es decorativa ni marca «generado por IA».

Por qué usarlo

• Accesibilidad: El texto alternativo es esencial para quien usa lectores de pantalla
• Alineación WCAG: Apoya el criterio de éxito 1.1.1 (contenido no textual)
• SEO: Las imágenes descritas ayudan a los buscadores a entender el contenido
• Eficiencia: Menos escritura manual en bibliotecas grandes
• Coherencia: Tono y estructura más uniformes entre imágenes

Criterios WCAG relacionados

• 1.1.1 Contenido no textual: El contenido no textual necesita una alternativa en texto.
• 1.4.5 Imágenes de texto: La IA puede ayudar a describir texto incrustado en imágenes cuando aún no hay alternativas solo en texto.

Límites

• Free: 25 generaciones (puntual, no mensual) Free
• desde Basic: 50/mes desde Basic
• desde Plus: 100/mes desde Plus
• desde Premium/Agency: 1.000/mes desde Premium

Requisitos

1. Conexión gratuita de Funciones Cloud. Hasta que finalice la activación, la página de ajustes muestra solo una tarjeta de configuración con el contingente incluido y un enlace que abre el panel de Funciones Cloud en el Dashboard. Una confirmación por correo pendiente se muestra como un estado independiente.
2. Confirmación del tratamiento externo (obligatoria antes del interruptor principal)
3. Activar AI Alt Text. Desactivar la función no revoca la confirmación.

La confirmación, el interruptor de la función, los ajustes dependientes y las acciones de guardar o restaurar aparecen solo cuando la conexión de Funciones Cloud está lista.

Ajustes (pestaña Settings)

Confirmación: después de guardar, la tarjeta de estado muestra la fecha, la hora y el usuario de WordPress que confirmó el tratamiento externo. Las confirmaciones anteriores al historial permanecen válidas y se identifican como históricas sin inventar una fecha. Revocar confirmación prepara la revocación; al guardar se desactiva AI Alt Text y se elimina la referencia de confirmación.

Medios: un único selector permite elegir entre solo contenido publicado (recomendado, menor riesgo) y todas las imágenes de la biblioteca de medios (mayor riesgo). El flujo tras la subida puede omitir el filtro de publicados, pero solo se inicia cuando seleccionas exactamente una imagen para subir; las selecciones múltiples se ignoran.

Generales: botón en biblioteca; generar tras subir una sola imagen (desde Basic; pregunta o automático); idioma; longitud min/máx; contexto (título, descripción, pie, archivo — también AI Image Review).

Permisos: Free = solo administradores; desde Basic = roles con upload_files (+ edit_post en el adjunto).

Lote: desde Basic; procesamiento secuencial en el navegador (no cron).

Los ajustes dependientes se ocultan cuando el interruptor principal está desactivado. Ayuda abre un panel lateral en escritorio y una hoja inferior accesible en móvil.

Propósito de la imagen en la biblioteca de medios

Cada imagen tiene uno de tres estados editoriales:

• Descrita: El texto alternativo de la biblioteca de medios tiene contenido.
• Revisada como decorativa: El texto alternativo permanece vacío de forma intencionada y se ha confirmado su propósito.
• Pendiente: El texto alternativo está vacío y todavía no se ha confirmado un propósito decorativo.

Abre los detalles del adjunto y activa Marcar como decorativa directamente en la tarjeta AI Alt Text, o usa la misma acción en el menú de tres puntos de una fila de Batch. Una imagen decorativa debe conservar vacío el texto alternativo. Mientras la marca esté activa, la tarjeta sustituye la cuota y la generación de propuestas por un estado claro y la acción Quitar marca decorativa; el campo de texto alternativo también permanece desactivado. Una descripción existente solo se borra tras una confirmación explícita. Las imágenes revisadas como decorativas se excluyen del filtro de pendientes y de la generación por lotes, pero siguen disponibles mediante el filtro Revisada como decorativa, con su estado y la acción para retirar la marca; al retirarla vuelven a quedar pendientes.

La marca describe el valor editorial predeterminado de la biblioteca, no todos los usos del archivo. Un bloque concreto puede seguir proporcionando su propio texto alternativo. Tampoco oculta hallazgos de la prueba de accesibilidad, que evalúa por separado el HTML realmente mostrado en cada página.

Aunque abras la biblioteca de medios desde una entrada, esta marca se aplica al adjunto y borra su texto alternativo tras la confirmación. Los bloques Imagen existentes no cambian. Para que solo un bloque sea decorativo, selecciónalo en el editor y activa su opción Marcar como decorativa.

Generar texto alternativo en el bloque Imagen de WordPress

Selecciona el bloque nativo Imagen (core/image) en el editor de bloques y abre AI Alt Text en la barra lateral de ajustes del bloque. También funciona con los bloques Imagen individuales de una Galería.

1. Selecciona una imagen de la biblioteca de medios y elige Generar sugerencia.
2. Revisa y edita la sugerencia según el uso de la imagen en esta página.
3. Elige Aplicar sugerencia y guarda la entrada o la plantilla. Descartar conserva el texto actual; puedes revertir una aplicación con Deshacer de WordPress.

Solo se modifica este bloque Imagen. La biblioteca de medios y los demás usos de la imagen no cambian. La función depende del interruptor principal de AI Alt Text y de los roles permitidos; la opción del botón de la biblioteca solo controla esa interfaz. Cada generación utiliza la cuota, el idioma de salida y la selección de imágenes configurados. Si solo se permite contenido publicado, pueden rechazarse imágenes usadas únicamente en borradores. No se transmite adicionalmente el texto de los bloques circundantes como contexto de la página.

Las imágenes externas requieren primero una entrada en la biblioteca. No se ofrece generación para bloques decorativos ni campos de imagen o texto alternativo conectados a fuentes de datos. Los errores conservan el texto actual y permiten reintentar. Cambiar la imagen descarta su sugerencia; las solicitudes ya iniciadas en el servidor pueden consumir cuota.

Cómo usarlo

La sección AI Alt Text empieza contraída. Ábrela debajo del campo de texto alternativo; mantiene su anchura, también en el selector de medios del editor de bloques. Marcar como decorativa muestra la nota Se aplica a la biblioteca de medios. El botón de información abre la explicación completa; vuelve a pulsarlo o pulsa Escape para cerrarla. El panel del bloque Imagen también empieza contraído y muestra la sugerencia y sus acciones después de generarla correctamente.

Imágenes sueltas:

• Abre la biblioteca de medios
• Selecciona una imagen
• Pulsa Generar sugerencia en la tarjeta situada justo debajo del campo de texto alternativo
• La sugerencia se muestra por separado y no sustituye el valor actual hasta que pulses Aplicar sugerencia. También puedes descartarla o generar otra
• Revisa el campo actualizado y guarda el adjunto antes de publicar

Después de subir una sola imagen (desde Basic):

• En el modo de consulta, la miniatura permanece visible y muestra una tarjeta compacta con Omitir y Generar; no se abre otra ventana emergente. Si la miniatura aún no está lista, la misma consulta aparece temporalmente como una barra flotante inferior
• En el modo automático, la misma miniatura muestra el progreso y una confirmación breve; el texto alternativo se guarda directamente en el adjunto
• Este flujo solo se inicia al seleccionar exactamente un archivo de imagen. Las selecciones múltiples se omiten

Lote:

• Abre AI Alt Text → Batch
• Filtra y ordena imágenes (propósito de alt pendiente, Revisada como decorativa, origen, tipo MIME, rango de fechas). Ordena por fecha de subida, nombre de archivo, longitud del texto alternativo o acción requerida. El filtro decorativo devuelve las imágenes marcadas a la lista con su distintivo y la acción para retirar la marca. En teléfonos, la selección múltiple se abre como una hoja inferior. Aplicar confirma el borrador; Cancelar, Cerrar, Escape, el fondo o deslizar hacia abajo lo descartan. Los filtros aplicados aparecen como chips que se pueden quitar individualmente encima de la lista de resultados.
• Lista y edición: Cada elemento muestra el texto alternativo actual como una vista previa compacta de dos líneas con estado (Falta el texto alternativo, Guardado, Cambio sin guardar, Sugerencia lista o Revisada como decorativa). Si no existe un texto alternativo guardado, la tarjeta ofrece directamente Generar sugerencia de IA; después de guardar un texto alternativo vuelve a aparecer Editar texto alternativo. En pantallas grandes, la acción de edición abre el editor en la fila; en teléfonos utiliza una hoja inferior. Listo conserva el cambio solo como borrador sin guardar hasta que lo guardes desde el menú de la fila o con la acción masiva. El botón de ayuda abre las mismas indicaciones como panel lateral u hoja inferior móvil.
• Selección y acciones: Seleccionar medios cargados se aplica a las filas visibles. Para generar, puedes ampliar expresamente la selección a todos los medios aptos del resultado filtrado sin cargar antes todas las tarjetas. Los medios decorativos o no aptos se cuentan, se identifican y se excluyen. La aprobación solo incluye propuestas existentes y el guardado manual solo borradores existentes. En teléfonos, un panel compacto en la parte inferior muestra la selección activa. Abrir acciones masivas abre cuando se necesita una hoja inferior con la acción, la cuota, el consumo previsto y Aplicar; no se abre automáticamente ni bloquea la selección de más medios. Cerrar, Escape, el fondo o deslizar hacia abajo conserva la selección existente.
• Genera sugerencias de IA, aprueba y guarda las sugerencias revisadas o guarda cambios manuales. La antigua acción directa de generar y guardar no está disponible en Batch para que el texto generado no pueda omitir la revisión.
• Cada sugerencia aparece en un panel editable independiente con el estado Sin guardar; el texto alternativo actual sigue visible y no cambia. Puedes descartar la sugerencia o elegir expresamente Aprobar y guardar. Los cambios manuales y las sugerencias sin guardar se conservan al filtrar o cargar más elementos en la pestaña actual; se pierden al recargar o salir después del aviso del navegador.
• Planificación de cuota: La barra de acciones masivas en pantallas grandes, o la hoja de acciones móvil, muestra conjuntamente la cuota de IA disponible, las imágenes seleccionadas y el consumo previsto. La generación permanece desactivada cuando la cuota restante conocida es menor que la selección; aprobar sugerencias y guardar cambios manuales no consume generaciones.
• Revisión de imagen y calidad: Abre una miniatura o elige Revisar imagen e historial para comparar una vista grande limitada con el texto alternativo actual. Los avisos conservadores marcan textos muy cortos, parecidos a nombres de archivo, con introducciones genéricas, duplicados o inusualmente largos. Son ayudas editoriales, no resultados WCAG automáticos.
• Historial local y deshacer: Las diez últimas versiones guardadas se conservan como metadatos privados del adjunto. El diálogo de detalle las carga solo al abrirse y permite restaurar cualquier versión. La restauración es reversible porque el valor actual sustituido pasa a ser la entrada más reciente del historial.
• El procesamiento es secuencial en el navegador. Un mensaje de progreso indica la posición y el medio. Al finalizar, un diálogo resume elementos correctos, fallidos y omitidos y permite reintentar solo los fallidos. Mantén la pestaña abierta; si se alcanza el límite, los elementos aún no procesados se muestran como omitidos.
• Usa el menú de tres puntos para marcar una imagen como decorativa o retirar la marca. Las imágenes decorativas revisadas no se incluyen en la selección ni en la generación.

Transferencia segura de imágenes

El proxy cloud descarga imágenes únicamente por HTTP/HTTPS, vuelve a validar los destinos DNS y cada redirección, y rechaza direcciones de red locales, privadas o reservadas. Cada imagen está limitada a 10 MiB y solo se acepta contenido detectado como JPEG, PNG, WebP o GIF. No se omiten errores de certificado ni tipos de archivo incompatibles.

Ejemplos

Ejemplo 1: Sitio nuevo con muchas imágenes

Filtra el lote por elementos sin texto alternativo, genera sugerencias de IA, revisa cada propuesta y después apruébala y guárdala de forma explícita. La longitud por defecto apunta a unos 80–140 caracteres (ajustable en los ajustes).

Ejemplo 2: Mejora continua

Genera desde la pantalla del adjunto cada vez que subes recursos nuevos para revisar cada imagen por separado.

Ejemplo 3: Contenido multilingüe

Si el idioma del sitio coincide con el del contenido, basta con “Coincidir con el idioma del sitio WordPress”. Con un plugin multilingüe o un idioma de contenido fijo, elige un idioma fijo en el desplegable —o cambia el idioma del sitio en WordPress antes de generar.

Consejos

• Revisa siempre la salida de la IA: ayuda pero puede equivocarse
• Ajusta mín./máx.; 80–140 caracteres suele funcionar bien en muchos diseños
• Prefiere “solo contenido publicado” cuando la privacidad importe
• Si alcanzas límites, sube de plan o espera al reinicio mensual
• No hay marca automática «generado por IA» en el HTML; revisa y guarda manualmente salvo modo automático tras subida
• Imágenes decorativas: deja el alt vacío y confirma su propósito en la biblioteca de medios

Nota: Requiere conexión Freemius y consentimiento de privacidad. Usa la API gestionada —sin clave personal.

Disponible para: Roles configurables (por defecto: administrador) Free