Ir al contenido principal
Español— Elegir un idioma
Menú

El SDK de IA de Vercel para Grok

Lección 7 de 14 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. Grok en el ecosistema JavaScript
  2. Instalación
  3. Configuración
  4. Generación de texto
  5. Streaming
  6. API de Responses o Chat Completions
  7. Integración con Next.js
  8. Generación de imágenes
  9. Cuándo elegir este SDK
  10. Puntos clave

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/xai ya no admite Chat Completions; la ruta de Next.js devuelve createUIMessageStreamResponse, y la generación de imágenes se realiza mediante generateImage con aspectRatio. 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 ai y @ai-sdk/xai para admitir Grok de forma nativa
  • El proveedor xai() lee automáticamente XAI_API_KEY
  • Usa generateText para respuestas completas y streamText para streaming
  • xai() utiliza la API de Responses; el proveedor dejó de admitir Chat Completions desde la versión 5