Verceli tehisintellekti SDK Groki jaoks
Sellel lehel
Uuendatud 3. novembril 2026, tuginedes AI SDK 7 ja selle xAI pakkuja dokumentatsioonile:
xai()kasutab Responses API-t ning@ai-sdk/xaipakkuja versioon 5 ei toeta enam Chat Completionsi; Next.js’i ruut tagastabcreateUIMessageStreamResponseja pildigeneratsioon toimub funktsioonigenerateImagekaudu parameetrigaaspectRatio. 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
aija@ai-sdk/xaiGroki loomulikuks toetuseks - Pakkuja
xai()loeb automaatselt muutujaXAI_API_KEY - Kasuta
generateTexttäielike vastuste jaoks jastreamTextvoogedastuse jaoks xai()kasutab Responses API-t; pakkuja ei ole alates 5. versioonist enam toetanud Chat Completionsi