A Vercel AI SDK Grokhoz
Ezen az oldalon
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/xaiszolgáltató 5-ös verziója már nem támogatja a Chat Completions végpontot; a Next.js útvonal acreateUIMessageStreamResponsefüggvényt adja vissza, a képgenerálás pedig azaspectRatioparaméterrel ellátottgenerateImagesegí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/xaicsomagokat a natív Grok támogatáshoz - Az
xai()szolgáltató automatikusan beolvassa aXAI_API_KEYváltozót - Használd a
generateTextfüggvényt a teljes válaszokhoz, astreamTextfü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