Vercel AI SDK pro Grok
Na této stránce
Aktualizováno 3. listopadu 2026 na základě dokumentace pro AI SDK 7 a jeho poskytovatele xAI:
xai()využívá Responses API a verze 5 poskytovatele@ai-sdk/xaijiž nepodporuje Chat Completions; trasa v Next.js vracícreateUIMessageStreamResponsea generování obrázků probíhá přesgenerateImages parametremaspectRatio. Zdroje: AI SDK, poskytovatel xAI · AI SDK, Chatbot.
Grok v ekosystému JavaScriptu
Vercel AI SDK je hlavním řešením pro integraci jazykových modelů do aplikací v JavaScriptu a TypeScriptu. xAI poskytuje vyhrazeného poskytovatele (@ai-sdk/xai), který se nativně integruje se SDK, což zajišťuje plynulý vývojářský zážitek ve webových aplikacích.
Instalace
Nainstaluj SDK a poskytovatele xAI:
npm install ai @ai-sdk/xai
Pokud používáš TypeScript se schématy pro validaci (strukturované výstupy), přidej Zod:
npm install ai @ai-sdk/xai zod
Konfigurace
Poskytovatel xAI automaticky čte proměnnou prostředí XAI_API_KEY. V kořenovém adresáři projektu vytvoř soubor .env.local:
XAI_API_KEY=xai-your-key-here
Generování textu
Základní použití s 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);
S historií konverzace
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?' },
],
});
Streamování
Vercel AI SDK vyniká ve streamování, což je obzvláště užitečné pro responzivní uživatelská rozhraní:
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 nebo Chat Completions
V aktuálních verzích (AI SDK 7 a @ai-sdk/xai 5) volání xai(model) probíhá přes Responses API od xAI, které xAI doporučuje: všechny výše uvedené příklady jej již používají a xai.responses(model) ti umožňuje toto chování explicitně určit. Poskytovatel od verze 5 (září 2026) již nepodporuje zastaralý koncový bod Chat Completions; pokud jej potřebuješ, použij OpenAI SDK namířený na xAI (předchozí lekce).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// Responses API: krátká forma nebo explicitní
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.',
});
Integrace s Next.js
Vercel AI SDK je navrženo tak, aby nejlépe fungovalo s Next.js. Zde je ukázka API trasy se streamováním ve formátu, který očekává hook useChat z @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 }),
});
}
Stará metoda result.toDataStreamResponse() již neexistuje; result.toUIMessageStreamResponse() sice v AI SDK 7 stále funguje, ale je zastaralá.
Generování obrázků
Poskytovatel xAI podporuje také generování obrázků pomocí 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',
});
Obrázkový model xAI nepřijímá parametr size: použij aspectRatio.
Kdy zvolit toto SDK
Vercel AI SDK je jasnou volbou, jakmile pracuješ na webu v JavaScriptu nebo TypeScriptu. Pokud tvoje aplikace běží v Next.js, Nuxt, SvelteKit nebo podobném frameworku, zapadne přesně tam, kde již pracuješ, díky hookům a komponentám navrženým pro tato prostředí. Jeho nejviditelnější silnou stránkou je streamování do prohlížeče: progresivní zobrazování odpovědí, které při ručním psaní vyžaduje složitý kód, zde funguje na několik řádků. A jeho abstrakce více poskytovatelů (stejné API pro OpenAI, Anthropic a xAI) z něj činí nejlepší volbu, když chceš mít možnost přepínat modely bez přepisování integrační vrstvy: poskytovatel xAI nahradí jiného poskytovatele jediným řádkem importu.
Klíčové poznatky
- Nainstaluj
aia@ai-sdk/xaipro nativní podporu Grok - Poskytovatel
xai()automaticky čteXAI_API_KEY - Pro úplné odpovědi použij
generateTexta pro streamovánístreamText xai()využívá Responses API; poskytovatel od verze 5 již nepodporuje Chat Completions