Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

A Vercel AI SDK Grokhoz

7. lecke 14 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. Grok a JavaScript ökoszisztémában
  2. Telepítés
  3. Konfiguráció
  4. Szöveg generálása
  5. Streamelés
  6. Responses API vagy Chat Completions
  7. Integráció Next.js-szel
  8. Képgenerálás
  9. Mikor válaszd ezt az SDK-t?
  10. Főbb megállapítások

Frissítve: 2026. november 3., az AI SDK 7-es verziójának és annak xAI szolgáltatójának dokumentációja alapján: az xai() a Responses API-t használja, és az @ai-sdk/xai szolgáltató 5-ös verziója már nem támogatja a Chat Completions végpontot; a Next.js útvonal a createUIMessageStreamResponse függvényt adja vissza, a képgenerálás pedig az aspectRatio paraméterrel ellátott generateImage segítségével történik. Források: AI SDK, xAI szolgáltató · AI SDK, Chatbot.

Grok a JavaScript ökoszisztémában

A Vercel AI SDK a legkézenfekvőbb megoldás nyelvi modellek JavaScript és TypeScript alkalmazásokba történő integrálására. Az xAI egy dedikált szolgáltatót (@ai-sdk/xai) biztosít, amely natívan integrálódik az SDK-val, így zökkenőmentes fejlesztői élményt nyújt webes alkalmazásokhoz.

Telepítés

Telepítsd az SDK-t és az xAI szolgáltatót:

npm install ai @ai-sdk/xai

Ha TypeScriptet használsz validációs sémákkal (strukturált kimenetek), add hozzá a Zodot is:

npm install ai @ai-sdk/xai zod

Konfiguráció

Az xAI szolgáltató automatikusan beolvassa a XAI_API_KEY környezeti változót. Hozz létre egy .env.local fájlt a projekted gyökérkönyvtárában:

XAI_API_KEY=xai-your-key-here

Szöveg generálása

Alapvető használat a generateText függvénnyel:

import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';

const { text } = await generateText({
  model: xai('grok-4.7'),
  prompt: 'Magyarázd el a serverless koncepcióját 3 mondatban.',
});

console.log(text);

Beszélgetési előzményekkel

import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';

const { text } = await generateText({
  model: xai('grok-4.7'),
  messages: [
    { role: 'system', content: 'Te egy felhőarchitektúra szakértő vagy.' },
    { role: 'user', content: 'Mik a serverless előnyei?' },
  ],
});

Streamelés

A Vercel AI SDK kiválóan alkalmas streamelésre, ami különösen hasznos a responszív felhasználói felületekhez:

import { streamText } from 'ai';
import { xai } from '@ai-sdk/xai';

const result = streamText({
  model: xai('grok-4.7'),
  prompt: 'Írj egy bevezetőt a RESTful API-k világába.',
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}

Responses API vagy Chat Completions

A jelenlegi verziókkal (AI SDK 7 és @ai-sdk/xai 5) az xai(model) az xAI Responses API-ján keresztül kommunikál, amelyet az xAI ajánl: a fenti példák mindegyike ezt használja, és az xai.responses(model) szintaxissal ezt explicit módon is megadhatod. A szolgáltató az 5-ös verzió óta (2026. szeptember) már nem támogatja a régi Chat Completions végpontot; ha erre van szükséged, használd az xAI-ra irányított OpenAI SDK-t (lásd az előző leckét).

import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';

// Responses API: rövid forma, vagy explicit megadás
const { text } = await generateText({
  model: xai('grok-4.7'),
  prompt: 'Elemezd a mikroszolgáltatások előnyeit és hátrányait.',
});

const explicit = await generateText({
  model: xai.responses('grok-4.7'),
  prompt: 'Ugyanaz a kérdés, az API nevének megnevezésével.',
});

Integráció Next.js-szel

A Vercel AI SDK-t kifejezetten a Next.js-szel való együttműködésre tervezték. Íme egy API útvonal streameléssel, abban a formátumban, amelyet a @ai-sdk/react csomag useChat hookja elvár:

// 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 }),
  });
}

A régi result.toDataStreamResponse() módszer már nem létezik; a result.toUIMessageStreamResponse() még működik az AI SDK 7-ben, de elavultnak számít.

Képgenerálás

Az xAI szolgáltató a képgenerálást is támogatja a generateImage függvény segítségével:

import { generateImage } from 'ai';
import { xai } from '@ai-sdk/xai';

const { image } = await generateImage({
  model: xai.image('grok-imagine-image'),
  prompt: 'Egy futurisztikus város naplementekor',
  aspectRatio: '16:9',
});

Az xAI képmmodellje nem fogad el size paramétert: helyette az aspectRatio értéket használd.

Mikor válaszd ezt az SDK-t?

A Vercel AI SDK egyértelmű választás, amint JavaScript vagy TypeScript alapú webes fejlesztésbe kezdesz. Ha az alkalmazásod Next.js-ben, Nuxtban, SvelteKitben vagy egy hasonló keretrendszerben fut, tökéletesen illeszkedik a munkakörnyezetedbe, a kifejezetten ezekhez a környezetekhez tervezett hookokkal és komponensekkel. Leglátványosabb erőssége a böngésző felé történő streamelés: a válaszok progresszív megjelenítése, amely kézzel megírva bonyolult kódolást igényel, itt néhány sorral megoldható. Emellett a több szolgáltatót átfogó absztrakciója (ugyanaz az API az OpenAI, az Anthropic és az xAI számára) teszi a legjobb választássá, ha modellek között szeretnél váltani az integrációs réteg átírása nélkül: az xAI szolgáltató egyetlen import sorral helyettesít bármelyik mást.

Főbb megállapítások

  • Telepítsd az ai és a @ai-sdk/xai csomagokat a natív Grok támogatáshoz
  • Az xai() szolgáltató automatikusan beolvassa a XAI_API_KEY változót
  • Használd a generateText függvényt a teljes válaszokhoz, a streamText függvényt pedig a streameléshez
  • Az xai() a Responses API-t használja; a szolgáltató az 5-ös verzió óta már nem támogatja a Chat Completions végpontot