Vercel AI SDK för Grok
På denna sida
Uppdaterat den 3 november 2026, baserat på dokumentationen för AI SDK 7 och dess xAI-leverantör:
xai()använder Responses API, och version 5 av leverantören@ai-sdk/xaistöder inte längre Chat Completions; Next.js-rutinen returnerarcreateUIMessageStreamResponse, och bildgenerering sker viagenerateImagemedaspectRatio. Källor: AI SDK, xAI-leverantör · AI SDK, Chatbot.
Grok i JavaScript-ekosystemet
Vercel AI SDK är den självklara lösningen för att integrera språkmodeller i JavaScript- och TypeScript-applikationer. xAI tillhandahåller en dedikerad leverantör (@ai-sdk/xai) som integreras nativt med SDK:t för en smidig utvecklingsupplevelse i webbapplikationer.
Installation
Installera SDK:t och xAI-leverantören:
npm install ai @ai-sdk/xai
Om du använder TypeScript med valideringsscheman (strukturerade utdata), lägg till Zod:
npm install ai @ai-sdk/xai zod
Konfiguration
xAI-leverantören läser automatiskt miljövariabeln XAI_API_KEY. Skapa en fil .env.local i roten av ditt projekt:
XAI_API_KEY=xai-your-key-here
Generera text
Grundläggande användning med 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);
Med konversationshistorik
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?' },
],
});
Strömning
Vercel AI SDK excellerar inom strömning, vilket är särskilt användbart för responsiva användargränssnitt:
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);
}
Responses API eller Chat Completions
Med aktuella versioner (AI SDK 7 och @ai-sdk/xai 5) går xai(model) via xAI:s Responses API, vilket är det xAI rekommenderar: alla exemplen ovan använder detta redan, och xai.responses(model) låter dig ange det explicit. Leverantören har inte längre stött den äldre Chat Completions-endpointen sedan version 5 (september 2026); om du behöver den, använd OpenAI SDK pekande mot xAI (föregående lektion).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// Responses API: kort form, eller explicit
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.',
});
Integration med Next.js
Vercel AI SDK är designat för att fungera bäst med Next.js. Här är en API-rut med strömning, i det format som hooken useChat från @ai-sdk/react förväntar sig:
// 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 }),
});
}
Den gamla result.toDataStreamResponse() finns inte längre; result.toUIMessageStreamResponse() fungerar fortfarande i AI SDK 7 men är föråldrad.
Bildgenerering
xAI-leverantören stöder även bildgenerering med 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',
});
xAI:s bildmodell tar inte emot en parameter size: använd aspectRatio.
När du ska välja detta SDK
Vercel AI SDK är det självklara valet så snart du arbetar med JavaScript eller TypeScript på webben. Om din app körs i Next.js, Nuxt, SvelteKit eller ett jämförbart ramverk passar det perfekt in i din befintliga arbetsmiljö, med hookar och komponenter designade för dessa miljöer. Dess mest synliga styrka är strömning till webbläsaren: progressiv visning av svar, vilket annars kräver krånglig kodning för hand, fungerar här på några få rader. Dess abstraktion över flera leverantörer (samma API för OpenAI, Anthropic och xAI) gör det till det bästa valet när du vill kunna byta modeller utan att skriva om ditt integrationslager: xAI-leverantören ersätter en annan med en enda import-rad.
Viktiga punkter
- Installera
aioch@ai-sdk/xaiför inbyggt stöd för Grok - Leverantören
xai()läser automatisktXAI_API_KEY - Använd
generateTextför kompletta svar ochstreamTextför strömning xai()använder Responses API; leverantören har inte längre stött Chat Completions sedan version 5