L'SDK AI di Vercel per Grok
In questa pagina
Aggiornato il 3 novembre 2026, sulla base della documentazione per AI SDK 7 e il suo provider xAI:
xai()utilizza le Responses API e la versione 5 del provider@ai-sdk/xainon supporta più le Chat Completions; la route di Next.js restituiscecreateUIMessageStreamResponsee la generazione di immagini avviene tramitegenerateImageconaspectRatio. Fonti: AI SDK, provider xAI · AI SDK, Chatbot.
Grok nell’ecosistema JavaScript
L’SDK AI di Vercel è la soluzione di riferimento per integrare modelli linguistici nelle applicazioni JavaScript e TypeScript. xAI mette a disposizione un provider dedicato (@ai-sdk/xai) che si integra nativamente con l’SDK, garantendo un’esperienza di sviluppo fluida nelle app web.
Installazione
Installa l’SDK e il provider xAI:
npm install ai @ai-sdk/xai
Se utilizzi TypeScript con schemi di validazione (output strutturati), aggiungi Zod:
npm install ai @ai-sdk/xai zod
Configurazione
Il provider xAI legge automaticamente la variabile d’ambiente XAI_API_KEY. Crea un file .env.local alla radice del tuo progetto:
XAI_API_KEY=xai-your-key-here
Generazione di testo
Utilizzo base con 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);
Con una cronologia di conversazione
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
L’SDK AI di Vercel eccelle nello streaming, particolarmente utile per interfacce utente reattive:
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);
}
Responses API o Chat Completions
Con le versioni attuali (AI SDK 7 e @ai-sdk/xai 5), xai(model) passa attraverso le Responses API di xAI, quelle raccomandate da xAI: tutti gli esempi sopra le utilizzano già, e xai.responses(model) ti permette di dichiararlo esplicitamente. Il provider non supporta più il vecchio endpoint Chat Completions dalla versione 5 (settembre 2026); se ne hai bisogno, usa l’SDK OpenAI puntato su xAI (lezione precedente).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// Responses API: forma breve, o esplicita
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.',
});
Integrazione con Next.js
L’SDK AI di Vercel è progettato per funzionare al meglio con Next.js. Ecco una route API con streaming, nel formato atteso dall’hook useChat di @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 vecchio result.toDataStreamResponse() non esiste più; result.toUIMessageStreamResponse() funziona ancora in AI SDK 7 ma è deprecato.
Generazione di immagini
Il provider xAI supporta anche la generazione di immagini, tramite 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',
});
Il modello di immagini di xAI non accetta un parametro size: usa aspectRatio.
Quando scegliere questo SDK
L’SDK AI di Vercel è la scelta ovvia non appena lavori sul web con JavaScript o TypeScript. Se la tua app gira su Next.js, Nuxt, SvelteKit o un framework comparabile, si inserisce perfettamente dove già lavori, con hook e componenti progettati per quegli ambienti. Il suo punto di forza più evidente è lo streaming verso il browser: la visualizzazione progressiva delle risposte, che a mano richiederebbe codice complesso, qui funziona in poche righe. Inoltre, la sua astrazione multi-provider (la stessa API per OpenAI, Anthropic e xAI) lo rende la scelta migliore quando vuoi poter cambiare modello senza riscrivere il tuo livello di integrazione: il provider xAI sostituisce un altro con una singola riga di importazione.
Punti chiave
- Installa
aie@ai-sdk/xaiper il supporto nativo a Grok - Il provider
xai()legge automaticamenteXAI_API_KEY - Usa
generateTextper risposte complete estreamTextper lo streaming xai()utilizza le Responses API; il provider non supporta più le Chat Completions dalla versione 5