Vercel AI SDK pentru Grok
Pe această pagină
Actualizat la 3 noiembrie 2026, pe baza documentației pentru AI SDK 7 și providerul său xAI:
xai()utilizează API-ul Responses, iar versiunea 5 a providerului@ai-sdk/xainu mai suportă Chat Completions; ruta Next.js returneazăcreateUIMessageStreamResponse, iar generarea de imagini se face pringenerateImagecuaspectRatio. Surse: AI SDK, provider xAI · AI SDK, Chatbot.
Grok în ecosistemul JavaScript
Vercel AI SDK este soluția preferată pentru integrarea modelelor lingvistice în aplicațiile JavaScript și TypeScript. xAI pune la dispoziție un provider dedicat (@ai-sdk/xai) care se integrează nativ cu SDK-ul, oferind o experiență de dezvoltare fluidă pentru aplicațiile web.
Instalare
Instalați SDK-ul și providerul xAI:
npm install ai @ai-sdk/xai
Dacă utilizați TypeScript cu scheme de validare (ieșiri structurate), adăugați Zod:
npm install ai @ai-sdk/xai zod
Configurare
Providerul xAI citește automat variabila de mediu XAI_API_KEY. Creați un fișier .env.local în rădăcina proiectului dumneavoastră:
XAI_API_KEY=xai-your-key-here
Generare de text
Utilizare de bază cu generateText:
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Explain the concept of serverless in 3 sentences.',
});
console.log(text);
Cu un istoric de conversație
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
const { text } = await generateText({
model: xai('grok-4.7'),
messages: [
{ role: 'system', content: 'You are a cloud architecture expert.' },
{ role: 'user', content: 'What are the benefits of serverless?' },
],
});
Streaming
Vercel AI SDK excelează la streaming, ceea ce este deosebit de util pentru interfețele de utilizator reactive:
import { streamText } from 'ai';
import { xai } from '@ai-sdk/xai';
const result = streamText({
model: xai('grok-4.7'),
prompt: 'Write an introduction to RESTful APIs.',
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
API-ul Responses sau Chat Completions
Cu versiunile curente (AI SDK 7 și @ai-sdk/xai 5), xai(model) trece prin API-ul Responses al xAI, cel recomandat de xAI: toate exemplele de mai sus îl utilizează deja, iar xai.responses(model) vă permite să specificați acest lucru explicit. Providerul nu mai suportă endpoint-ul legacy Chat Completions începând cu versiunea 5 (septembrie 2026); dacă aveți nevoie de el, utilizați SDK-ul OpenAI îndreptat către xAI (lecția anterioară).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// API-ul Responses: formă scurtă sau explicită
const { text } = await generateText({
model: xai('grok-4.7'),
prompt: 'Analyze the pros and cons of microservices.',
});
const explicit = await generateText({
model: xai.responses('grok-4.7'),
prompt: 'Same question, naming the API.',
});
Integrare cu Next.js
Vercel AI SDK este conceput pentru a funcționa optim cu Next.js. Iată o rută API cu streaming, în formatul așteptat de hook-ul useChat din @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 }),
});
}
Vechea metodă result.toDataStreamResponse() nu mai există; result.toUIMessageStreamResponse() funcționează încă în AI SDK 7, dar este depreciată.
Generare de imagini
Providerul xAI suportă, de asemenea, generarea de imagini, prin generateImage:
import { generateImage } from 'ai';
import { xai } from '@ai-sdk/xai';
const { image } = await generateImage({
model: xai.image('grok-imagine-image'),
prompt: 'A futuristic city at sunset',
aspectRatio: '16:9',
});
Modelul de imagini xAI nu acceptă parametrul size: utilizați aspectRatio.
Când să alegeți acest SDK
Vercel AI SDK este alegerea evidentă imediat ce lucrați în mediul web JavaScript sau TypeScript. Dacă aplicația dumneavoastră rulează pe Next.js, Nuxt, SvelteKit sau un framework comparabil, se integrează perfect în fluxul dumneavoastră de lucru existent, oferind hook-uri și componente concepute special pentru aceste medii. Cel mai vizibil punct forte este streaming-ul către browser: afișarea progresivă a răspunsurilor, care necesită în mod normal cod complex scris manual, funcționează aici în doar câteva linii. Abstracția multi-provider (aceeași API pentru OpenAI, Anthropic și xAI) îl face alegerea ideală atunci când doriți să puteți schimba modelele fără a rescrie stratul de integrare: providerul xAI înlocuiește un alt provider printr-o singură linie de import.
Puncte cheie
- Instalați
aiși@ai-sdk/xaipentru suport nativ Grok - Providerul
xai()citește automatXAI_API_KEY - Utilizați
generateTextpentru răspunsuri complete șistreamTextpentru streaming xai()utilizează API-ul Responses; providerul nu mai suportă Chat Completions începând cu versiunea 5