Vercel AI SDK za Grok
Na ovoj stranici
Ažurirano 3. studenoga 2026., na temelju dokumentacije za AI SDK 7 i njegovog xAI pružatelja usluga:
xai()koristi Responses API, a verzija 5 pružatelja usluga@ai-sdk/xaiviše ne podržava Chat Completions; Next.js ruta vraćacreateUIMessageStreamResponse, a generiranje slika odvija se putemgenerateImages parametromaspectRatio. Izvori: AI SDK, xAI provider · AI SDK, Chatbot.
Grok u JavaScript ekosustavu
Vercel AI SDK najbolje je rješenje za integraciju jezičnih modela u JavaScript i TypeScript aplikacije. xAI nudi namjenskog pružatelja usluga (@ai-sdk/xai) koji se izvorno integrira sa SDK-om, osiguravajući glatko razvojno iskustvo u web aplikacijama.
Instalacija
Instaliraj SDK i xAI pružatelja usluga:
npm install ai @ai-sdk/xai
Ako koristiš TypeScript sa shemama za validaciju (strukturirani izlazi), dodaj Zod:
npm install ai @ai-sdk/xai zod
Konfiguracija
xAI pružatelj usluga automatski čita varijablu okruženja XAI_API_KEY. Stvori datoteku .env.local u korijenu svog projekta:
XAI_API_KEY=xai-your-key-here
Generiranje teksta
Osnovna upotreba s generateText:
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Objasni koncept serverless arhitekture u 3 rečenice.',
});
console.log(text);
S poviješću razgovora
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
messages: [
{ role: 'system', content: 'Ti si stručnjak za cloud arhitekturu.' },
{ role: 'user', content: 'Koje su prednosti serverless pristupa?' },
],
});
Strujanje (Streaming)
Vercel AI SDK izvrsno rukuje strujanjem, što je posebno korisno za responzivna korisnička sučelja:
import { streamText } from 'ai';
import { xai } from '@ai-sdk/xai';
const result = streamText({
model: xai('grok-4.7'),
prompt: 'Napiši uvod u RESTful API-je.',
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Responses API ili Chat Completions
S trenutnim verzijama (AI SDK 7 i @ai-sdk/xai 5), xai(model) koristi xAI-jev Responses API, koji xAI preporučuje: svi gornji primjeri već ga koriste, a xai.responses(model) ti omogućuje da to eksplicitno navedeš. Pružatelj usluga više ne podržava zastarjelu krajnju točku Chat Completions od verzije 5 (rujan 2026.); ako ti je potrebna, koristi OpenAI SDK usmjeren na xAI (prethodna lekcija).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// Responses API: kratki oblik ili eksplicitni
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Analiziraj prednosti i mane mikrouslužba.',
});
const explicit = await generateText({
model: xai.responses('grok-4.7'),
prompt: 'Isto pitanje, uz navođenje API-ja.',
});
Integracija s Next.js
Vercel AI SDK dizajniran je za optimalan rad s Next.js frameworkom. Evo API rute sa strujanjem, u formatu koji očekuje hook useChat iz @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 }),
});
}
Stari result.toDataStreamResponse() više ne postoji; result.toUIMessageStreamResponse() još uvijek radi u AI SDK 7, ali je zastario.
Generiranje slika
xAI pružatelj usluga također podržava generiranje slika putem generateImage:
import { generateImage } from 'ai';
import { xai } from '@ai-sdk/xai';
const { image } = await generateImage({
model: xai.image('grok-imagine-image'),
prompt: 'Futuristički grad u zalazak sunca',
aspectRatio: '16:9',
});
xAI-jev model za slike ne prihvaća parametar size: koristi aspectRatio.
Kada odabrati ovaj SDK
Vercel AI SDK jasan je izbor čim radiš na JavaScript ili TypeScript webu. Ako tvoja aplikacija živi u Next.js, Nuxt, SvelteKit ili sličnom frameworku, savršeno se uklapa u tvoje postojeće okruženje, s hookovima i komponentama dizajniranima za te platforme. Njegova najvidljivija snaga je strujanje prema pregledniku: progresivni prikaz odgovora, koji bi ručno pisanjem koda bio složen, ovdje radi u nekoliko redaka. Osim toga, njegova apstrakcija višestrukih pružatelja usluga (isti API za OpenAI, Anthropic i xAI) čini ga najboljim izborom kada želiš moći mijenjati modele bez prepisivanja sloja za integraciju: xAI pružatelj usluga zamjenjuje drugi jednim retkom za uvoz.
Ključne točke
- Instaliraj
aii@ai-sdk/xaiza izvornu podršku Groku - Pružatelj usluga
xai()automatski čitaXAI_API_KEY - Koristi
generateTextza kompletne odgovore, astreamTextza strujanje xai()koristi Responses API; pružatelj usluga više ne podržava Chat Completions od verzije 5