Премини към основното съдържание
Български— Изберете език
Меню

Vercel AI SDK за Grok

Урок 7 от 14 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Grok в екосистемата на JavaScript
  2. Инсталация
  3. Конфигурация
  4. Генериране на текст
  5. Потоково предаване (Streaming)
  6. Responses API или Chat Completions
  7. Интеграция с Next.js
  8. Генериране на изображения
  9. Кога да изберете това SDK
  10. Ключови изводи

Обновено на 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