Das Vercel AI SDK für Grok
Auf dieser Seite
Aktualisiert am 3. November 2026, basierend auf der Dokumentation für AI SDK 7 und den xAI-Anbieter:
xai()nutzt die Responses API, und Version 5 des@ai-sdk/xai-Anbieters unterstützt keine Chat Completions mehr; die Next.js-Route gibtcreateUIMessageStreamResponsezurück, und die Bildgenerierung erfolgt übergenerateImagemitaspectRatio. Quellen: AI SDK, xAI-Anbieter · AI SDK, Chatbot.
Grok im JavaScript-Ökosystem
Das Vercel AI SDK ist die erste Wahl zur Integration von Sprachmodellen in JavaScript- und TypeScript-Anwendungen. xAI stellt einen dedizierten Anbieter (@ai-sdk/xai) bereit, der sich nahtlos in das SDK integriert und so eine flüssige Entwicklungserfahrung in Webanwendungen ermöglicht.
Installation
Installieren Sie das SDK und den xAI-Anbieter:
npm install ai @ai-sdk/xai
Falls Sie TypeScript mit Validierungsschemata (strukturierte Ausgaben) verwenden, fügen Sie Zod hinzu:
npm install ai @ai-sdk/xai zod
Konfiguration
Der xAI-Anbieter liest die Umgebungsvariable XAI_API_KEY automatisch aus. Erstellen Sie eine Datei .env.local im Stammverzeichnis Ihres Projekts:
XAI_API_KEY=xai-ihren-schlüssel-hier
Text generieren
Grundlegende Verwendung mit generateText:
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Erklären Sie das Konzept Serverless in 3 Sätzen.',
});
console.log(text);
Mit einer Unterhaltungsgeschichte
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
messages: [
{ role: 'system', content: 'Sie sind ein Experte für Cloud-Architektur.' },
{ role: 'user', content: 'Was sind die Vorteile von Serverless?' },
],
});
Streaming
Das Vercel AI SDK zeichnet sich durch Streaming aus, was besonders für responsive Benutzeroberflächen nützlich ist:
import { streamText } from 'ai';
import { xai } from '@ai-sdk/xai';
const result = streamText({
model: xai('grok-4.7'),
prompt: 'Schreiben Sie eine Einführung in RESTful APIs.',
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Responses API oder Chat Completions
Mit den aktuellen Versionen (AI SDK 7 und @ai-sdk/xai 5) führt xai(model) die Requests über die Responses API von xAI, die von xAI empfohlen wird: Alle obigen Beispiele nutzen dies bereits, und xai.responses(model) lässt dies explizit festlegen. Der Anbieter unterstützt seit Version 5 (September 2026) das veraltete Endpunkt für Chat Completions nicht mehr; falls Sie diesen benötigen, verwenden Sie das OpenAI SDK, das auf xAI gerichtet ist (vorherige Lektion).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// Responses API: Kurzform oder explizit
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Analysieren Sie Vor- und Nachteile von Microservices.',
});
const explicit = await generateText({
model: xai.responses('grok-4.7'),
prompt: 'Gleiche Frage, aber die API wird benannt.',
});
Integration mit Next.js
Das Vercel AI SDK ist so konzipiert, dass es am besten mit Next.js zusammenarbeitet. Hier ist eine API-Route mit Streaming im Format, das der useChat-Hook aus @ai-sdk/react erwartet:
// 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 }),
});
}
Die alte result.toDataStreamResponse() existiert nicht mehr; result.toUIMessageStreamResponse() funktioniert zwar noch in AI SDK 7, ist jedoch veraltet.
Bildgenerierung
Der xAI-Anbieter unterstützt ebenfalls die Bildgenerierung mit generateImage:
import { generateImage } from 'ai';
import { xai } from '@ai-sdk/xai';
const { image } = await generateImage({
model: xai.image('grok-imagine-image'),
prompt: 'Eine futuristische Stadt bei Sonnenuntergang',
aspectRatio: '16:9',
});
Das Bildmodell von xAI nimmt keinen size-Parameter entgegen: Verwenden Sie aspectRatio.
Wann Sie dieses SDK wählen sollten
Das Vercel AI SDK ist die klare Wahl, sobald Sie im JavaScript- oder TypeScript-Web arbeiten. Wenn Ihre Anwendung in Next.js, Nuxt, SvelteKit oder einem vergleichbaren Framework lebt, passt es genau dort, wo Sie bereits arbeiten, mit Hooks und Komponenten, die für diese Umgebungen entwickelt wurden. Ihre sichtbarste Stärke ist das Streaming an den Browser: Der schrittweise Anzeigevorgang von Antworten, der manuell mühsame Code erfordert, funktioniert hier in wenigen Zeilen. Und seine mehrfacherbieter-Abstraktion (die gleiche API für OpenAI, Anthropic und xAI) macht es zur besten Wahl, wenn Sie Modelle wechseln können, ohne Ihre Integrationsebene neu zu schreiben: Der xAI-Anbieter ersetzt einen anderen Anbieter mit nur einer Importzeile.
Kernaussagen
- Installieren Sie
aiund@ai-sdk/xaifür native Grok-Unterstützung - Der
xai()-Anbieter liest automatischXAI_API_KEYaus - Verwenden Sie
generateTextfür vollständige Antworten undstreamTextfür Streaming xai()nutzt die Responses API; der Anbieter unterstützt seit Version 5 keine Chat Completions mehr