Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Vercel AI SDK, skirta Grok

Paskaita 7 iš 14 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Grok JavaScript ekosistemoje
  2. Diegimas
  3. Konfigūracija
  4. Teksto generavimas
  5. Srautinis perdavimas (Streaming)
  6. Responses API arba Chat Completions
  7. Integracija su Next.js
  8. Vaizdų generavimas
  9. Kada rinktis šį SDK
  10. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 3 d., remiantis AI SDK 7 ir jo xAI tiekėjo dokumentacija: xai() naudoja Responses API, o @ai-sdk/xai tiekėjo 5 versija nebepalaiko Chat Completions; Next.js maršrutas grąžina createUIMessageStreamResponse, o vaizdų generavimas vyksta per generateImage su aspectRatio. Š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 ai ir @ai-sdk/xai, kad turėtumėte natūralią Grok supportą
  • xai() tiekėjas automatiškai nuskoito XAI_API_KEY
  • Naudokite generateText pilniems atsakymams ir streamText srautiniam perdavimui
  • xai() naudoja Responses API; tiekėjas nebepalaiko Chat Completions nuo 5 versijos