Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Vercel AI SDK pro Grok

Lekce 7 z 14 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Grok v ekosystému JavaScriptu
  2. Instalace
  3. Konfigurace
  4. Generování textu
  5. Streamování
  6. Responses API nebo Chat Completions
  7. Integrace s Next.js
  8. Generování obrázků
  9. Kdy zvolit toto SDK
  10. Klíčové poznatky

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/xai již nepodporuje Chat Completions; trasa v Next.js vrací createUIMessageStreamResponse a generování obrázků probíhá přes generateImage s parametrem aspectRatio. 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 ai a @ai-sdk/xai pro nativní podporu Grok
  • Poskytovatel xai() automaticky čte XAI_API_KEY
  • Pro úplné odpovědi použij generateText a pro streamování streamText
  • xai() využívá Responses API; poskytovatel od verze 5 již nepodporuje Chat Completions