--- title: AI SDK product: ai-sdk url: /docs/ai-sdk canonical_url: "https://vercel.com/docs/ai-sdk" last_updated: 2026-06-17 type: integration prerequisites: [] related: [] summary: TypeScript toolkit for building AI-powered applications with React, Next.js, Vue, Svelte and Node.js install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # AI SDK ## What the AI SDK provides ## Related pages > **For AI agents:** Follow these links to understand how this page connects to the rest of the Vercel ecosystem. For the full cross-link map (inbound, outbound, prerequisites, and semantic neighbors), see the .graph.md link below. - [How to architect an AI evaluation dashboard on Vercel](https://vercel.com/kb/guide/ai-evaluation-dashboard-architecture-on-vercel?from=related) — Map eval orchestration, traces, and run storage to AI Gateway, Observability, and Marketplace Postgres, and learn when s - [AI SDK by Vercel](https://ai-sdk.dev/docs/introduction?from=related) - [Vercel AI SDK vs TanStack AI](https://vercel.com/kb/guide/vercel-ai-sdk-vs-tanstack-ai?from=related) — Compare the Vercel AI SDK and TanStack AI for building AI-powered TypeScript applications. Learn how they differ in agen - [Get started with GPT-5](https://ai-sdk.dev/cookbook/guides/gpt-5?from=related) - [Tools](https://ai-sdk.dev/docs/foundations/tools?from=related) - [Building AI apps on Vercel: an overview](https://vercel.com/kb/guide/how-to-build-ai-app?from=related) — Learn the key AI concepts and tools for building and scaling AI apps. - [Get started with Llama 3.1](https://ai-sdk.dev/cookbook/guides/llama-3_1?from=related) - [Get started with OpenAI o1](https://ai-sdk.dev/cookbook/guides/o1?from=related) - [AI SDK for Python](https://vercel.com/docs/ai-gateway/sdks-and-apis/ai-sdk-python?from=related) — Build AI-powered Python applications using the AI SDK for Python with AI Gateway for unified access to 200+ models. - [OpenAI](https://vercel.com/docs/agent-resources/integrations-for-models/openai?from=related) — Integrate your Vercel project with OpenAI's powerful suite of models. - [Integrations for Models](https://vercel.com/docs/agent-resources/integrations-for-models?from=related) — Integrate powerful AI services and models seamlessly into your Vercel projects. - [Text](https://vercel.com/docs/ai-gateway/getting-started/text?from=related) — Generate and stream text responses using AI Gateway. Full cross-link map for this page: [/docs/ai-sdk.graph.md](/docs/ai-sdk.graph.md) - **Unified provider API.** Switch between models by changing two lines of code - **Structured outputs.** Generate type-safe JSON with `generateObject` and `streamObject` - **Tool calling.** Let models interact with external systems - **Streaming first.** Stream text, objects, and UI to your frontend - **Framework support.** Works with React, Next.js, Vue, Svelte, and Node.js ## Generating text At the center of the AI SDK is [AI SDK Core](https://sdk.vercel.ai/docs/ai-sdk-core/overview), which provides a unified API to call any LLM. The following example shows how to generate text with the AI SDK using OpenAI's GPT-5: ```typescript import { generateText } from 'ai'; const { text } = await generateText({ model: 'openai/gpt-5.2', prompt: 'Explain the concept of quantum entanglement.', }); ``` The unified interface means that you can easily switch between providers by changing just two lines of code. For example, to use Anthropic's Claude Opus 4.5: ```typescript {2,5} import { generateText } from 'ai'; const { text } = await generateText({ model: 'anthropic/claude-opus-4.5', prompt: 'How many people will live in the world in 2040?', }); ``` ## Generating structured data While text generation can be useful, you might want to generate structured JSON data. For example, you might want to extract information from text, classify data, or generate synthetic data. AI SDK Core provides two functions ([`generateObject`](https://sdk.vercel.ai/docs/reference/ai-sdk-core/generate-object) and [`streamObject`](https://sdk.vercel.ai/docs/reference/ai-sdk-core/stream-object)) to generate structured data, allowing you to constrain model outputs to a specific schema. The following example shows how to generate a type-safe recipe that conforms to a zod schema: ```ts import { generateObject } from 'ai'; import { z } from 'zod'; const { object } = await generateObject({ model: 'openai/gpt-5.2', schema: z.object({ recipe: z.object({ name: z.string(), ingredients: z.array(z.object({ name: z.string(), amount: z.string() })), steps: z.array(z.string()), }), }), prompt: 'Generate a lasagna recipe.', }); ``` ## Using tools with the AI SDK The AI SDK supports tool calling out of the box, allowing it to interact with external systems and perform discrete tasks. The following example shows how to use tool calling with the AI SDK: ```ts import { generateText, tool } from 'ai'; const { text } = await generateText({ model: 'openai/gpt-5.2', prompt: 'What is the weather like today in San Francisco?', tools: { getWeather: tool({ description: 'Get the weather in a location', inputSchema: z.object({ location: z.string().describe('The location to get the weather for'), }), execute: async ({ location }) => ({ location, temperature: 72 + Math.floor(Math.random() * 21) - 10, }), }), }, }); ``` ## Getting started with the AI SDK The AI SDK is available as a package. To install it, run the following command: ```bash pnpm i ai ``` ```bash yarn i ai ``` ```bash npm i ai ``` ```bash bun i ai ``` See the [AI SDK Getting Started](https://sdk.vercel.ai/docs/getting-started) guide for more information on how to get started with the AI SDK. ## More resources **AI SDK documentation**: Read the official AI SDK reference and guides. [Learn more →](https://ai-sdk.dev/docs) **AI SDK examples**: Browse runnable examples for common patterns. [Learn more →](https://ai-sdk.dev/cookbook) **AI SDK guides**: Step-by-step guides for building AI features. [Learn more →](https://ai-sdk.dev/cookbook/guides) **AI SDK templates**: Start from a production-ready Vercel template. [Learn more →](https://vercel.com/templates?type=ai) --- [View full sitemap](/docs/sitemap)