Vercel AI SDK en frontend-integratie
Op deze pagina
Bijgewerkt op 3 november 2026 op basis van de AI SDK 7-documentatie (
ai7.0.x,@ai-sdk/react4.x):useChatwerkt metDefaultChatTransportensendMessage, berichten worden weergegeven viaparts, de route retourneertcreateUIMessageStreamResponse,systemwordtinstructions, en de@ai-sdk/xai5-provider ondersteunt geen Chat Completions meer:xai()gebruikt de Responses API (code geverifieerd met TypeScript-compiler gebruikmakend vanai7.0.162 en@ai-sdk/xai5.0.38). De vorige versie gebruikte de AI SDK 4-API (input,handleSubmit,isLoading,toDataStreamResponse). Bronnen: AI SDK, Chatbot · AI SDK, xAI-provider.
De Vercel AI SDK voor webapplicaties
De Vercel AI SDK is een TypeScript-framework ontworpen om AI-modellen te integreren in webapplicaties. Het biedt React-hooks, streaming-hulpmiddelen en een uniforme abstractie die xAI/Grok native ondersteunt via het @ai-sdk/xai-pakket.
Als u een Next.js-, Nuxt-, SvelteKit- of andere React-applicatie bouwt die streaming-responses moet weergeven, vereenvoudigt de Vercel AI SDK het werk aanzienlijk.
Installatie
Installeer de kern-SDK en de xAI-provider:
npm install ai @ai-sdk/xai
Configureer uw API-sleutel in de omgevingsvariabelen:
# .env.local
XAI_API_KEY=your-api-key
Serverzijde: Tekst genereren
De functie generateText is het eenvoudigste equivalent van client.chat.create(). Eén ding is veranderd, en dit betreft deze cursus direct: sinds versie 5 van de @ai-sdk/xai-provider (september 2026), compatibel met AI SDK 7, ondersteunt de provider het Chat Completions-eindpunt niet meer. xai(model) gebruikt de Responses API, die xAI nu aanbeveelt. De methode xai.chat(model), die sommige migratiegidsen nog steeds noemen, bestond alleen in provider-versie 4; voor code die op Chat Completions moet blijven, gebruikt u in plaats daarvan de OpenAI SDK die naar xAI wijst (Les 5).
import { generateText } from "ai";
import { xai } from "@ai-sdk/xai";
const { text } = await generateText({
model: xai("grok-4.7"), // xAI Responses API
instructions: "You are a technical assistant.",
prompt: "Explain the concept of containerization.",
});
console.log(text);
De xai-provider leest XAI_API_KEY automatisch uit de omgeving; met createXai() kunt u een instantie met aangepaste instellingen maken. De optie instructions vervangt system, wat nog steeds wordt geaccepteerd maar verouderd is in AI SDK 7.
Serverzijde streaming
Gebruik voor streaming streamText. De respons wordt chunk voor chunk gelezen vanuit textStream:
import { streamText } from "ai";
import { xai } from "@ai-sdk/xai";
const result = streamText({
model: xai("grok-4.7"),
instructions: "You are a teaching assistant.",
messages: [
{ role: "user", content: "How does a relational database work?" },
],
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Clientzijde: De useChat-hook
De useChat-hook is het centrale onderdeel aan de frontend. Deze beheert conversatiegeschiedenis, streaming en aanvraagstatus; het invoerveld blijft echter een eenvoudige React-state die u zelf beheert:
"use client";
import { useChat } from "@ai-sdk/react";
import { DefaultChatTransport } from "ai";
import { useState } from "react";
export default function ChatPage() {
const { messages, sendMessage, status } = useChat({
transport: new DefaultChatTransport({ api: "/api/chat" }),
});
const [input, setInput] = useState("");
return (
<div>
{messages.map((m) => (
<div key={m.id}>
<strong>{m.role === "user" ? "You" : "Grok"}</strong>
{m.parts.map((part, i) =>
part.type === "text" ? <p key={i}>{part.text}</p> : null
)}
</div>
))}
<form
onSubmit={(e) => {
e.preventDefault();
if (input.trim()) {
sendMessage({ text: input });
setInput("");
}
}}
>
<input
value={input}
onChange={(e) => setInput(e.target.value)}
placeholder="Ask your question..."
disabled={status !== "ready"}
/>
<button type="submit" disabled={status !== "ready"}>
Send
</button>
</form>
</div>
);
}
Wat useChat automatisch afhandelt
- Berichtengeschiedenis: Verzamelt uitwisselingen; elk bericht bevat
parts(tekst, tool-aanroepen…), geef deze weer in plaats van het oude veldcontent - Streaming: Geeft de respons weer terwijl deze wordt gegenereerd
- Aanvraagstatus:
statusisreadywanneer een nieuw bericht kan worden verzonden - Foutafhandeling: Onderschept netwerk- en API-fouten
- Annulering:
stop()onderbreekt een lopende generatie
Bijbehorende API-route
De hook verwacht een route die een stream van UI-berichten retourneert. Hier is de implementatie met de Next.js App Router, gemodelleerd naar het officiële AI SDK 7-voorbeeld:
// 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"),
instructions: "You are a helpful assistant. Respond in English.",
messages: await convertToModelMessages(messages),
});
return createUIMessageStreamResponse({
stream: toUIMessageStream({ stream: result.stream }),
});
}
Twee conversies omhullen de uitwisseling: convertToModelMessages transformeert UI-berichten die van de client zijn ontvangen naar modelberichten, en toUIMessageStream doet het omgekeerde op de responsstream. De methoden toUIMessageStreamResponse() op het streamText-resultaat werken nog steeds in AI SDK 7, maar zijn verouderd; wat de oude toDataStreamResponse() betreft, deze bestaat niet meer.
Belangrijkste punten
- De Vercel AI SDK ondersteunt xAI/Grok via het
@ai-sdk/xai-pakket generateTextvoor synchrone responsen,streamTextvoor streaming- De
useChat-hook beheert de volledige status van een conversatie op de client createUIMessageStreamResponseentoUIMessageStreamretourneren de stream die dooruseChatwordt verwacht;toDataStreamResponse()bestaat niet meer- Sinds
@ai-sdk/xai5 ondersteunt de provider geen Chat Completions meer:xai()gebruikt de Responses API; om op Chat Completions te blijven, gebruikt u de OpenAI SDK - De
createXai()-provider detecteert de API-sleutel automatisch in de omgeving