Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Vercel AI SDK priekš Grok

Nodarbība 7 no 14 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Grok JavaScript ekosistēmā
  2. Instalācija
  3. Konfigurācija
  4. Teksta ģenerēšana
  5. Straumēšana
  6. Responses API vai Chat Completions
  7. Integrācija ar Next.js
  8. Attēlu ģenerēšana
  9. Kad izvēlēties šo SDK
  10. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz AI SDK 7 un tā xAI nodrošinātāja dokumentāciju: xai() izmanto Responses API, bet @ai-sdk/xai nodrošinātāja 5. versija vairs neatbalsta Chat Completions; Next.js maršruts atgriež createUIMessageStreamResponse, un attēlu ģenerēšana notiek caur generateImage ar aspectRatio. Avoti: AI SDK, xAI nodrošinātājs · AI SDK, tērzēšanas robots.

Grok JavaScript ekosistēmā

Vercel AI SDK ir galvenais risinājums valodu modeļu integrēšanai JavaScript un TypeScript lietotnēs. xAI piedāvā speciālu nodrošinātāju (@ai-sdk/xai), kas integrējas natīvi ar SDK, nodrošinot vienmērīgu izstrādes pieredzi tīmekļa lietotnēs.

Instalācija

Instalē SDK un xAI nodrošinātāju:

npm install ai @ai-sdk/xai

Ja izmanto TypeScript ar validācijas shēmām (strukturēta izvade), pievieno Zod:

npm install ai @ai-sdk/xai zod

Konfigurācija

xAI nodrošinātājs automātiski nolasī XAI_API_KEY vides mainīgo. Izveido .env.local failu projekta saknē:

XAI_API_KEY=xai-your-key-here

Teksta ģenerēšana

Pamata lietojums ar 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);

Ar sarunu vēsturi

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?' },
  ],
});

Straumēšana

Vercel AI SDK izceļas ar straumēšanu, kas ir īpaši noderīga reaģējošām lietotāja saskarnēm:

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 vai Chat Completions

Ar pašreizējām versijām (AI SDK 7 un @ai-sdk/xai 5) xai(model) izmanto xAI Responses API, ko xAI iesaka: visi iepriekš minētie piemēri jau to izmanto, un xai.responses(model) ļauj to norādīt eksplicīti. Nodrošinātājs vairs neatbalsta veco Chat Completions galapunktu kopš 5. versijas (2026. gada septembris); ja tas tev ir nepieciešams, izmanto OpenAI SDK, kas norādīts uz xAI (iepriekšējā nodarbība).

import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';

// Responses API: īsā forma vai eksplicīta
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.',
});

Integrācija ar Next.js

Vercel AI SDK ir izstrādāts, lai vislabāk darbotos ar Next.js. Lūk, API maršruts ar straumēšanu formātā, ko sagaida useChat hooks no @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 }),
  });
}

Vecais result.toDataStreamResponse() vairs nepastāv; result.toUIMessageStreamResponse() AI SDK 7 vēl darbojas, bet ir novecojis.

Attēlu ģenerēšana

xAI nodrošinātājs atbalsta arī attēlu ģenerēšanu, izmantojot 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 attēlu modelis nepieņem parametru size: izmanto aspectRatio.

Kad izvēlēties šo SDK

Vercel AI SDK ir skaidra izvēle, tiklīdz strādā JavaScript vai TypeScript tīmekļa vidē. Ja tava lietotne darbojas Next.js, Nuxt, SvelteKit vai līdzīgā ietvarā, tā iederēsies tieši tur, kur jau strādā, ar hookiem un komponentēm, kas paredzēti šīm vidēm. Tā redzamākā stiprā puse ir straumēšana uz pārlūkprogrammu: pakāpeniska atbilžu attēlošana, kas, rakstot kodu ar rokām, ir sarežģīta, šeit darbojas dažās rindiņās. Un tās vairāku nodrošinātāju abstrakcija (viena un tā pati API priekš OpenAI, Anthropic un xAI) padara to par labāko izvēli, ja vēlies spēt mainīt modeļus, nepārrakstot integrācijas slāni: xAI nodrošinātājs aizstāj citu ar vienu importa rindiņu.

Galvenās atziņas

  • Instalē ai un @ai-sdk/xai, lai iegūtu natīvu Grok atbalstu
  • xai() nodrošinātājs automātiski nolasī XAI_API_KEY
  • Izmanto generateText pilnām atbildēm un streamText straumēšanai
  • xai() izmanto Responses API; nodrošinātājs vairs neatbalsta Chat Completions kopš 5. versijas