Vai al contenuto principale
Italiano— Scegli una lingua
Menu

L'SDK AI di Vercel per Grok

Lezione 7 di 14 Aggiornata il 3 novembre 2026 Sviluppatore
In questa pagina
  1. Grok nell’ecosistema JavaScript
  2. Installazione
  3. Configurazione
  4. Generazione di testo
  5. Streaming
  6. Responses API o Chat Completions
  7. Integrazione con Next.js
  8. Generazione di immagini
  9. Quando scegliere questo SDK
  10. Punti chiave

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/xai non supporta più le Chat Completions; la route di Next.js restituisce createUIMessageStreamResponse e la generazione di immagini avviene tramite generateImage con aspectRatio. 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 ai e @ai-sdk/xai per il supporto nativo a Grok
  • Il provider xai() legge automaticamente XAI_API_KEY
  • Usa generateText per risposte complete e streamText per lo streaming
  • xai() utilizza le Responses API; il provider non supporta più le Chat Completions dalla versione 5