Vercel AI SDK za Grok
Na tej strani
Posodobljeno 3. novembra 2026 na podlagi dokumentacije za AI SDK 7 in ponudnika xAI:
xai()uporablja Responses API, različica 5 ponudnika@ai-sdk/xaipa ne podpira več Chat Completions; pot Next.js vračacreateUIMessageStreamResponse, generiranje slik pa poteka prekgenerateImages parametromaspectRatio. Viri: AI SDK, ponudnik xAI · AI SDK, Chatbot.
Grok v ekosistemu JavaScript
Vercel AI SDK je najboljša rešitev za integracijo jezikovnih modelov v aplikacije JavaScript in TypeScript. xAI ponuja namenskega ponudnika (@ai-sdk/xai), ki se izvorno integrira s SDK-jem in omogoča nemoteno razvojno izkušnjo v spletnih aplikacijah.
Namestitev
Namesti SDK in ponudnika xAI:
npm install ai @ai-sdk/xai
Če uporabljaš TypeScript s shemami za validacijo (strukturirani izhodi), dodaj še Zod:
npm install ai @ai-sdk/xai zod
Konfiguracija
Ponudnik xAI samodejno prebere spremenljivko okolja XAI_API_KEY. Ustvari datoteko .env.local v korenski mapi svojega projekta:
XAI_API_KEY=xai-your-key-here
Generiranje besedila
Osnovna uporaba z 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);
Z zgodovino pogovora
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?' },
],
});
Pretakanje (Streaming)
Vercel AI SDK odlično obvlada pretakanje, kar je še posebej uporabno za odzivne uporabniške vmesnike:
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 ali Chat Completions
Pri trenutnih različicah (AI SDK 7 in @ai-sdk/xai 5) xai(model) uporablja Responses API podjetja xAI, ki ga xAI tudi priporoča: vsi zgornji primeri ga že uporabljajo, xai.responses(model) pa ti omogoča, da to eksplicitno navedeš. Ponudnik od različice 5 (september 2026) ne podpira več zastarele končne točke Chat Completions; če jo potrebuješ, uporabi OpenAI SDK, usmerjen na xAI (prejšnja lekcija).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// Responses API: kratka oblika ali eksplicitna
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.',
});
Integracija z Next.js
Vercel AI SDK je zasnovan tako, da najbolje deluje z Next.js. Tukaj je primer poti API s pretakanjem v formatu, ki ga pričakuje 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 }),
});
}
Stara metoda result.toDataStreamResponse() ne obstaja več; result.toUIMessageStreamResponse() v AI SDK 7 še deluje, vendar je označena kot zastarela.
Generiranje slik
Ponudnik xAI podpira tudi generiranje slik prek 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',
});
Slikovni model xAI ne sprejme parametra size: uporabi aspectRatio.
Kdaj izbrati ta SDK
Vercel AI SDK je jasna izbira, takoj ko delaš v spletnem okolju JavaScript ali TypeScript. Če tvoja aplikacija teče v Next.js, Nuxt, SvelteKit ali podobnem ogrodju, se popolnoma vključi v tvoje obstoječe delovno okolje s hooki in komponentami, zasnovanimi prav za ta okolja. Njegova najbolj opazna prednost je pretakanje v brskalnik: progresivni prikaz odgovorov, ki bi ga ročno kodiral s kompleksno kodo, tu deluje v nekaj vrsticah. Abstrakcija več ponudnikov (isti API za OpenAI, Anthropic in xAI) pa ga dela za najboljšo izbiro, ko želiš menjavati modele brez prepisovanja integracijske plasti: ponudnik xAI nadomesti drugega z eno samo vrstico uvoza.
Ključne ugotovitve
- Namesti
aiin@ai-sdk/xaiza izvorno podporo Grok - Ponudnik
xai()samodejno prebereXAI_API_KEY - Uporabi
generateTextza celotne odgovore instreamTextza pretakanje xai()uporablja Responses API; ponudnik od različice 5 ne podpira več Chat Completions