Solución de problemas de las herramientas de imagen
Los problemas de las herramientas de imagen se dividen en tres grupos: la herramienta no está disponible, una operación fue rechazada o el resultado es inutilizable. Empieza por identificar cuál es.
La herramienta no está disponible
No hay ninguna entrada en Medios.
Comprueba que la herramienta esté activada en Settings → POM AI → AI Tools y que tu usuario tenga la capacidad upload_files. Las cuatro herramientas de imagen la requieren.
La pantalla se carga pero no muestra ninguna imagen.
La búsqueda de la mediateca no devolvió nada. Borra el campo de búsqueda y recorre las páginas — las imágenes sin título y sin texto alternativo son difíciles de encontrar mediante búsqueda, que es precisamente el conjunto para el que sirve la herramienta de metadatos.
La operación fue rechazada
Estos mensajes aparecen antes de que se realice cualquier trabajo y no se cobra nada.
| Mensaje | Causa | Solución |
|---|---|---|
| Please select at least one image | No se marcó nada | Selecciona una imagen |
| Please provide a description for your image | Indicación vacía en el generador | Escribe una indicación |
| The prompt cannot exceed N characters | Se superó el límite | Acórtala; el contador muestra la cantidad restante permitida |
| You cannot select more than 48 images in a single operation | Lote de metadatos demasiado grande | Divide el lote |
| You can select up to 3 reference images | Demasiadas referencias opcionales | Elimina una |
| Reference images must be 2 MB or smaller | Referencia demasiado grande | Usa un archivo más pequeño |
| Only valid image attachments can be used as references | No es un adjunto de imagen | Elige una imagen real |
| The final prompt for image #N cannot exceed N characters | Una indicación por imagen hizo que la indicación combinada superara el límite | Acorta la indicación adicional de esa imagen |
| WordPress media selector is not available on this screen | El selector de medios no se cargó | Recarga la página |
Fallos de créditos y de licencia
| Síntoma | Significado |
|---|---|
| El aviso de créditos dice que no se pudo determinar el saldo | No hay saldo almacenado; comprueba la pestaña License |
| Un mensaje de créditos insuficientes | Se alcanzó el saldo de la cuenta o un límite del dominio |
| Todas las operaciones fallan de inmediato | Licencia, autorización del dominio o conectividad |
Consulta Resuelve un error de créditos insuficientes y Soluciona los errores de licencia y dominio.
La operación comenzó y falló
Un error al calcular los créditos. La solicitud de estimación no se completó. Normalmente se debe a conectividad, a un proxy que elimina cabeceras o a un plugin de seguridad que bloquea admin-ajax.php. No se cobró nada.
Un error al generar. El servicio no pudo completar el trabajo. Reinténtalo una vez; si falla de forma constante con la misma entrada y funciona con otras, el problema es la entrada: prueba con una imagen de origen diferente o una indicación más sencilla.
Algunas imágenes no se pudieron procesar. Un lote terminó con fallos individuales. El resumen las nombra. Las imágenes que se procesaron correctamente se cobraron; los fallos no. Vuelve a ejecutar solo los fallos.
La ejecución parece colgarse. El trabajo con imágenes lleva tiempo, y los perfiles de mayor calidad tardan más. Observa el contador de segundos transcurridos en lugar de volver a enviar — un segundo envío es una segunda operación de pago.
El resultado es inutilizable
Artefactos en la imagen generada. Vuelve a generar con una indicación más específica o con un ajuste preestablecido de estilo distinto. Consulta Escribe una indicación de imagen útil.
La mejora cambió algo que no debería haber cambiado. Dilo explícitamente en la indicación: nombra lo que no debe cambiar.
Bordes de eliminación de fondo deficientes. Casi siempre es la imagen de origen. Una mayor resolución y un mejor contraste entre el sujeto y el fondo marcan más diferencia que cualquier ajuste. Considera un color de fondo sólido en lugar de transparencia. Consulta Comprueba una eliminación de fondo.
Metadatos incorrectos. La herramienta describe la apariencia sin conocer el contexto. Corrígelos a mano; consulta Escribe un texto alternativo que ayude.
El resultado es borroso o de baja calidad. Comprueba primero la resolución de origen y, después, compara con un modelo distinto o con una calidad de OpenAI superior para esa única imagen.
Después de una ejecución de sustitución
Falta una imagen en una página. Las causas probables, en orden: una URL escrita a mano en una plantilla u hoja de estilos, una página o un objeto de CDN en caché, una referencia almacenada en un formato no reconocido o una referencia en un sitio distinto de una red multisitio.
El original ha desaparecido y el resultado es malo. El original se eliminó de forma forzada; no hay deshacer en WordPress. Restáuralo desde la copia de seguridad. Por eso Sustituye el original o crea un adjunto nuevo recomienda aprender con entradas nuevas.
Problemas persistentes
Si los fallos son constantes en lugar de esporádicos, comprueba:
- el HTTPS saliente desde el servidor;
- el tiempo de ejecución de PHP y los límites de memoria, que afectan a las subidas grandes;
- que el directorio de subidas tenga permisos de escritura;
- cualquier plugin de seguridad que filtre
admin-ajax.phpo elimine las cabeceras de las solicitudes; - si la misma operación funciona con una imagen distinta.
Antes de contactar con el soporte
Reúne la URL del sitio, la versión de POM AI, la herramienta, los ajustes usados — estilo, modelo, resolución, calidad de OpenAI, proporción, opción de sustitución —, el número de imágenes seleccionadas, el mensaje exacto copiado y no parafraseado, la hora y si se reproduce.
Nunca envíes la clave de licencia. Consulta Actualizaciones, soporte y mantenimiento seguro.
Errores de modelo o resolución
Si un mensaje te pide que selecciones un modelo, resolución y calidad compatibles, recarga la herramienta y vuelve a seleccionar esas opciones. La anchura o altura máxima es de 2560 píxeles. Google 2K no está disponible en 9:16, 16:9 y 21:9; elige 1K para esas proporciones. Para OpenAI, lee las dimensiones exactas en píxeles y prueba una resolución menor si el tamaño seleccionado está marcado como experimental.
Si el modelo seleccionado no puede completar una solicitud, comprueba el resumen del procesamiento y el historial de créditos antes de volver a intentarlo. Contacta con el soporte si la misma elección sigue fallando, incluyendo el modelo, la resolución y la calidad.