El plugin Vercel WordPress es la primera solución que conecta la API de IA nativa de WordPress 7.0 con más de 100 modelos de 40 proveedores distintos, todo desde una sola clave y sin tocar código cada vez que quieres cambiar de modelo. No es un chatbot más. Es la infraestructura que cambia cómo cualquier web puede usar la inteligencia artificial: atención al cliente con memoria real, marketing automatizado con contexto de negocio y agentes que detectan intenciones y ejecutan acciones.
¿Qué es el plugin Vercel WordPress?
WordPress 7.0 lanzó algo que poca gente notó: una API de IA nativa llamada wp_ai_client. Es decir, WordPress tiene ahora un sistema interno para que cualquier plugin hable con modelos de inteligencia artificial de forma estandarizada.
El plugin de Vercel se conecta directamente a esa API. Una vez instalado, cualquier plugin de WordPress compatible puede usar automáticamente más de 100 modelos de IA de más de 40 proveedores distintos, con una sola clave.
Diagrama · Arquitectura del gateway
Tu web WordPress
↓
wp_ai_client ← API nativa de WP 7.0
↓
Plugin Vercel AI Gateway ← modelos, costes, seguridad, logs, fallbacks
↓
GPT-4o / Claude / Gemini / DeepSeek / Mistral / ...
↓
Respuesta al usuario
Sin el plugin, cada proveedor de IA tiene su propia API, su propio formato, sus propias claves. Cada vez que quieres añadir un modelo nuevo o cambiar de proveedor, hay que retocar código. Con el gateway, cambias el modelo desde un panel, sin tocar nada.
El 22,2% de las peticiones al AI Gateway terminan con una acción automatizada — reservar, enviar, actualizar. Hace solo 6 meses era el 11,4%. El uso agéntico se ha duplicado en medio año.
Por qué es diferente a instalar un plugin de chatbot
La mayoría de plugins de chat con IA que encuentras en WordPress hacen una sola cosa: conectan con GPT-3 o GPT-4 y ya. Funcionan, pero tienen límites muy claros.
| Característica | Plugin chatbot típico | Vercel AI Gateway + WordPress |
|---|---|---|
| Modelos disponibles | Un solo modelo (generalmente GPT) | 100+ modelos de 40+ proveedores |
| Seguridad API | Clave expuesta en WordPress | Claves protegidas en el gateway |
| Control de costes | Sin control ni límites | Panel unificado de costes |
| Streaming | Respuestas lentas, sin streaming | Streaming real como ChatGPT |
| Memoria | Sin memoria entre conversaciones | Configurable por sesión |
| Fiabilidad | Si el proveedor cae, el chat cae | Fallback automático entre modelos |
| Analíticas | Sin logs ni analíticas | Logs, métricas y trazabilidad |
| Contexto de respuesta | Genérico, sin contexto | Personalizado a tu negocio |
Lo que mucha gente hace mal
Instalan un plugin GPT, pegan una API key sin límites de gasto, no configuran ningún contexto de negocio y llaman a eso «chatbot IA». El resultado es caro, lento y con respuestas que no tienen nada que ver con su sector. No es culpa del modelo. Es culpa de la arquitectura.
Los tres niveles de integración: desde básico hasta agente
Nivel 1 — Chat básico funcional
Para la mayoría de webs, este nivel ya supone un salto enorme respecto a un formulario de contacto o un chatbot de botones predefinidos. Instalas el plugin, pegas tu API key de Vercel y configuras un prompt de sistema que define quién eres y cómo debe responder la IA.
Diagrama · Flujo de Nivel 1
Usuario escribe una pregunta
↓
Chat en tu web
↓
WordPress envía la pregunta al gateway
↓
El modelo responde con el contexto de tu negocio
↓
Respuesta aparece en streaming, palabra a palabra
El prompt de sistema es donde está la clave real. No es instalar, es configurar:
Texto · Prompt de sistema — Ejemplo
"Eres el asistente de [Nombre del negocio]. Responde siempre en español, tono profesional y cercano. Conoces estos servicios: [lista]. Estos precios orientativos: [lista]. Nunca inventes información. Si no sabes algo, di que lo consultarás. Al final de cada conversación, ofrece una primera consulta gratuita."
Tiempo de implementación: 2 a 4 horas. Coste mensual estimado: 10–30 € dependiendo del tráfico.
Nivel 2 — Sistema con memoria y contexto profundo
Aquí la diferencia empieza a ser notable. El asistente ya no responde preguntas sueltas: recuerda lo que el usuario ha dicho antes, conoce en profundidad los servicios y puede guiar la conversación hacia una acción concreta.
PHP · Nivel 2 — Selección de modelos
$result = wp_ai_client_prompt($mensaje_usuario)
->using_provider('ai_gateway')
->using_model_preference('claude-sonnet-4.6', 'gpt-4o', 'gemini-2.0-flash')
->generate_text();
Nivel 3 — Agente IA: ya no responde, actúa
Este es el nivel que cambia las reglas del juego. Un agente IA no solo responde preguntas: detecta la intención del usuario, decide qué hacer y ejecuta acciones reales. Según los datos de producción de Vercel, más de la mitad de todos los tokens procesados en el gateway corresponden ya a peticiones agénticas.
Diagrama · Flujo de Nivel 3 — Agente
Usuario: "Quiero una cita para la semana que viene"
↓
El agente detecta la intención: reserva de cita
↓
Llama a la API del sistema de citas
↓
Verifica disponibilidad en tiempo real
↓
Propone huecos disponibles al usuario
↓
Confirma la cita, envía email, actualiza CRM
↓
Todo sin intervención humana
Las acciones que puede ejecutar un agente conectado al gateway:
- Reservar citas en Google Calendar o sistemas propios
- Enviar emails o WhatsApp de confirmación
- Crear registros en el CRM
- Generar y enviar PDFs: presupuestos, consentimientos, informes
- Actualizar bases de datos internas
- Clasificar y derivar casos según urgencia
- Activar flujos de email marketing
Los agentes necesitan velocidad, fiabilidad y capacidad de elegir el modelo más adecuado para cada subtarea. Si el modelo principal falla, el fallback automático mantiene el agente funcionando. Sin el gateway, cada caída de proveedor significa que el agente se rompe.
El problema que nadie menciona: la memoria real de los agentes
Cuando se habla de agentes IA, todo el mundo se centra en qué pueden hacer. Pero hay una pieza que determina si el agente funciona de verdad a largo plazo: la memoria.
Sin memoria, el agente es amnésico. Cada conversación empieza desde cero. El paciente que habló hace tres semanas sobre un implante tiene que repetir todo. El asistente parece inteligente en la primera conversación y frustrante en la segunda.
El error más común en memoria de agentes
Guardar toda la conversación en un vector store plano y hacer búsqueda por similitud. El resultado es recuperación ciega: el agente encuentra fragmentos similares pero pierde el contexto de quién es el usuario, qué ha pasado antes y por qué importa.
La solución: memoria en capas, no en plano
Tencent acaba de publicar en abierto (licencia MIT) un sistema llamado TencentDB Agent Memory que resuelve exactamente este problema. El sistema organiza la memoria en cuatro niveles jerárquicos en lugar de un almacén plano:
Diagrama · Arquitectura de memoria en capas
L3 · Persona ← perfil del usuario: preferencias, historial, comportamiento habitual
↓
L2 · Escenario ← bloques de contexto: "consulta sobre implante de mayo 2026"
↓
L1 · Átomo ← hechos concretos: "tiene miedo al dentista", "falta muela inferior derecha"
↓
L0 · Conversación ← diálogo crudo, completo, archivado
El agente consulta primero L3. Si necesita más detalle, baja a L2 o L1. El diálogo completo solo se recupera cuando se necesita evidencia específica, evitando el contexto inflado.
Aplicado a los casos de uso del artículo, la diferencia es concreta
Escenario sin memoria: el paciente que tiene que repetirlo todo
Un paciente visita la web de una clínica en marzo. Pregunta por el precio de un implante, le da miedo la anestesia, pide información sobre sedación. El chat responde pero no guarda nada. Tres semanas después el paciente vuelve, ya más decidido. El asistente no recuerda nada. Vuelve a preguntarle de qué zona se trata, qué le preocupa, si tiene TAC. El paciente siente que habla con una máquina que no le escucha. Muchos cierran la pestaña en ese momento.
Escenario con memoria: el asistente que ya te conoce
El mismo paciente vuelve tres semanas después. El sistema ha guardado en su perfil L3 que tiene ansiedad al dentista, que preguntó por implantes en la zona inferior derecha y que el precio era su principal barrera. El asistente abre así: «Hola de nuevo. La última vez hablamos sobre el implante de la muela inferior. ¿Sigues pensando en ello o tienes alguna duda nueva?» El paciente no repite nada. La conversación avanza directamente hacia la decisión.
El segundo contacto de un usuario interesado convierte entre 3 y 5 veces más que el primero. Si el asistente trata ese segundo contacto como si fuera el primero, se pierde la oportunidad más valiosa del funnel.
Diferencia en el coste por conversación
Un sistema sin memoria eficiente carga el historial completo en cada petición para dar contexto al modelo, disparando el número de tokens. Con memoria en capas el sistema carga solo el resumen comprimido del perfil del usuario, no el diálogo completo. Según las evaluaciones propias de Tencent, la precisión de memoria de largo plazo sube del 48% al 76% y el consumo de tokens en sesiones largas cae más de un 60%.
Diferencia en la calidad de respuesta
Un modelo sin contexto del usuario responde de forma correcta pero genérica. Con el perfil del usuario cargado adapta cada respuesta a esa persona concreta. No cambia el modelo de IA, cambia la información que se le pasa. El mismo Claude o GPT-4o da respuestas radicalmente distintas con contexto de usuario que sin él.
Regla práctica
El 80% de la calidad de un asistente IA no depende del modelo elegido. Depende del contexto que se le pasa en cada petición. La memoria estructurada es la forma más eficiente de construir ese contexto.
Cómo conecta con Vercel AI Gateway
TencentDB Agent Memory se integra actualmente con OpenClaw y Hermes. Para un proyecto WordPress con Vercel AI Gateway la integración no es directa todavía, pero el concepto es aplicable: el gateway gestiona qué modelo responde y con qué velocidad, el sistema de memoria gestiona qué contexto se pasa a ese modelo en cada petición.
Nota importante
TencentDB Agent Memory es una herramienta de desarrollo, no un plugin de WordPress. Para la mayoría de proyectos el primer paso es construir una capa de memoria sencilla antes de plantearse una arquitectura de 4 niveles. Pero entender cómo funciona la memoria jerárquica marca la diferencia entre diseñar bien un sistema desde el principio o tener que rehacerlo después.
Vercel AI Gateway y la atención al cliente
La atención al cliente es el caso de uso más inmediato y con mayor retorno visible. Un formulario de contacto convierte mal porque obliga al usuario a esperar. Un chat con IA convierte mejor porque responde en el momento, a cualquier hora, con el contexto exacto de tu negocio. La diferencia real entre un chatbot básico y un sistema construido sobre Vercel AI Gateway está en tres cosas: contexto, memoria y acción.
Ejemplo real: clínica dental, 23:15h
Chat · Clínica dental — 23:15h
Usuario → Me duele una muela de atrás desde hace días.
Me da mucho miedo el dentista.
IA → Entiendo que el miedo al dentista es algo muy habitual, no te preocupes.
El dolor persistente en una muela de atrás suele indicar que conviene
revisarla antes de que avance. Si tienes ansiedad, en nuestra clínica
trabajamos con sedación consciente: estarás completamente relajado
durante todo el proceso, sin anestesia general.
¿Hace cuánto tiempo tienes ese dolor?
Usuario → Unos 4 días. A veces se extiende a la mandíbula.
IA → Cuando el dolor se extiende a la mandíbula puede haber algo de
inflamación o incluso afectación del nervio. Es importante valorarlo
cuanto antes. Te propongo una primera visita esta semana — incluye
revisión inicial sin coste. ¿Tienes disponibilidad mañana por la
tarde o prefieres el fin de semana?
Usuario → Mañana por la tarde estaría bien.
IA → Perfecto. Tengo disponible mañana a las 17:30 o a las 18:15.
¿Cuál te viene mejor? Te enviamos la confirmación por email
y un recordatorio el mismo día.
Lo que hay detrás de esa conversación: el asistente conoce el protocolo de la clínica (primera visita gratuita, sedación consciente), detecta señales de urgencia (dolor que se extiende) y guía hacia la conversión sin presionar. En el Nivel 3 conectaría con el sistema de citas real y cerraría la reserva ahí mismo.
- 24/7 — Disponibilidad sin coste adicional de personal
- ~40% — Reducción típica en tiempo de respuesta inicial
- 3× — Más conversaciones completadas vs formulario estático
Otros casos de atención al cliente donde funciona especialmente bien
El ejemplo de la clínica dental es el más visual porque combina empatía, urgencia y conversión en un solo flujo. Pero la misma lógica se aplica a sectores muy distintos. Lo que cambia es el contexto del negocio que se carga en el sistema, el tono que se configura en el prompt y las acciones que se conectan al final del flujo.
Despachos de abogados y asesorías
El problema actual
La mayoría de despachos tienen un formulario de contacto con cuatro campos y una promesa de respuesta en 24-48 horas. El potencial cliente con una urgencia real —una notificación de Hacienda, un problema laboral— no puede esperar dos días. Si no obtiene respuesta inmediata, llama al despacho de la competencia.
Cómo funciona con Vercel AI Gateway
El asistente recibe la consulta, identifica el área del problema (laboral, fiscal, civil, penal, mercantil) y responde con información general sobre ese tipo de caso, los plazos habituales y lo que necesita el despacho para evaluarlo. No da consejo legal, sino que cualifica la consulta y prepara al usuario para la primera reunión. Al final deriva al abogado especialista correcto, envía un email con el resumen del caso y propone horarios disponibles.
Qué gana el despacho
- Respuesta inmediata a cualquier hora sin coste de personal
- Leads precualificados que llegan a la primera reunión ya habiendo entendido el proceso
- Reducción del tiempo dedicado a consultas fuera del área del despacho
- Imagen de disponibilidad y profesionalidad frente a competidores con solo formulario
Límite importante
El prompt debe dejar muy claro que el asistente no ofrece asesoramiento legal vinculante. Cualquier respuesta interpretable como consejo jurídico es un riesgo que el despacho debe evitar con instrucciones explícitas en el sistema.
Academias, escuelas y centros de formación
El problema actual
Los centros de formación reciben muchas consultas repetitivas: precio del curso, fechas de inicio, requisitos previos, si hay financiación, si el título tiene salida laboral. El equipo comercial dedica horas a responder siempre las mismas preguntas antes de llegar a la conversación que realmente importa.
Cómo funciona con Vercel AI Gateway
El asistente resuelve en segundos todas las preguntas frecuentes con información exacta del catálogo. Pero además puede preguntar al usuario cuál es su situación actual, qué objetivos tiene y qué tiempo disponible tiene, y recomendar el programa más adecuado para ese perfil concreto. Esa personalización en la recomendación convierte mucho mejor que una lista de cursos disponibles.
Qué gana la academia
- El equipo comercial recibe leads que ya saben qué curso quieren y por qué
- Las consultas repetitivas desaparecen del trabajo diario del equipo
- Se pueden gestionar picos de demanda al inicio de cada convocatoria sin contratar personal temporal
- El asistente puede gestionar preinscripciones y enviar la documentación necesaria por email
Clínicas de estética, fisioterapia y bienestar
El problema actual
Catálogo amplio de tratamientos, precios que varían según zona o número de sesiones, y pacientes que a menudo no saben exactamente qué tratamiento necesitan. El resultado es que muchas consultas llegan sin cualificar.
Cómo funciona con Vercel AI Gateway
El asistente hace un triaje conversacional: qué zona quiere tratar, cuál es su objetivo (reducción, tonificación, recuperación), si tiene alguna condición médica relevante y qué presupuesto orientativo maneja. Con esa información recomienda el tratamiento más adecuado y explica cuántas sesiones suelen ser necesarias.
Qué gana el centro
- Primeras visitas más productivas porque el paciente llega cualificado
- Menos cancelaciones porque el paciente entiende bien el proceso antes de reservar
- Posibilidad de ofrecer packs o tratamientos combinados de forma contextualizada
- Gestión de lista de espera automática cuando no hay hueco disponible
Inmobiliarias y agencias de alquiler
El problema actual
Los portales inmobiliarios generan muchos contactos pero de muy baja calidad. Llegan consultas de personas que preguntan por pisos que no cumplen su presupuesto, que buscan en zonas que no son las del catálogo o que tienen condiciones que hacen inviable la operación.
Cómo funciona con Vercel AI Gateway
El asistente cualifica al potencial cliente antes de que llegue al equipo: zona de interés, presupuesto máximo, compra o alquiler, número de habitaciones, si tiene mascota o necesita garaje. Con esa información puede mostrar directamente los inmuebles del catálogo que encajan y proponer una visita solo cuando hay un match real.
Qué gana la inmobiliaria
- El agente trabaja solo con leads que ya han pasado un filtro básico de cualificación
- El cliente llega a la visita con expectativas ajustadas
- Se pueden gestionar consultas de múltiples portales desde un solo punto de entrada
- Disponibilidad 24 horas en un sector donde los interesados consultan frecuentemente fuera del horario comercial
Empresas de servicios a domicilio
El problema actual
Fontaneros, electricistas, empresas de limpieza o reformas reciben muchas consultas para presupuestar servicios muy distintos entre sí. Calcular un presupuesto requiere hacer preguntas específicas que el equipo repite decenas de veces al día.
Cómo funciona con Vercel AI Gateway
El asistente recoge toda la información necesaria: tipo de servicio, metros cuadrados, número de estancias, urgencia, localización. Con esa información puede generar un rango de precio orientativo o derivar al técnico con toda la información ya recopilada. En el Nivel 3 puede crear el presupuesto en el CRM y enviar un PDF al cliente automáticamente.
Qué gana la empresa
- Reducción drástica del tiempo dedicado a toma de datos por teléfono
- Presupuestos más rápidos y con menos errores porque la información llega estructurada
- Posibilidad de atender más solicitudes simultáneas sin aumentar el equipo
- El cliente recibe un rango de precio orientativo inmediato que reduce la incertidumbre
Patrón común en todos estos casos
El mayor valor no está en el chat en sí. Está en la cualificación automática que hace antes de que el lead llegue al equipo humano. Cuanto mejor cualifica el asistente, más productivo es el tiempo del equipo. Ese es el retorno real de un sistema bien montado.
Vercel AI Gateway y marketing
El marketing es el segundo gran caso de uso y el que más impacta en equipos pequeños o agencias que gestionan múltiples clientes. La clave aquí no es el chat. Es la capacidad de automatizar la producción de contenido, personalizarlo a escala y conectarlo con los sistemas de distribución.
Generación de contenido con contexto real de negocio
Un modelo de IA solo, sin contexto, genera contenido genérico. El valor real aparece cuando el modelo conoce tu negocio, tu audiencia, tus palabras clave y tu tono de voz.
Diagrama · Flujo de generación de contenido
Base de conocimiento del negocio ← productos, servicios, público objetivo, tono
↓
Keyword o tema de contenido
↓
Vercel AI Gateway selecciona el modelo óptimo
← Claude para redacción larga · Gemini para estructuras SEO
↓
Artículo generado con tu voz, tu estructura, tus CTAs
↓
Publicación automática o revisión humana + publicación
Ejemplo real: FAQs SEO automáticas para una clínica dental
El sistema recibe una lista de búsquedas frecuentes exportada de Google Search Console y por cada una genera una FAQ optimizada para SEO con el contexto de la clínica.
Python · Input — Keywords desde Search Console
keywords = [ "cuánto dura un implante dental", "implante dental precio España", "implante dental con sedación", "qué pasa si no pones implante" ]
Output · FAQ generada automáticamente
¿Cuánto dura un implante dental? Un implante dental correctamente colocado y mantenido puede durar toda la vida. La corona cerámica que va sobre el implante suele tener una vida útil de 15 a 20 años. En nuestra clínica realizamos revisiones periódicas para asegurar la correcta integración del implante con el hueso.
El sistema puede generar 50 FAQs en minutos, listas para publicar como entradas de blog, páginas de preguntas frecuentes o fragmentos de Schema markup.
| Tarea de marketing | Sin el sistema | Con Vercel AI Gateway |
|---|---|---|
| Artículos de blog | 4–6h por artículo | 20 min generación + 30 min revisión |
| FAQs | Desactualizadas o inexistentes | Generadas y actualizadas automáticamente |
| Segmentación | Mismo contenido para todos | Adaptado por segmento de usuario |
| Traducciones | Manuales o inexistentes | Automáticas a múltiples idiomas |
| Meta descriptions | Escritas a mano, una a una | Generadas en bloque |
| Tono de voz | Sin coherencia entre canales | Consistente, definido en el prompt |
| Área | Capacidades |
|---|---|
| Generación de contenido a escala | Artículos de blog con contexto de negocio real · FAQs SEO por categoría de producto o servicio · Descripciones de producto en ecommerce a escala · Meta titles y descriptions en bloque · Adaptación de contenido a distintos idiomas |
| Personalización de mensajes | Emails de seguimiento adaptados al comportamiento del usuario · Mensajes de WhatsApp personalizados según el historial · Ofertas generadas dinámicamente según el perfil · Contenido del chat adaptado al canal de llegada del usuario |
| Análisis y reporting | Resumen automático de analíticas en lenguaje natural · Clustering de keywords desde Search Console · Análisis de sentimiento en reviews y comentarios · Generación de informes mensuales automáticos para clientes |
| Creación de imágenes para marketing | Imágenes para blog y redes con GPT Image o Flux · Variaciones de creatividades para A/B testing · Thumbnails automáticos para artículos nuevos · Todo desde el mismo gateway, sin cambiar de herramienta |
Claude Sonnet es excelente para redacción larga y empática. Gemini Flash es más rápido y barato para estructuras SEO simples. DeepSeek puede ser la opción más económica para tareas repetitivas. Con el gateway asignas el modelo correcto a cada tarea y controlas el coste total desde un solo panel.
Cómo usar el plugin en tu código PHP: guía técnica oficial
La documentación oficial de Vercel para WordPress detalla cómo llamar al gateway desde el código de cualquier plugin. La función central es wp_ai_client_prompt(), que devuelve un constructor de prompts con métodos encadenables. Todo el código debe ejecutarse después del hook init de WordPress.
Generación de texto básica
El caso más sencillo: enviar un prompt y recibir texto. Útil para generar descripciones, respuestas automáticas o cualquier contenido simple.
PHP · Texto básico
$text = wp_ai_client_prompt( 'Escribe una descripción de 50 palabras sobre implantes dentales.' )
->using_provider( 'ai_gateway' )
->generate_text();
Selección de modelo con cadena de fallback
Puedes indicar varios modelos en orden de preferencia. El gateway usa el primero disponible. Si Claude está caído, pasa automáticamente a Gemini sin que el usuario note nada.
PHP · Fallback de modelos
$text = wp_ai_client_prompt( 'Explica las opciones de implante dental en un párrafo.' )
->using_provider( 'ai_gateway' )
->using_model_preference( 'claude-sonnet-4.6', 'gemini-3.1-pro-preview' )
->generate_text();
Instrucción de sistema y parámetros de generación
La instrucción de sistema define el rol, el tono y los límites de la IA. La temperatura controla la creatividad: valores bajos como 0.2 dan respuestas precisas y consistentes, valores altos como 0.8 dan respuestas más creativas.
PHP · Instrucción de sistema
$text = wp_ai_client_prompt( '¿Cuánto cuesta un implante dental?' )
->using_provider( 'ai_gateway' )
->using_model_preference( 'claude-sonnet-4.6' )
->using_system_instruction( 'Eres el asistente de la Clínica Dental Exemplo. Responde en español, con tono empático y profesional. Nunca des precios exactos sin valoración previa. Siempre ofrece una primera visita gratuita.' )
->using_temperature( 0.2 )
->using_max_tokens( 200 )
->generate_text();
Conversación multi-turno con historial
Para que el asistente recuerde lo que se ha dicho antes en la misma sesión hay que pasar el historial de mensajes con with_history(). Esto permite conversaciones naturales en las que el usuario no tiene que repetir el contexto en cada mensaje.
PHP · Conversación multi-turno
use WordPress\AiClient\Messages\DTO\UserMessage;
use WordPress\AiClient\Messages\DTO\ModelMessage;
use WordPress\AiClient\Messages\DTO\MessagePart;
$history = [
new UserMessage( [ new MessagePart( 'Me duele una muela y tengo miedo al dentista.' ) ] ),
new ModelMessage( [ new MessagePart( 'Entiendo, el miedo al dentista es muy habitual. ¿Cuánto tiempo llevas con ese dolor?' ) ] ),
];
$text = wp_ai_client_prompt( 'Llevo tres días. A veces se extiende a la mandíbula.' )
->using_provider( 'ai_gateway' )
->with_history( ...$history )
->generate_text();
Visión: análisis de imágenes
Se puede pasar una imagen al modelo con with_file() y pedir que la analice. Acepta URLs, rutas locales, cadenas base64 o data URIs. Útil para revisar documentos subidos por el usuario, describir imágenes de productos o analizar radiografías como apoyo informativo.
PHP · Análisis de imagen
$text = wp_ai_client_prompt( 'Describe lo que ves en esta imagen desde el punto de vista dental.' )
->using_provider( 'ai_gateway' )
->using_model_preference( 'gemini-3.1-pro-preview' )
->with_file( 'https://miclinica.com/uploads/radiografia.jpg' )
->generate_text();
Aviso para uso en salud
El análisis de imágenes médicas mediante IA puede usarse como apoyo informativo pero nunca como diagnóstico clínico. El prompt de sistema debe dejar esto explícito y redirigir siempre al criterio del profesional.
Salida estructurada en JSON
Con as_json_response() y un esquema JSON se fuerza al modelo a devolver datos en un formato concreto. Muy útil para generar contenido SEO estructurado, extraer datos de formularios o alimentar sistemas externos.
PHP · Salida JSON estructurada
$schema = [
'type' => 'object',
'properties' => [
'title' => [ 'type' => 'string' ],
'keywords' => [ 'type' => 'array', 'items' => [ 'type' => 'string' ] ],
],
'required' => [ 'title', 'keywords' ],
];
$text = wp_ai_client_prompt( 'Sugiere un título y 5 keywords SEO para un artículo sobre implantes dentales en Madrid.' )
->using_provider( 'ai_gateway' )
->as_json_response( $schema )
->generate_text();
$data = json_decode( $text, true );
// $data['title'] → título del artículo
// $data['keywords'] → array con las 5 keywords
Generación de imágenes y vídeo
El gateway también puede generar imágenes y vídeos desde texto. Con generate_image() se crean imágenes para blog, redes sociales o campañas directamente desde WordPress.
PHP · Generación de imagen
$file = wp_ai_client_prompt( 'Una clínica dental moderna y luminosa con equipo de última generación, estilo fotográfico profesional.' )
->using_provider( 'ai_gateway' )
->using_model_preference( 'gemini-3.1-flash-image-preview' )
->as_output_media_aspect_ratio( '16:9' )
->generate_image();
file_put_contents( __DIR__ . '/imagen-clinica.png', base64_decode( $file->getBase64Data() ) );
Salida multimodal: texto e imagen en una sola llamada
Una de las capacidades más avanzadas: pedir texto e imagen en la misma petición. El modelo genera ambos formatos de una sola vez. Aplicación directa: generar un post de blog con su imagen de cabecera en una sola llamada.
PHP · Salida multimodal
use WordPress\AiClient\Messages\Enums\ModalityEnum;
$result = wp_ai_client_prompt( 'Escribe un artículo corto sobre los beneficios de los implantes dentales con una imagen ilustrativa para el post.' )
->using_provider( 'ai_gateway' )
->as_output_modalities( ModalityEnum::text(), ModalityEnum::image() )
->generate_result();
Resumen de capacidades desde PHP
Texto con conversación multi-turno · Análisis de imágenes con visión · Salida JSON tipada con esquema · Generación y edición de imágenes · Generación de vídeo · Salida multimodal texto+imagen · Fallback automático entre modelos con prioridad configurable.
Cómo instalarlo: guía paso a paso
wp_ai_client.vercel.com/ai/api-keys.init.wp_ai_client para el chat o la funcionalidad que necesites.Sin coste de plataforma
Vercel AI Gateway cobra exactamente lo que cobran los proveedores de IA. No hay margen adicional. Solo pagas el coste real de los tokens que usas.
¿Para qué tipo de proyecto tiene sentido?
- Clínicas y centros de salud
- Ecommerce con catálogo amplio
- Despachos profesionales
- Academias y formación
- Agencias con varios clientes
- SaaS y productos digitales
- Webs con tráfico alto
- Proyectos multiidioma
- Negocios con atención 24/7
Para una web pequeña con tráfico bajo y un chatbot muy básico, puede ser más de lo que necesitas. Para cualquier proyecto que quiera escalar, usar más de un modelo o tener control real sobre costes y calidad, tiene sentido desde el primer día.
Conclusión
Las webs están dejando de ser páginas estáticas con formularios para convertirse en sistemas que conversan, recomiendan y actúan. El plugin Vercel para WordPress es la infraestructura que hace posible ese salto sin tener que construir todo desde cero.
No sustituye al equipo humano. Complementa su capacidad: responde a las 3 de la mañana, cualifica leads antes de que lleguen a ventas, genera contenido que el equipo revisa y publica, y ejecuta acciones rutinarias sin intervención.
Quien lo implemente bien ahora tiene una ventaja real sobre los que sigan usando formularios de contacto y plugins de chatbot de los de siempre.
