Το Vercel AI SDK για το Grok
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 3 Νοεμβρίου 2026, με βάση την τεκμηρίωση για το AI SDK 7 και τον πάροχό του xAI: η συνάρτηση
xai()χρησιμοποιεί το Responses API, ενώ η έκδοση 5 του παρόχου@ai-sdk/xaiδεν υποστηρίζει πλέον το Chat Completions. Η διαδρομή (route) του Next.js επιστρέφειcreateUIMessageStreamResponseκαι η δημιουργία εικόνων γίνεται μέσω τηςgenerateImageμε την παράμετροaspectRatio. Πηγές: AI SDK, xAI provider · AI SDK, Chatbot.
Το Grok στο οικοσύστημα JavaScript
Το Vercel AI SDK αποτελεί την κορυφαία λύση για την ενσωμάτωση γλωσσικών μοντέλων σε εφαρμογές JavaScript και TypeScript. Η xAI παρέχει έναν ειδικό πάροχο (@ai-sdk/xai) που ενσωματώνεται εγγενώς με το SDK, προσφέροντας μια ομαλή εμπειρία ανάπτυξης για web εφαρμογές.
Εγκατάσταση
Εγκαταστήστε το SDK και τον πάροχο xAI:
npm install ai @ai-sdk/xai
Εάν χρησιμοποιείτε TypeScript με σχήματα επικύρωσης (δομημένες έξοδοι), προσθέστε το Zod:
npm install ai @ai-sdk/xai zod
Διαμόρφωση
Ο πάροχος xAI διαβάζει αυτόματα τη μεταβλητή περιβάλλοντος XAI_API_KEY. Δημιουργήστε ένα αρχείο .env.local στη ρίζα του έργου σας:
XAI_API_KEY=xai-your-key-here
Δημιουργία κειμένου
Βασική χρήση με την 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);
Με ιστορικό συνομιλίας
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 διαπρέπει στη ροή δεδομένων, κάτι που είναι ιδιαίτερα χρήσιμο για διεπαφές χρήστη με άμεση απόκριση:
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 ή Chat Completions
Με τις τρέχουσες εκδόσεις (AI SDK 7 και @ai-sdk/xai 5), η κλήση xai(model) περνά μέσω του Responses API της xAI, το οποίο και η ίδια η xAI προτείνει: όλα τα παραπάνω παραδείγματα το χρησιμοποιούν ήδη, ενώ η σύνταξη xai.responses(model) σας επιτρέπει να το δηλώσετε ρητά. Ο πάροχος δεν υποστηρίζει πλέον το παλιό endpoint Chat Completions από την έκδοση 5 (Σεπτέμβριος 2026). Εάν το χρειάζεστε, χρησιμοποιήστε το OpenAI SDK στραμμένο προς την xAI (προηγούμενο μάθημα).
import { generateText } from 'ai';
import { xai } from '@ai-sdk/xai';
// Responses API: σύντομη μορφή ή ρητή δήλωση
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.',
});
Ενσωμάτωση με Next.js
Το Vercel AI SDK έχει σχεδιαστεί για να λειτουργεί βέλτιστα με το Next.js. Ακολουθεί μια διαδρομή API με ροή δεδομένων, στη μορφή που αναμένει το hook useChat από το @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 }),
});
}
Η παλιά μέθοδος result.toDataStreamResponse() δεν υπάρχει πλέον. Η result.toUIMessageStreamResponse() λειτουργεί ακόμα στο AI SDK 7, αλλά θεωρείται ξεπερασμένη (deprecated).
Δημιουργία εικόνων
Ο πάροχος xAI υποστηρίζει επίσης τη δημιουργία εικόνων μέσω της 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',
});
Το μοντέλο εικόνων της xAI δεν δέχεται την παράμετρο size: χρησιμοποιήστε την aspectRatio.
Πότε να επιλέξετε αυτό το SDK
Το Vercel AI SDK είναι η ξεκάθαρη επιλογή μόλις εργάζεστε στον ιστό με JavaScript ή TypeScript. Εάν η εφαρμογή σας βασίζεται σε Next.js, Nuxt, SvelteKit ή κάποιο συγκρίσιμο framework, εντάσσεται άμεσα στο περιβάλλον εργασίας σας, προσφέροντας hooks και components σχεδιασμένα ειδικά για αυτά. Το πιο εμφανές πλεονέκτημά του είναι η ροή δεδομένων προς τον browser: η προοδευτική εμφάνιση των απαντήσεων, η οποία απαιτεί πολύπλοκο κώδικα αν γραφτεί χειροκίνητα, επιτυγχάνεται εδώ με λίγες μόνο γραμμές. Επιπλέον, η αφαίρεση πολλαπλών παρόχων (το ίδιο API για OpenAI, Anthropic και xAI) το καθιστά την ιδανική επιλογή όταν θέλετε να μπορείτε να αλλάζετε μοντέλα χωρίς να ξαναγράφετε το στρώμα ενσωμάτωσής σας: ο πάροχος xAI αντικαθιστά έναν άλλον με μία μόνο γραμμή import.
Βασικά σημεία
- Εγκαταστήστε τα
aiκαι@ai-sdk/xaiγια εγγενή υποστήριξη του Grok - Ο πάροχος
xai()διαβάζει αυτόματα τοXAI_API_KEY - Χρησιμοποιήστε την
generateTextγια πλήρεις απαντήσεις και τηνstreamTextγια ροή δεδομένων - Η
xai()χρησιμοποιεί το Responses API· ο πάροχος δεν υποστηρίζει πλέον το Chat Completions από την έκδοση 5