El SDK de IA de Vercel para Grok
En esta página
Actualizado el 3 de noviembre de 2026, según la documentación del SDK de IA 7 y su proveedor xAI:
xai()utiliza la API de Responses, y la versión 5 del proveedor@ai-sdk/xaiya no admite Chat Completions; la ruta de Next.js devuelvecreateUIMessageStreamResponse, y la generación de imágenes se realiza mediantegenerateImageconaspectRatio. Fuentes: SDK de IA, proveedor xAI · SDK de IA, Chatbot.
Grok en el ecosistema JavaScript
El SDK de IA de Vercel es la solución predilecta para integrar modelos de lenguaje en aplicaciones de JavaScript y TypeScript. xAI ofrece un proveedor dedicado (@ai-sdk/xai) que se integra de forma nativa con el SDK, lo que garantiza una experiencia de desarrollo fluida en aplicaciones web.
Instalación
Instala el SDK y el proveedor xAI:
npm install ai @ai-sdk/xai
Si utilizas TypeScript con esquemas de validación (salidas estructuradas), añade Zod:
npm install ai @ai-sdk/xai zod
Configuración
El proveedor xAI lee automáticamente la variable de entorno XAI_API_KEY. Crea un archivo .env.local en la raíz de tu proyecto:
XAI_API_KEY=xai-your-key-here
Generación de texto
Uso básico con generateText:
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Explica el concepto de serverless en 3 frases.',
});
console.log(text);
Con un historial de conversación
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
messages: [
{ role: 'system', content: 'Eres un experto en arquitectura en la nube.' },
{ role: 'user', content: '¿Cuáles son las ventajas de serverless?' },
],
});
Streaming
El SDK de IA de Vercel destaca en el streaming, algo especialmente útil para interfaces de usuario receptivas:
import { streamText } from 'ai';
import { xai } from '@ai-sdk/xai';
const result = streamText({
model: xai('grok-4.7'),
prompt: 'Escribe una introducción a las API RESTful.',
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
API de Responses o Chat Completions
Con las versiones actuales (SDK de IA 7 y @ai-sdk/xai 5), xai(model) utiliza la API de Responses de xAI, que es la que xAI recomienda: todos los ejemplos anteriores ya la emplean, y xai.responses(model) te permite indicarlo explícitamente. El proveedor dejó de admitir el endpoint heredado de Chat Completions desde la versión 5 (septiembre de 2026); si lo necesitas, usa el SDK de OpenAI apuntando a xAI (lección anterior).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// API de Responses: forma abreviada o explícita
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Analiza los pros y los contras de los microservicios.',
});
const explicit = await generateText({
model: xai.responses('grok-4.7'),
prompt: 'La misma pregunta, nombrando la API.',
});
Integración con Next.js
El SDK de IA de Vercel está diseñado para funcionar óptimamente con Next.js. Aquí tienes una ruta de API con streaming, en el formato que espera el gancho useChat de @ai-sdk/react:
// app/api/chat/route.ts
import {
convertToModelMessages,
createUIMessageStreamResponse,
streamText,
toUIMessageStream,
type UIMessage,
} from 'ai';
import { xai } from '@ai-sdk/xai';
export async function POST(req: Request) {
const { messages }: { messages: UIMessage[] } = await req.json();
const result = streamText({
model: xai('grok-4.7'),
messages: await convertToModelMessages(messages),
});
return createUIMessageStreamResponse({
stream: toUIMessageStream({ stream: result.stream }),
});
}
El antiguo result.toDataStreamResponse() ya no existe; result.toUIMessageStreamResponse() sigue funcionando en el SDK de IA 7, pero está obsoleto.
Generación de imágenes
El proveedor xAI también admite la generación de imágenes mediante generateImage:
import { generateImage } from 'ai';
import { xai } from '@ai-sdk/xai';
const { image } = await generateImage({
model: xai.image('grok-imagine-image'),
prompt: 'Una ciudad futurista al atardecer',
aspectRatio: '16:9',
});
El modelo de imágenes de xAI no acepta un parámetro size: usa aspectRatio.
Cuándo elegir este SDK
El SDK de IA de Vercel es la opción clara en cuanto trabajas con la web en JavaScript o TypeScript. Si tu aplicación reside en Next.js, Nuxt, SvelteKit o un framework comparable, encaja justo donde ya trabajas, con ganchos y componentes diseñados para esos entornos. Su punto fuerte más visible es el streaming hacia el navegador: la visualización progresiva de respuestas, que requiere código complejo si se hace a mano, funciona aquí en pocas líneas. Además, su abstracción multiproveedor (la misma API para OpenAI, Anthropic y xAI) lo convierte en la mejor opción cuando quieres poder cambiar de modelo sin reescribir tu capa de integración: el proveedor xAI sustituye a otro con una única línea de importación.
Puntos clave
- Instala
aiy@ai-sdk/xaipara admitir Grok de forma nativa - El proveedor
xai()lee automáticamenteXAI_API_KEY - Usa
generateTextpara respuestas completas ystreamTextpara streaming xai()utiliza la API de Responses; el proveedor dejó de admitir Chat Completions desde la versión 5