Vercel AI SDK pre Grok
Na tejto strane
Aktualizované 3. novembra 2026 na základe dokumentácie pre AI SDK 7 a jeho poskytovateľa xAI:
xai()využíva Responses API a verzia 5 poskytovateľa@ai-sdk/xaiuž nepodporuje Chat Completions; cesta v Next.js vraciacreateUIMessageStreamResponsea generovanie obrázkov prebieha cezgenerateImages parametromaspectRatio. Zdroje: AI SDK, poskytovateľ xAI · AI SDK, Chatbot.
Grok v ekosystéme JavaScriptu
Vercel AI SDK je hlavným riešením na integráciu jazykových modelov do aplikácií v JavaScripte a TypeScrite. xAI poskytuje vyhradeného poskytovateľa (@ai-sdk/xai), ktorý sa natívne integruje so SDK, čo zabezpečuje plynulý vývojársky zážitok pri tvorbe webových aplikácií.
Inštalácia
Nainštalujte SDK a poskytovateľa xAI:
npm install ai @ai-sdk/xai
Ak používate TypeScript so schémami validácie (štruktúrované výstupy), pridajte Zod:
npm install ai @ai-sdk/xai zod
Konfigurácia
Poskytovateľ xAI automaticky číta premennú prostredia XAI_API_KEY. V koreňovom adresári projektu vytvorte súbor .env.local:
XAI_API_KEY=xai-your-key-here
Generovanie textu
Základné použitie 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 históriou konverzácie
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?' },
],
});
Streamovanie
Vercel AI SDK vyniká v streamovaní, čo je obzvlášť užitočné pre responzívne používateľské rozhrania:
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 alebo Chat Completions
V aktuálnych verziách (AI SDK 7 a @ai-sdk/xai 5) volanie xai(model) prebieha cez Responses API od xAI, ktoré xAI odporúča: všetky vyššie uvedené príklady ho už využívajú a xai.responses(model) vám umožňuje explicitne uviesť, že ho používate. Poskytovateľ od verzie 5 (september 2026) už nepodporuje staršie rozhranie Chat Completions; ak ho potrebujete, použite OpenAI SDK nasmerované na xAI (predchádzajúca lekcia).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// Responses API: krátky zápis alebo 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.',
});
Integrácia s Next.js
Vercel AI SDK je navrhnuté tak, aby najlepšie fungovalo s Next.js. Tu je ukážka API trasy so streamovaním vo formáte, ktorý očakáva hák 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á metóda result.toDataStreamResponse() už neexistuje; result.toUIMessageStreamResponse() síce v AI SDK 7 stále funguje, ale je zastaraná.
Generovanie obrázkov
Poskytovateľ xAI podporuje aj generovanie obrázkov pomocou 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 neprijíma parameter size: použite aspectRatio.
Kedy zvoliť toto SDK
Vercel AI SDK je jasnou voľbou hneď, ako pracujete na webe v JavaScripte alebo TypeScrite. Ak vaša aplikácia beží v Next.js, Nuxt, SvelteKit alebo podobnom frameworku, zapadne presne tam, kde už pracujete, vďaka hákom a komponentom navrhnutým pre tieto prostredia. Jeho najviditeľnejšou silou je streamovanie do prehliadača: progresívne zobrazovanie odpovedí, ktoré by pri ručnom kódovaní bolo zložité, tu funguje na pár riadkoch. A jeho abstrakcia viacerých poskytovateľov (rovnaké API pre OpenAI, Anthropic a xAI) z neho robí najlepšiu voľbu, keď chcete mať možnosť meniť modely bez prepisovania vašej integračnej vrstvy: poskytovateľ xAI nahradí iného poskytovateľa jediným riadkom importu.
Kľúčové poznatky
- Nainštalujte
aia@ai-sdk/xaipre natívnu podporu Grok - Poskytovateľ
xai()automaticky čítaXAI_API_KEY - Na kompletné odpovede použite
generateTexta na streamovaniestreamText xai()využíva Responses API; poskytovateľ od verzie 5 už nepodporuje Chat Completions