Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Vercel AI SDK Grokia varten

Oppitunti 7 / 14 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Grok JavaScript-ekosysteemissä
  2. Asennus
  3. Konfiguraatio
  4. Tekstin generointi
  5. Striimaus
  6. Responses API vai Chat Completions
  7. Integrointi Next.js:ään
  8. Kuvagenerointi
  9. Milloin valita tämä SDK
  10. Keskeiset asiat

Päivitetty 3. marraskuuta 2026 AI SDK 7:n ja sen xAI-providerin dokumentaation perusteella: xai() käyttää Responses APIa, eikä @ai-sdk/xai-providerin versio 5 enää tue Chat Completionsia; Next.js-reitti palauttaa createUIMessageStreamResponse-funktion, ja kuvagenerointi tapahtuu generateImage-funktiolla käyttäen aspectRatio-parametria. Lähteet: AI SDK, xAI-provider · AI SDK, Chatbot.

Grok JavaScript-ekosysteemissä

Vercel AI SDK on ensisijainen ratkaisu kielimallien integroimiseksi JavaScript- ja TypeScript-sovelluksiin. xAI tarjoaa omistetun providerin (@ai-sdk/xai), joka integroituu natiivisti SDK:hon tarjoten sujuvan kehityskokemuksen web-sovelluksissa.

Asennus

Asenna SDK ja xAI-provider:

npm install ai @ai-sdk/xai

Jos käytät TypeScriptiä validointiskaemojen (jäsennellyt tulosteet) kanssa, lisää Zod:

npm install ai @ai-sdk/xai zod

Konfiguraatio

xAI-provider lukee automaattisesti XAI_API_KEY-ympäristömuuttujan. Luo .env.local-tiedosto projektisi juureen:

XAI_API_KEY=xai-your-key-here

Tekstin generointi

Peruskäyttö generateText-funktiolla:

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

const { text } = await generateText({
  model: xai('grok-4.7'),
  prompt: 'Selitä serverless-konsepti kolmella lauseella.',
});

console.log(text);

Keskusteluhistorian kanssa

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

const { text } = await generateText({
  model: xai('grok-4.7'),
  messages: [
    { role: 'system', content: 'Olet pilviarkkitehtuurin asiantuntija.' },
    { role: 'user', content: 'Mitkä ovat serverless-arkkitehtuurin edut?' },
  ],
});

Striimaus

Vercel AI SDK loistaa striimausominaisuuksillaan, mikä on erityisen hyödyllistä responsiivisissa käyttöliittymissä:

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

const result = streamText({
  model: xai('grok-4.7'),
  prompt: 'Kirjoita johdanto RESTful API -rajapintoihin.',
});

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

Responses API vai Chat Completions

Nykyisillä versioilla (AI SDK 7 ja @ai-sdk/xai 5) xai(model) käyttää xAI:n Responses APIa, jota xAI suosittelee: kaikki yllä olevat esimerkit käyttävät sitä jo, ja xai.responses(model) antaa sinun ilmaista tämän eksplisiittisesti. Provideri ei ole enää tukenut vanhentunutta Chat Completions -päätepistettä versiosta 5 (syyskuu 2026) lähtien; jos tarvitset sitä, käytä xAI:hon osoitettua OpenAI SDK:ta (edellinen oppitunti).

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

// Responses API: lyhyt muoto tai eksplisiittinen
const { text } = await generateText({
  model: xai('grok-4.7'),
  prompt: 'Analysoi mikropalvelujen hyvät ja huonot puolet.',
});

const explicit = await generateText({
  model: xai.responses('grok-4.7'),
  prompt: 'Sama kysymys, nimeämällä API.',
});

Integrointi Next.js:ään

Vercel AI SDK on suunniteltu toimimaan parhaiten Next.js:n kanssa. Tässä on API-reitti striimauksella muodossa, jonka @ai-sdk/react-paketin useChat-hookki odottaa:

// 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 }),
  });
}

Vanhaa result.toDataStreamResponse()-metodia ei enää ole olemassa; result.toUIMessageStreamResponse() toimii edelleen AI SDK 7:ssä, mutta se on vanhentunut.

Kuvagenerointi

xAI-provider tukee myös kuvagenerointia generateImage-funktiolla:

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

const { image } = await generateImage({
  model: xai.image('grok-imagine-image'),
  prompt: 'Futuristinen kaupunki auringonlaskussa',
  aspectRatio: '16:9',
});

xAI:n kuvamalli ei hyväksy size-parametria: käytä sen sijaan aspectRatio-parametria.

Milloin valita tämä SDK

Vercel AI SDK on selkeä valinta heti, kun työskentelet JavaScript- tai TypeScript-pohjaisessa web-ympäristössä. Jos sovelluksesi pyörii Next.js:ssä, Nuxtissa, SvelteKitissä tai vastaavassa kehyksessä, se istuu saumattomasti siihen ympäristöön, jossa jo työskentelet, tarjoten näihin ympäristöihin suunniteltuja hookkeja ja komponentteja. Sen näkyvin vahvuus on striimaus selaimeen: vastausten progressiivinen näyttö, joka vaatii manuaalisesti toteutettuna monimutkaista koodia, toimii tässä muutamalla rivillä. Lisäksi sen monen providerin abstraktio (sama API OpenAI:lle, Anthropicille ja xAI:lle) tekee siitä parhaan valinnan, kun haluat pystyä vaihtamaan malleja kirjoittamatta integraatiokerrostasi uudelleen: xAI-provider korvaa toisen providerin yhdellä import-lauseella.

Keskeiset asiat

  • Asenna ai ja @ai-sdk/xai saadaksesi natiivin Grok-tuen
  • xai()-provider lukee automaattisesti XAI_API_KEY-avaimen
  • Käytä generateText-funktiota kokonaisiin vastauksiin ja streamText-funktiota striimaukseen
  • xai() käyttää Responses APIa; provideri ei ole enää tukenut Chat Completionsia versiosta 5 lähtien