Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Das Vercel AI SDK für Grok

Lektion 7 von 14 Aktualisiert am 3. November 2026 Entwickler
Auf dieser Seite
  1. Grok im JavaScript-Ökosystem
  2. Installation
  3. Konfiguration
  4. Text generieren
  5. Streaming
  6. Responses API oder Chat Completions
  7. Integration mit Next.js
  8. Bildgenerierung
  9. Wann Sie dieses SDK wählen sollten
  10. Kernaussagen

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 gibt createUIMessageStreamResponse zurück, und die Bildgenerierung erfolgt über generateImage mit aspectRatio. 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 ai und @ai-sdk/xai für native Grok-Unterstützung
  • Der xai()-Anbieter liest automatisch XAI_API_KEY aus
  • Verwenden Sie generateText für vollständige Antworten und streamText für Streaming
  • xai() nutzt die Responses API; der Anbieter unterstützt seit Version 5 keine Chat Completions mehr