Ir para o conteúdo principal
Português— Escolher um idioma
Menu

O Vercel AI SDK para o Grok

Aula 7 de 14 Atualizada a 3 de novembro de 2026 Programador
Nesta página
  1. O Grok no ecossistema JavaScript
  2. Instalação
  3. Configuração
  4. Gerar texto
  5. Streaming
  6. API de Respostas ou Chat Completions
  7. Integração com Next.js
  8. Geração de imagens
  9. Quando escolher este SDK
  10. Pontos-chave

Atualizado em 3 de novembro de 2026, com base na documentação do AI SDK 7 e do seu fornecedor xAI: xai() utiliza a API de Respostas (Responses API), e a versão 5 do fornecedor @ai-sdk/xai já não suporta Chat Completions; a rota Next.js devolve createUIMessageStreamResponse, e a geração de imagens ocorre através de generateImage com aspectRatio. Fontes: AI SDK, fornecedor xAI · AI SDK, Chatbot.

O Grok no ecossistema JavaScript

O Vercel AI SDK é a solução de eleição para integrar modelos de linguagem em aplicações JavaScript e TypeScript. A xAI disponibiliza um fornecedor dedicado (@ai-sdk/xai) que se integra nativamente com o SDK, proporcionando uma experiência de desenvolvimento fluida em aplicações web.

Instalação

Instale o SDK e o fornecedor xAI:

npm install ai @ai-sdk/xai

Se utilizar TypeScript com esquemas de validação (saídas estruturadas), adicione o Zod:

npm install ai @ai-sdk/xai zod

Configuração

O fornecedor xAI lê automaticamente a variável de ambiente XAI_API_KEY. Crie um ficheiro .env.local na raiz do seu projeto:

XAI_API_KEY=xai-your-key-here

Gerar texto

Utilização básica com generateText:

import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';

const { text } = await generateText({
  model: xai('grok-4.7'),
  prompt: 'Explain the concept of serverless in 3 sentences.',
});

console.log(text);

Com histórico de conversação

import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';

const { text } = await generateText({
  model: xai('grok-4.7'),
  messages: [
    { role: 'system', content: 'You are a cloud architecture expert.' },
    { role: 'user', content: 'What are the benefits of serverless?' },
  ],
});

Streaming

O Vercel AI SDK destaca-se no streaming, o que é especialmente útil para interfaces de utilizador responsivas:

import { streamText } from 'ai';
import { xai } from '@ai-sdk/xai';

const result = streamText({
  model: xai('grok-4.7'),
  prompt: 'Write an introduction to RESTful APIs.',
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}

API de Respostas ou Chat Completions

Com as versões atuais (AI SDK 7 e @ai-sdk/xai 5), xai(model) utiliza a API de Respostas da xAI, que é a recomendada pela xAI: todos os exemplos acima já a utilizam, e xai.responses(model) permite indicá-lo explicitamente. O fornecedor deixou de suportar o endpoint legado de Chat Completions desde a versão 5 (setembro de 2026); se necessitar dele, utilize o SDK da OpenAI apontado para a xAI (lição anterior).

import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';

// API de Respostas: forma curta ou explícita
const { text } = await generateText({
  model: xai('grok-4.7'),
  prompt: 'Analyze the pros and cons of microservices.',
});

const explicit = await generateText({
  model: xai.responses('grok-4.7'),
  prompt: 'Same question, naming the API.',
});

Integração com Next.js

O Vercel AI SDK foi concebido para funcionar otimamente com o Next.js. Eis uma rota de API com streaming, no formato esperado pelo hook 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 }),
  });
}

O antigo result.toDataStreamResponse() já não existe; result.toUIMessageStreamResponse() ainda funciona no AI SDK 7, mas está obsoleto.

Geração de imagens

O fornecedor xAI também suporta geração de imagens, através de generateImage:

import { generateImage } from 'ai';
import { xai } from '@ai-sdk/xai';

const { image } = await generateImage({
  model: xai.image('grok-imagine-image'),
  prompt: 'A futuristic city at sunset',
  aspectRatio: '16:9',
});

O modelo de imagem da xAI não aceita o parâmetro size: utilize aspectRatio.

Quando escolher este SDK

O Vercel AI SDK é a escolha óbvia assim que trabalha na web com JavaScript ou TypeScript. Se a sua aplicação reside em Next.js, Nuxt, SvelteKit ou num framework comparável, encaixa-se perfeitamente onde já trabalha, com hooks e componentes desenhados para esses ambientes. A sua força mais visível é o streaming para o browser: a exibição progressiva de respostas, que exigiria código complexo se feito manualmente, funciona aqui em poucas linhas. E a sua abstração multi-fornecedor (a mesma API para OpenAI, Anthropic e xAI) torna-o a melhor opção quando pretende poder trocar de modelos sem reescrever a sua camada de integração: o fornecedor xAI substitui outro com uma única linha de importação.

Pontos-chave

  • Instale ai e @ai-sdk/xai para suporte nativo do Grok
  • O fornecedor xai() lê automaticamente XAI_API_KEY
  • Utilize generateText para respostas completas e streamText para streaming
  • xai() utiliza a API de Respostas; o fornecedor deixou de suportar Chat Completions desde a versão 5