WordPress 7.0: Cliente IA nativo para generar imágenes desde la biblioteca de medios
WordPress 7.0 incluye un Cliente IA integrado en el núcleo. Es una API en PHP que permite a cualquier plugin enviar prompts a proveedores de inteligencia artificial y recibir los resultados directamente. Hasta hace poco, quienes querían añadir capacidades de generación de imágenes en WordPress dependían de servicios externos o integraciones complicadas. Ahora eso cambia, y la buena noticia es que ya existe documentación oficial con un ejemplo funcional.
Un detalle importante antes de seguir: el núcleo de WordPress no incluye ningún proveedor por defecto. La conexión a OpenAI, Google AI o Anthropic se instala como un plugin proveedor separado. El Cliente IA es la interfaz común; los plugins proveedores aportan la implementación concreta.
Cómo funciona el Cliente IA de WordPress
Lo primero que hay que entender es que tu plugin nunca se comunica directamente con un proveedor de IA. En lugar de eso, describes qué necesitas (texto, una imagen, un formato de salida específico) y cómo lo necesitas (proporción de aspecto para imágenes, temperatura para generación de texto, etc.). Con esa información, WordPress redirige la petición a un modelo adecuado del proveedor que el administrador del sitio tenga configurado.
Esto tiene implicaciones prácticas importantes. Los propietarios de sitios eligen su proveedor (Anthropic, Google, OpenAI u otro soportado) y gestionan las claves API desde Ajustes > Conectores, una pantalla centralizada que elimina la necesidad de que cada plugin tenga su propia página de configuración de credenciales. Los plugins son portables: uno que funciona con un proveedor funciona con todos. Y cuando nuevos proveedores o modelos estén disponibles, los plugins existentes ganarán soporte automáticamente sin actualizaciones.
La interfaz principal es una sola función: wp_ai_client_prompt(). Esta devuelve un objeto WP_AI_Client_Prompt_Builder con métodos que siguen las convenciones de WordPress (snake_case). Desde ahí puedes encadenar métodos para describir tu prompt. Por ejemplo, para generar una imagen indicas el texto del prompt, el tipo de archivo de salida (base64-encoded inline), y opcionalmente la orientación (square, landscape o portrait).
El sistema de preferencias de modelos permite sugerir modelos ideales sin forzarlos. Puedes llamar using_model_preference() con una lista de modelos preferidos y WordPress los intentará en orden, cayendo atrás a modelos compatibles si los preferidos no están disponibles. Tu plugin sigue funcionando sin importar cuál modelo haya disponible.
Antes de mostrar cualquier funcionalidad de IA a los usuarios, es obligatorio verificar si el proveedor configurado realmente soporta lo que necesitas. El método is_supported_for_image_generation() devuelve true solo cuando hay un proveedor configurado con un modelo que soporte generación de imágenes. Esta verificación no hace llamadas a la API ni incurre en costes.
Un caso de uso concreto: plugin de generación de imágenes en la biblioteca de medios
El blog oficial de desarrollo de WordPress publica un plugin de ejemplo funcional que añade un botón "Generar archivo de imagen" directamente en la Media Library. El flujo es simple: el usuario hace clic en el botón, escribe un prompt de texto, el plugin envía ese prompt al Cliente IA, muestra la imagen generada como vista previa, y permite guardarla como un attachment nuevo en la biblioteca de medios.
La arquitectura del plugin separa responsabilidades. El archivo principal plugin.php verifica que el Cliente IA exista y carga tres archivos incluidos: prompt.php con las funciones reutilizables para construir los prompts del Cliente IA, rest-api.php con los endpoints REST para generar la imagen y para subirla a la Media Library, y admin.php que gestiona el registro y carga condicional de los scripts del frontend.
El archivo prompt.php define una función que configura el builder para generación de imágenes. Devuelve el builder en lugar del resultado, lo que permite que el mismo código se reuse tanto para hacer la petición real como para hacer la verificación de soporte. No se especifica proveedor ni modelo, solo se describe qué se necesita y WordPress se encarga del resto.
Los endpoints REST son dos: uno para generar la imagen y otro para guardarla en la Media Library. Separarlos tiene sentido porque permite al usuario revisar la imagen generada antes de comprometerla. El endpoint de generación toma el prompt y la orientación opcional, llama generate_image_result() y devuelve el resultado directamente. El de subida decodifica la imagen base64, la escribe a disco con wp_upload_bits(), crea el attachment con wp_insert_attachment() y genera los metadatos con wp_generate_attachment_metadata().
En el frontend, el script se carga de forma condicional solo en la pantalla de la Media Library (upload.php) y solo si el usuario tiene capacidad para subir archivos y el proveedor configurado soporta generación de imágenes. Esta triple verificación asegura que el botón "Generar imagen" solo aparezca cuando realmente funcionará.
El código fuente completo está disponible en GitHub en wptrainingteam/ai-client-imagegen. Los requisitos para probarlo son WordPress 7.0, un proveedor de IA configurado con soporte para generación de imágenes (desde Ajustes > Conectores), y Node.js versión 20 o superior para compilar los assets del frontend.
Qué significa esto para la comunidad Flowtitude
Si trabajas con Bricks Builder o extensiones de WooCommerce, este Cliente IA abre posibilidades concretas. Puedes generar imágenes de productos sin salir de tu entorno de administración. Un desarrollador de temas Bricks podría crear un bloque que genere imágenes de cabecera con prompts de texto. Una tienda WooCommerce podría generar imágenes de placeholder mientras carga fotos de productos reales, o crear variaciones de imágenes para tests A/B.
Lo más relevante es que toda la complejidad de comunicación con proveedores de IA, autenticación, selección de modelos y normalización de respuestas queda encapsulada detrás del Cliente IA. Tu plugin se enfoca en su propósito específico y la parte de IA es solo otra llamada a una API interna de WordPress.
El equipo de desarrollo espera que la comunidad explore el plugin de ejemplo y lo lleve más allá. Entre las ideas mencionadas están generar múltiples variaciones de imágenes para que el usuario elija su favorita, usar la capacidad de generación de texto del Cliente IA para crear nombres de archivo más descriptivos basándose en el contenido de la imagen, o integrar edición de imágenes existentes pasando una imagen actual como archivo adicional al prompt.
¿Quieres saber cómo podría mejorar tu flujo de trabajo este Cliente IA nativo en WordPress? ¿Hay alguna función específica de tu tienda online o sitio en Bricks donde veas potencial para integrar generación de imágenes con IA?
