Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Vercel AI SDK pre Grok

Lekcia 7 z 14 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Grok v ekosystéme JavaScriptu
  2. Inštalácia
  3. Konfigurácia
  4. Generovanie textu
  5. Streamovanie
  6. Responses API alebo Chat Completions
  7. Integrácia s Next.js
  8. Generovanie obrázkov
  9. Kedy zvoliť toto SDK
  10. Kľúčové poznatky

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/xai už nepodporuje Chat Completions; cesta v Next.js vracia createUIMessageStreamResponse a generovanie obrázkov prebieha cez generateImage s parametrom aspectRatio. 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 ai a @ai-sdk/xai pre natívnu podporu Grok
  • Poskytovateľ xai() automaticky číta XAI_API_KEY
  • Na kompletné odpovede použite generateText a na streamovanie streamText
  • xai() využíva Responses API; poskytovateľ od verzie 5 už nepodporuje Chat Completions