Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

L-SDK tal-AI ta' Vercel għal Grok

Lezzjoni 7 / 14 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Grok fl-ekosistema JavaScript
  2. Installazzjoni
  3. Konfigurazzjoni
  4. Iġġenera test
  5. Streaming
  6. Responses API jew Chat Completions
  7. Integrazzjoni ma’ Next.js
  8. Ġenerazzjoni tal-immaġini
  9. Meta tagħżel dan l-SDK
  10. Punti Ewlenin

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/xai ma tappoġġjax iktar il-Chat Completions; ir-rotta tan-Next.js tirritorna createUIMessageStreamResponse, u l-ġenerazzjoni tal-immaġini tgħaddi minn generateImage b’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 ai u @ai-sdk/xai għal appoġġ nativ għal Grok
  • Il-fornitur xai() jaqra awtomatikament XAI_API_KEY
  • Uża generateText għal tweġibiet sħaħ u streamText għall-istreaming
  • xai() juża r-Responses API; il-fornitur ma għadux jappoġġja l-Chat Completions mill-verżjoni 5