Vercel AI SDK til Grok
På denne side
Opdateret 3. november 2026, baseret på dokumentationen for AI SDK 7 og dets xAI-provider:
xai()bruger Responses API, og version 5 af@ai-sdk/xai-provideren understøtter ikke længere Chat Completions; Next.js-ruten returnerercreateUIMessageStreamResponse, og billedgenerering sker viagenerateImagemedaspectRatio. Kilder: AI SDK, xAI-provider · AI SDK, Chatbot.
Grok i JavaScript-økosystemet
Vercel AI SDK er den foretrukne løsning til at integrere sprogmodeller i JavaScript- og TypeScript-applikationer. xAI leverer en dedikeret provider (@ai-sdk/xai), der integreres nativt med SDK’et for en gnidningsfri udviklingsoplevelse i webapps.
Installation
Installér SDK’et og xAI-provideren:
npm install ai @ai-sdk/xai
Hvis du bruger TypeScript med valideringsskemaer (strukturerede outputs), skal du tilføje Zod:
npm install ai @ai-sdk/xai zod
Konfiguration
xAI-provideren læser automatisk miljøvariablen XAI_API_KEY. Opret en fil .env.local i roden af dit projekt:
XAI_API_KEY=xai-your-key-here
Generér tekst
Grundlæggende brug med generateText:
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Forklar begrebet serverless i 3 sætninger.',
});
console.log(text);
Med en samtalehistorik
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
messages: [
{ role: 'system', content: 'Du er en ekspert i cloud-arkitektur.' },
{ role: 'user', content: 'Hvad er fordelene ved serverless?' },
],
});
Streaming
Vercel AI SDK excellerer inden for streaming, hvilket er særligt nyttigt til responsive brugergrænseflader:
import { streamText } from 'ai';
import { xai } from '@ai-sdk/xai';
const result = streamText({
model: xai('grok-4.7'),
prompt: 'Skriv en introduktion til RESTful APIs.',
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Responses API eller Chat Completions
Med aktuelle versioner (AI SDK 7 og @ai-sdk/xai 5) går xai(model) gennem xAIs Responses API, som er den, xAI anbefaler: alle eksemplerne ovenfor bruger det allerede, og xai.responses(model) lader dig angive det eksplicit. Provideren har ikke længere understøttet det ældre Chat Completions-endpoint siden version 5 (september 2026); hvis du har brug for det, skal du bruge OpenAI SDK peget mod xAI (forrige lektion).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// Responses API: kort form eller eksplicit
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Analyser fordele og ulemper ved mikrotjenester.',
});
const explicit = await generateText({
model: xai.responses('grok-4.7'),
prompt: 'Samme spørgsmål, hvor API'en navngives.',
});
Integration med Next.js
Vercel AI SDK er designet til at fungere bedst med Next.js. Her er en API-rute med streaming i det format, som useChat-hook’en fra @ai-sdk/react forventer:
// 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 gamle result.toDataStreamResponse() eksisterer ikke længere; result.toUIMessageStreamResponse() fungerer stadig i AI SDK 7, men er forældet.
Billedgenerering
xAI-provideren understøtter også billedgenerering med generateImage:
import { generateImage } from 'ai';
import { xai } from '@ai-sdk/xai';
const { image } = await generateImage({
model: xai.image('grok-imagine-image'),
prompt: 'En futuristisk by ved solnedgang',
aspectRatio: '16:9',
});
xAIs billedmodel accepterer ikke en size-parameter: brug aspectRatio.
Hvornår skal du vælge dette SDK?
Vercel AI SDK er det klare valg, så snart du arbejder på webbet med JavaScript eller TypeScript. Hvis din app kører i Next.js, Nuxt, SvelteKit eller et sammenligneligt framework, passer den perfekt ind i dit eksisterende arbejdsmiljø med hooks og komponenter designet til netop disse omgivelser. Dens mest synlige styrke er streaming til browseren: progressiv visning af svar, som ellers kræver kompliceret manuel kodning, fungerer her på få linjer. Og dens abstraktion på tværs af flere providere (den samme API til OpenAI, Anthropic og xAI) gør den til det bedste valg, når du ønsker at kunne skifte modeller uden at omskrive dit integrationslag: xAI-provideren erstatter en anden med en enkelt importlinje.
Vigtige pointer
- Installér
aiog@ai-sdk/xaifor native Grok-understøttelse xai()-provideren læser automatiskXAI_API_KEY- Brug
generateTexttil komplette svar ogstreamTexttil streaming xai()bruger Responses API; provideren har ikke længere understøttet Chat Completions siden version 5