Vercel AI SDK — это TypeScript toolkit для AI-приложений и агентов: единый API к моделям (AI SDK Core), хуки для чата/генеративного UI (AI SDK UI) и HarnessAgent для готовых harnesses (Claude Code, Codex, Pi). Фокус-ключ: vercel ai sdk. Канон: Introduction, Node.js quickstart, Generating text, Providers. Соседи: OpenAI API, Anthropic API, OpenRouter, ИИ-автоматизация.

Ниже — маршрут новичка на Node.js: пакет ai → ключ Gateway → streamText/generateText. Тарифы зависят от Gateway и провайдера модели; рубли не фиксируем.

Три поверхности SDK

Слой Суть Старт Когда
AI SDK Core generateText, streamText, tools, agents import { generateText } from "ai" бэкенд и скрипты
AI SDK UI хуки чата и generative UI docs AI SDK UI React/Next/Vue/Svelte
AI SDK Harnesses HarnessAgent к Claude Code/Codex/Pi docs Harnesses готовые agent runtimes
Gateway model строка model через AI Gateway anthropic/claude-sonnet-5.5 быстрый старт без своего provider SDK
Node quickstart терминальный streaming-чат Node.js 22+ + pnpm первый день

Источник: ai-sdk.dev/docs/introduction (Core/UI/Harnesses); getting-started/nodejs (Node 22+, pnpm add ai zod dotenv, AI_GATEWAY_API_KEY, streamText); ai-sdk-core/generating-text (generateText/streamText); providers. Сверка: 2026-10-13. ₽ не выдумываем. Пример model id из доки — сверяйте каталог на дату запуска.

Первый скрипт на Node.js

  1. Нужны Node.js 22+ и pnpm.
  2. mkdir my-ai-app && cd my-ai-app && pnpm init.
  3. pnpm add ai zod dotenv и pnpm add -D @types/node tsx typescript.
  4. В .env: AI_GATEWAY_API_KEY=… (ключ из Vercel AI Gateway).
  5. Вызовите streamText или generateText с model из каталога Gateway.
pnpm add ai zod dotenv
# .env: AI_GATEWAY_API_KEY=YOUR_KEY

import { generateText } from "ai";
import "dotenv/config";

const { text } = await generateText({
  model: "anthropic/claude-sonnet-5.5", // сверяйте каталог Gateway
  prompt: "What is inference in machine learning?",
});
console.log(text);

// streamText({ model, messages }) - для чата в терминале (quickstart)

SDK унифицирует провайдеров: смена модели — часто одна строка. Tools: объект tools с tool({ description, inputSchema, execute }) и при необходимости stopWhen. Для UI смотрите AI SDK UI hooks; для agent harnesses — HarnessAgent. Ключ Gateway — только в env, не в git.

Типичные ошибки

  • Ставить старый Node (<22) вопреки Node.js quickstart.
  • Путать AI SDK (библиотека ai) с хостингом Vercel — SDK работает и локально в Node.
  • Хардкодить устаревший model id вместо актуального каталога Gateway/провайдера.
  • Коммитить AI_GATEWAY_API_KEY.
  • Выдумывать рублевые тарифы токенов — смотрите биллинг Gateway и провайдера.

FAQ: Vercel AI SDK

Что такое Vercel AI SDK простыми словами?

AI SDK — TypeScript toolkit от Vercel: единый API к LLM (AI SDK Core), UI-хуки для чата (AI SDK UI) и HarnessAgent для готовых agent harnesses. Канон: ai-sdk.dev/docs/introduction.

С чего начать новичку на Node.js?

Node.js 22+ и pnpm → mkdir/pnpm init → pnpm add ai zod dotenv → AI_GATEWAY_API_KEY в .env → streamText/generateText. Канон: getting-started/nodejs.

Какой ключ нужен?

В актуальном Node.js quickstart — Vercel AI Gateway API key в переменной AI_GATEWAY_API_KEY. Ключ берут в кабинете Vercel AI Gateway.

Чем generateText отличается от streamText?

generateText возвращает готовый текст (и метаданные). streamText стримит токены — удобно для чата в терминале или UI. Оба из пакета ai.

Можно ли менять провайдера модели?

Да. SDK стандартизирует вызов; model задаётся строкой вроде anthropic/claude-sonnet-5.5 через Gateway или через пакет провайдера. Список — ai-sdk.dev/providers.

Есть ли цены в рублях в статье?

Нет. Биллинг зависит от Vercel AI Gateway и выбранного model provider. Рубли не фиксируем — смотрите кабинет на дату запуска.

Вывод

Vercel AI SDK — пакет ai, ключ Gateway, generateText/streamText, дальше UI или tools. Старт: Node quickstart → свой скрипт → сверка model/биллинга. Когда нужна система обучения под интеграции — форматы на странице обучения.

Артём Денисов — эксперт Нетологии и автор курса Яндекс Практикума по промпт-инжинирингу. Сверяет Vercel AI SDK с официальной докой на дату публикации.

Хотите нейросети под свои задачи, а не «для всех»?

Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Соседи по стеку — ИИ-автоматизация и OpenRouter.