Vercel AI SDK за Grok
На тази страница
Обновено на 3 ноември 2026 г., въз основа на документацията за AI SDK 7 и неговия xAI доставчик:
xai()използва Responses API, а версия 5 на доставчика@ai-sdk/xaiвече не поддържа Chat Completions; Next.js маршрутът връщаcreateUIMessageStreamResponse, а генерирането на изображения става чрезgenerateImageс параметърaspectRatio. Източници: AI SDK, xAI provider · AI SDK, Chatbot.
Grok в екосистемата на JavaScript
Vercel AI SDK е предпочитаното решение за интегриране на езикови модели в приложения на JavaScript и TypeScript. xAI предоставя специализиран доставчик (@ai-sdk/xai), който се интегрира нативно със SDK, осигурявайки безпроблемно развитие на уеб приложения.
Инсталация
Инсталирайте 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) Ви позволява да го посочите изрично. Доставчикът вече не поддържа стария крайна точка 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 маршрут с потоково предаване, във формата, очакван от хука 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, но е обявен за остарял.
Генериране на изображения
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 или сравним фреймуърк, то се вписва идеално там, където вече работите, с хукове и компоненти, проектирани за тези среди. Най-видимата му сила е потоковото предаване към браузъра: прогресивното показване на отговори, което при ръчно кодиране е сложно, тук работи с няколко реда код. А абстракцията му за множество доставчици (един и същи API за OpenAI, Anthropic и xAI) го прави най-добрия избор, когато искате да можете да превключвате модели, без да пренаписвате слоя за интеграция: xAI доставчикът замества друг с един ред за импортиране.
Ключови изводи
- Инсталирайте
aiи@ai-sdk/xaiза нативна поддръжка на Grok - Доставчикът
xai()автоматично четеXAI_API_KEY - Използвайте
generateTextза пълни отговори иstreamTextза потоково предаване xai()използва Responses API; доставчикът вече не поддържа Chat Completions от версия 5