Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Vercel AI SDK za Grok

Lekcija 7 od 14 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Grok v ekosistemu JavaScript
  2. Namestitev
  3. Konfiguracija
  4. Generiranje besedila
  5. Pretakanje (Streaming)
  6. Responses API ali Chat Completions
  7. Integracija z Next.js
  8. Generiranje slik
  9. Kdaj izbrati ta SDK
  10. Ključne ugotovitve

Posodobljeno 3. novembra 2026 na podlagi dokumentacije za AI SDK 7 in ponudnika xAI: xai() uporablja Responses API, različica 5 ponudnika @ai-sdk/xai pa ne podpira več Chat Completions; pot Next.js vrača createUIMessageStreamResponse, generiranje slik pa poteka prek generateImage s parametrom aspectRatio. 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 ai in @ai-sdk/xai za izvorno podporo Grok
  • Ponudnik xai() samodejno prebere XAI_API_KEY
  • Uporabi generateText za celotne odgovore in streamText za pretakanje
  • xai() uporablja Responses API; ponudnik od različice 5 ne podpira več Chat Completions