Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Vercel AI SDK za Grok

Lekcija 7 od 14 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Grok u JavaScript ekosustavu
  2. Instalacija
  3. Konfiguracija
  4. Generiranje teksta
  5. Strujanje (Streaming)
  6. Responses API ili Chat Completions
  7. Integracija s Next.js
  8. Generiranje slika
  9. Kada odabrati ovaj SDK
  10. Ključne točke

Ažurirano 3. studenoga 2026., na temelju dokumentacije za AI SDK 7 i njegovog xAI pružatelja usluga: xai() koristi Responses API, a verzija 5 pružatelja usluga @ai-sdk/xai više ne podržava Chat Completions; Next.js ruta vraća createUIMessageStreamResponse, a generiranje slika odvija se putem generateImage s parametrom aspectRatio. Izvori: AI SDK, xAI provider · AI SDK, Chatbot.

Grok u JavaScript ekosustavu

Vercel AI SDK najbolje je rješenje za integraciju jezičnih modela u JavaScript i TypeScript aplikacije. xAI nudi namjenskog pružatelja usluga (@ai-sdk/xai) koji se izvorno integrira sa SDK-om, osiguravajući glatko razvojno iskustvo u web aplikacijama.

Instalacija

Instaliraj SDK i xAI pružatelja usluga:

npm install ai @ai-sdk/xai

Ako koristiš TypeScript sa shemama za validaciju (strukturirani izlazi), dodaj Zod:

npm install ai @ai-sdk/xai zod

Konfiguracija

xAI pružatelj usluga automatski čita varijablu okruženja XAI_API_KEY. Stvori datoteku .env.local u korijenu svog projekta:

XAI_API_KEY=xai-your-key-here

Generiranje teksta

Osnovna upotreba s generateText:

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

const { text } = await generateText({
  model: xai('grok-4.7'),
  prompt: 'Objasni koncept serverless arhitekture u 3 rečenice.',
});

console.log(text);

S poviješću razgovora

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

const { text } = await generateText({
  model: xai('grok-4.7'),
  messages: [
    { role: 'system', content: 'Ti si stručnjak za cloud arhitekturu.' },
    { role: 'user', content: 'Koje su prednosti serverless pristupa?' },
  ],
});

Strujanje (Streaming)

Vercel AI SDK izvrsno rukuje strujanjem, što je posebno korisno za responzivna korisnička sučelja:

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

const result = streamText({
  model: xai('grok-4.7'),
  prompt: 'Napiši uvod u RESTful API-je.',
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}

Responses API ili Chat Completions

S trenutnim verzijama (AI SDK 7 i @ai-sdk/xai 5), xai(model) koristi xAI-jev Responses API, koji xAI preporučuje: svi gornji primjeri već ga koriste, a xai.responses(model) ti omogućuje da to eksplicitno navedeš. Pružatelj usluga više ne podržava zastarjelu krajnju točku Chat Completions od verzije 5 (rujan 2026.); ako ti je potrebna, koristi OpenAI SDK usmjeren na xAI (prethodna lekcija).

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

// Responses API: kratki oblik ili eksplicitni
const { text } = await generateText({
  model: xai('grok-4.7'),
  prompt: 'Analiziraj prednosti i mane mikrouslužba.',
});

const explicit = await generateText({
  model: xai.responses('grok-4.7'),
  prompt: 'Isto pitanje, uz navođenje API-ja.',
});

Integracija s Next.js

Vercel AI SDK dizajniran je za optimalan rad s Next.js frameworkom. Evo API rute sa strujanjem, u formatu koji očekuje 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 }),
  });
}

Stari result.toDataStreamResponse() više ne postoji; result.toUIMessageStreamResponse() još uvijek radi u AI SDK 7, ali je zastario.

Generiranje slika

xAI pružatelj usluga također podržava generiranje slika putem generateImage:

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

const { image } = await generateImage({
  model: xai.image('grok-imagine-image'),
  prompt: 'Futuristički grad u zalazak sunca',
  aspectRatio: '16:9',
});

xAI-jev model za slike ne prihvaća parametar size: koristi aspectRatio.

Kada odabrati ovaj SDK

Vercel AI SDK jasan je izbor čim radiš na JavaScript ili TypeScript webu. Ako tvoja aplikacija živi u Next.js, Nuxt, SvelteKit ili sličnom frameworku, savršeno se uklapa u tvoje postojeće okruženje, s hookovima i komponentama dizajniranima za te platforme. Njegova najvidljivija snaga je strujanje prema pregledniku: progresivni prikaz odgovora, koji bi ručno pisanjem koda bio složen, ovdje radi u nekoliko redaka. Osim toga, njegova apstrakcija višestrukih pružatelja usluga (isti API za OpenAI, Anthropic i xAI) čini ga najboljim izborom kada želiš moći mijenjati modele bez prepisivanja sloja za integraciju: xAI pružatelj usluga zamjenjuje drugi jednim retkom za uvoz.

Ključne točke

  • Instaliraj ai i @ai-sdk/xai za izvornu podršku Groku
  • Pružatelj usluga xai() automatski čita XAI_API_KEY
  • Koristi generateText za kompletne odgovore, a streamText za strujanje
  • xai() koristi Responses API; pružatelj usluga više ne podržava Chat Completions od verzije 5