Vercel AI SDK Grokia varten
Tällä sivulla
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 palauttaacreateUIMessageStreamResponse-funktion, ja kuvagenerointi tapahtuugenerateImage-funktiolla käyttäenaspectRatio-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
aija@ai-sdk/xaisaadaksesi natiivin Grok-tuen xai()-provider lukee automaattisestiXAI_API_KEY-avaimen- Käytä
generateText-funktiota kokonaisiin vastauksiin jastreamText-funktiota striimaukseen xai()käyttää Responses APIa; provideri ei ole enää tukenut Chat Completionsia versiosta 5 lähtien