Vercel AI SDK, skirta Grok
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 3 d., remiantis AI SDK 7 ir jo xAI tiekėjo dokumentacija:
xai()naudoja Responses API, o@ai-sdk/xaitiekėjo 5 versija nebepalaiko Chat Completions; Next.js maršrutas grąžinacreateUIMessageStreamResponse, o vaizdų generavimas vyksta pergenerateImagesuaspectRatio. Šaltiniai: AI SDK, xAI tiekėjas · AI SDK, Chatbot.
Grok JavaScript ekosistemoje
Vercel AI SDK yra pagrindinis sprendimas integruojant kalbos modelius į JavaScript ir TypeScript programas. xAI suteikia specializuotą tiekėją (@ai-sdk/xai), kuris natūraliai integruojasi su SDK, užtikrindamas sklandžią kūrimo patirtį žiniatinklio programose.
Diegimas
Įdiekite SDK ir xAI tiekėją:
npm install ai @ai-sdk/xai
Jei naudojate TypeScript su validavimo schemomis (struktūrizuota išvestis), pridėkite Zod:
npm install ai @ai-sdk/xai zod
Konfigūracija
xAI tiekėjas automatiškai nuskoito XAI_API_KEY aplinkos kintamąjį. Sukurkite .env.local failą savo projekto šaknyje:
XAI_API_KEY=xai-your-key-here
Teksto generavimas
Pagrindinis naudojimas su 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);
Su pokalbio istorija
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?' },
],
});
Srautinis perdavimas (Streaming)
Vercel AI SDK puikiai tvarko srautinį perdavimą, kas ypač naudinga kuriant reaguojačias vartotojo sąsajas:
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 arba Chat Completions
Naujausiose versijose (AI SDK 7 ir @ai-sdk/xai 5), xai(model) naudoja xAI Responses API, kurį rekomenduoja pats xAI: visi aukščiau pateikti pavyzdžiai jau jį naudoja, o xai.responses(model) leidžia tai nurodyti aiškiai. Nuo 5 versijos (2026 m. rugsėjis) tiekėjas nebepalaiko senosios Chat Completions galutinės punkto; jei jums jo reikia, naudokite OpenAI SDK, nukreiptą į xAI (ankstesnė pamoka).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// Responses API: trumpa forma arba aiški
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 su Next.js
Vercel AI SDK sukurtas taip, kad geriausiai veiktų su Next.js. Štai API maršrutas su srautiniu perdavimu, formatu, kurio tikisi useChat kabliukas iš @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 }),
});
}
Senasis result.toDataStreamResponse() nebeegzistuoja; result.toUIMessageStreamResponse() vis dar veikia AI SDK 7 versijoje, bet yra pasenęs.
Vaizdų generavimas
xAI tiekėjas taip pat palaiko vaizdų generavimą naudojant 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',
});
xAI vaizdų modelis nepriima size parametro: naudokite aspectRatio.
Kada rinktis šį SDK
Vercel AI SDK yra akivaizdus pasirinkimas, kai dirbate su JavaScript arba TypeScript žiniatinklyje. Jei jūsų programa veikia su Next.js, Nuxt, SvelteKit ar panašia sistema, ji puikiai įsiterpia į jūsų dabartinę darbo aplinką, siūlydama specialiai šiems kontekstams sukurtus kabliukus ir komponentus. Didžiausias jos privalumas – srautinis duomenų perdavimas į naršyklę: laipsniškas atsakymų rodymas, kuris rankiniu būdu reikalautų sudėtingo kodo, čia veikia vos keliomis eilutėmis. Be to, abstrakcija, leidžianti naudoti kelis tiekėjus (tą pačią API OpenAI, Anthropic ir xAI), daro jį geriausiu pasirinkimu, kai norite galėti keisti modelius neperrašydami integracijos sluoksnio: xAI tiekėjas pakeičia kitą tiekėją viena importavimo eilute.
Svarbiausi punktai
- Įdiekite
aiir@ai-sdk/xai, kad turėtumėte natūralią Grok supportą xai()tiekėjas automatiškai nuskoitoXAI_API_KEY- Naudokite
generateTextpilniems atsakymams irstreamTextsrautiniam perdavimui xai()naudoja Responses API; tiekėjas nebepalaiko Chat Completions nuo 5 versijos