Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Verceli tehisintellekti SDK Groki jaoks

Õppetund 7 / 14 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Grok JavaScripti ökosüsteemis
  2. Paigaldamine
  3. Seadistamine
  4. Teksti genereerimine
  5. Voogedastus (Streaming)
  6. Responses API või Chat Completions
  7. Integreerimine Next.js-iga
  8. Pildigeneratsioon
  9. Millal valida see SDK
  10. Peamised punktid

Uuendatud 3. novembril 2026, tuginedes AI SDK 7 ja selle xAI pakkuja dokumentatsioonile: xai() kasutab Responses API-t ning @ai-sdk/xai pakkuja versioon 5 ei toeta enam Chat Completionsi; Next.js’i ruut tagastab createUIMessageStreamResponse ja pildigeneratsioon toimub funktsiooni generateImage kaudu parameetriga aspectRatio. Allikad: AI SDK, xAI pakkuja · AI SDK, vestlusrobot.

Grok JavaScripti ökosüsteemis

Verceli tehisintellekti SDK on esmane lahendus keelemudelite integreerimiseks JavaScripti ja TypeScripti rakendustesse. xAI pakub spetsiaalset pakkujat (@ai-sdk/xai), mis integreerub SDK-ga loomulikult, tagades sujuva arenduskogemuse veebirakendustes.

Paigaldamine

Paigalda SDK ja xAI pakkuja:

npm install ai @ai-sdk/xai

Kui kasutad TypeScripti koos valideerimisskeemidega (struktureeritud väljundid), lisa Zod:

npm install ai @ai-sdk/xai zod

Seadistamine

xAI pakkuja loeb automaatselt keskkonnamuutuja XAI_API_KEY. Loo oma projekti juurkausta fail .env.local:

XAI_API_KEY=xai-your-key-here

Teksti genereerimine

Põhikasutus funktsiooniga generateText:

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

const { text } = await generateText({
  model: xai('grok-4.7'),
  prompt: 'Selgita serverita arhitektuuri mõistet kolmes lauses.',
});

console.log(text);

Vestlusajalooga

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

const { text } = await generateText({
  model: xai('grok-4.7'),
  messages: [
    { role: 'system', content: 'Sa oled pilvearhitektuuri ekspert.' },
    { role: 'user', content: 'Millised on serverita arhitektuuri eelised?' },
  ],
});

Voogedastus (Streaming)

Verceli tehisintellekti SDK hiilgab voogedastuse poolest, mis on eriti kasulik reageerimisvõimeliste kasutajaliideste loomisel:

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

const result = streamText({
  model: xai('grok-4.7'),
  prompt: 'Kirjuta sissejuhatus RESTful API-de teemasse.',
});

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

Responses API või Chat Completions

Praeguste versioonide (AI SDK 7 ja @ai-sdk/xai 5) puhul kasutab xai(model) xAI Responses API-t, mida xAI soovitab: kõik ülaltoodud näited kasutavad seda juba ja xai.responses(model) võimaldab seda sõnaselgelt määrata. Pakkuja ei ole alates 5. versioonist (september 2026) enam toetanud vananenud Chat Completionsi lõpppunkti; kui sul on seda vaja, kasuta xAI-le suunatud OpenAI SDK-d (eelmine õppetund).

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

// Responses API: lühivorm või sõnaselge
const { text } = await generateText({
  model: xai('grok-4.7'),
  prompt: 'Analüüsi mikroteenuste plusse ja miinuseid.',
});

const explicit = await generateText({
  model: xai.responses('grok-4.7'),
  prompt: 'Sama küsimus, nimetades API-d.',
});

Integreerimine Next.js-iga

Verceli tehisintellekti SDK on loodud toimimaks kõige paremini Next.js-iga. Siin on API ruut voogedastusega vormingus, mida ootab useChat konks paketist @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 }),
  });
}

Vana result.toDataStreamResponse() enam ei eksisteeri; result.toUIMessageStreamResponse() töötab küll AI SDK 7-s, kuid on aegunud.

Pildigeneratsioon

xAI pakkuja toetab ka pildigeneratsiooni funktsiooni generateImage kaudu:

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

const { image } = await generateImage({
  model: xai.image('grok-imagine-image'),
  prompt: 'Futuristlik linn päikeseloojangul',
  aspectRatio: '16:9',
});

xAI pildimudel ei võta vastu parameetrit size: kasuta aspectRatio.

Millal valida see SDK

Verceli tehisintellekti SDK on selge valik niipea, kui töötad JavaScripti või TypeScripti veebis. Kui sinu rakendus jookseb Next.js-is, Nuxtis, SvelteKitis või sarnases raamistikus, sobitub see otse sinu olemasolevasse töökeskkonda, pakkudes nende keskkondade jaoks loodud konkse ja komponente. Selle kõige nähtavam tugevus on voogedastus brauserisse: vastuste järkjärguline kuvamine, mis käsitsi kodeerimisel on keeruline, toimib siin mõne reaga. Samuti teeb selle mitme pakkuja abstraktsioon (sama API OpenAI, Anthropicu ja xAI jaoks) sellest parima valiku, kui soovid mudelite vahetamist ilma integratsioonikihti ümber kirjutamata: xAI pakkuja asendab teise ühe impordireaga.

Peamised punktid

  • Paigalda ai ja @ai-sdk/xai Groki loomulikuks toetuseks
  • Pakkuja xai() loeb automaatselt muutuja XAI_API_KEY
  • Kasuta generateText täielike vastuste jaoks ja streamText voogedastuse jaoks
  • xai() kasutab Responses API-t; pakkuja ei ole alates 5. versioonist enam toetanud Chat Completionsi