L-SDK tal-AI ta' Vercel għal Grok
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026, ibbażat fuq id-dokumentazzjoni għall-AI SDK 7 u l-fornitur xAI tiegħu:
xai()juża r-Responses API, u l-verżjoni 5 tal-fornitur@ai-sdk/xaima tappoġġjax iktar il-Chat Completions; ir-rotta tan-Next.js tirritornacreateUIMessageStreamResponse, u l-ġenerazzjoni tal-immaġini tgħaddi minngenerateImageb’aspectRatio. Sorsi: AI SDK, fornitur xAI · AI SDK, Chatbot.
Grok fl-ekosistema JavaScript
L-SDK tal-AI ta’ Vercel huwa s-soluzzjoni preferuta biex tintegra mudelli tal-lingwa f’applikazzjonijiet JavaScript u TypeScript. xAI jipprovdi fornitur iddedikat (@ai-sdk/xai) li jintegra nativament mal-SDK, għal esperjenza ta’ żvilupp fluwida f’applikazzjonijiet web.
Installazzjoni
Installa l-SDK u l-fornitur xAI:
npm install ai @ai-sdk/xai
Jekk tuża TypeScript ma’ skemi ta’ validazzjoni (outputs strutturati), żid Zod:
npm install ai @ai-sdk/xai zod
Konfigurazzjoni
Il-fornitur xAI jaqra awtomatikament il-varjabbli tal-ambjent XAI_API_KEY. Oħloq fajl .env.local fir-raġġ tal-proġett tiegħek:
XAI_API_KEY=xai-your-key-here
Iġġenera test
Użu bażiku b’generateText:
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Spjega l-kunċett ta' serverless f'3 sentenzi.',
});
console.log(text);
B’storja ta’ konversazzjoni
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
messages: [
{ role: 'system', content: 'Inti espert fl-arkitettura tal-cloud.' },
{ role: 'user', content: 'X'inhuma l-benefiċċji tas-serverless?' },
],
});
Streaming
L-SDK tal-AI ta’ Vercel jeċċelli fl-istreaming, li huwa partikolarment utli għal interfaċċji tal-utent reattivi:
import { streamText } from 'ai';
import { xai } from '@ai-sdk/xai';
const result = streamText({
model: xai('grok-4.7'),
prompt: 'Ikteb introduzzjoni għall-APIs RESTful.',
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Responses API jew Chat Completions
B’verżjonijiet attwali (AI SDK 7 u @ai-sdk/xai 5), xai(model) jgħaddi mir-Responses API ta’ xAI, dik li tirrakkomanda xAI: l-eżempji kollha ta’ hawn fuq diġà jużawha, u xai.responses(model) jħallik tgħid hekk b’mod espliċitu. Il-fornitur ma għadux jappoġġja l-endpoint antik tal-Chat Completions mill-verżjoni 5 (Settembru 2026); jekk għandek bżonnu, uża l-SDK ta’ OpenAI ppuntat lejn xAI (lezzjoni preċedenti).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// Responses API: forma qasira, jew espliċita
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Analizza l-pros u l-kontra tal-mikroservizzi.',
});
const explicit = await generateText({
model: xai.responses('grok-4.7'),
prompt: 'L-istess mistoqsija, billi tsemmi l-API.',
});
Integrazzjoni ma’ Next.js
L-SDK tal-AI ta’ Vercel huwa ddisinjat biex jaħdem l-aħjar ma’ Next.js. Hawnhekk hemm rotta API b’istreaming, fil-format li jistenna l-hook useChat minn @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 }),
});
}
Il-metodu antik result.toDataStreamResponse() ma jeżistix iktar; result.toUIMessageStreamResponse() għadu jaħdem fl-AI SDK 7 iżda huwa deprekat.
Ġenerazzjoni tal-immaġini
Il-fornitur xAI jappoġġja wkoll il-ġenerazzjoni tal-immaġini, b’generateImage:
import { generateImage } from 'ai';
import { xai } from '@ai-sdk/xai';
const { image } = await generateImage({
model: xai.image('grok-imagine-image'),
prompt: 'Belt futuristika waqt in-niżla tax-xemx',
aspectRatio: '16:9',
});
Il-mudell tal-immaġini ta’ xAI ma jaċċettax parametru size: uża aspectRatio.
Meta tagħżel dan l-SDK
L-SDK tal-AI ta’ Vercel huwa l-għażla ċara malli tibda taħdem fuq il-web b’JavaScript jew TypeScript. Jekk l-app tiegħek toqgħod f’Next.js, Nuxt, SvelteKit, jew framework komparabbli, dan joqgħod eżatt fejn diġà taħdem, b’hooks u komponenti ddisinjati għal dawk l-ambjenti. L-aktar punt qawwi viżibbli tiegħu huwa l-istreaming lejn il-browser: wiri progressiv tat-tweġibiet, li jieħu kodiċi diffiċli biex tagħmlu bl-idejn, jaħdem hawnhekk f’ftit linji. U l-astrazzjoni multi-fornitur tiegħu (l-istess API għal OpenAI, Anthropic, u xAI) tagħmlu l-aħjar għażla meta trid tkun tista’ tbiddel il-mudelli mingħajr ma tikteb mill-ġdid is-saff ta’ integrazzjoni tiegħek: il-fornitur xAI jissostitwixxi ieħor b’linja waħda ta’ importazzjoni.
Punti Ewlenin
- Installa
aiu@ai-sdk/xaigħal appoġġ nativ għal Grok - Il-fornitur
xai()jaqra awtomatikamentXAI_API_KEY - Uża
generateTextgħal tweġibiet sħaħ ustreamTextgħall-istreaming xai()juża r-Responses API; il-fornitur ma għadux jappoġġja l-Chat Completions mill-verżjoni 5