O Vercel AI SDK para o Grok
Nesta página
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/xaijá não suporta Chat Completions; a rota Next.js devolvecreateUIMessageStreamResponse, e a geração de imagens ocorre através degenerateImagecomaspectRatio. 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
aie@ai-sdk/xaipara suporte nativo do Grok - O fornecedor
xai()lê automaticamenteXAI_API_KEY - Utilize
generateTextpara respostas completas estreamTextpara streaming xai()utiliza a API de Respostas; o fornecedor deixou de suportar Chat Completions desde a versão 5