cloudflare/ai

这是什么？

核心功能

• 01为 Vercel AI SDK 提供 Workers AI 适配，支持聊天、图像、嵌入、语音转写、文字转语音和重排序。
• 02AI Search 适配器可上传文件建立索引，并用自然语言检索。
• 03AI Gateway 适配器为 AI SDK 模型增加缓存、重试和跨厂商回退。
• 04为 Workers AI 和 AI Gateway 提供 TanStack AI 适配器。

适用场景

• 在基于 Vercel AI SDK 的应用中接入 Workers AI 驱动的聊天或图像生成。
• 用 AI Search 为自有文档构建检索功能。
• 通过 AI Gateway 转发模型调用，实现缓存和厂商间回退。
• 以示例项目为起点开发 Workers AI 或多厂商 AI 应用。

快速上手

1. 1

   克隆仓库

   git clone git@github.com:cloudflare/ai.git
2. 2

   进入目录并使用 pnpm 安装依赖

   cd ai && pnpm install
3. 3

   运行 Workers AI 示例

   cd examples/workers-ai && pnpm dev

使用前须知

• !这些包围绕 Cloudflare 服务（如 Workers AI 和 AI Gateway）构建，因此依赖该平台。
• !部分功能（如可恢复流式传输）标注为即将推出。

标签

常见问题

ai 是什么？

基于 Cloudflare 构建 AI 应用的 TypeScript 包与示例，提供 Vercel AI SDK 和 TanStack AI 的适配器。 cloudflare/ai 是一个 monorepo，提供一组 npm 包，用于把 AI 应用代码接入 Cloudflare 的 AI 服务。它为 Vercel AI SDK 和 TanStack AI 提供适配器，覆盖 Workers AI、AI Gateway 和 AI Search。

ai 可以免费使用吗？用的什么许可证？

ai 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

ai 还在维护吗？

活跃维护中。ai 最近一次提交是在 2026年10月21日。

ai 适合用来做什么？

在基于 Vercel AI SDK 的应用中接入 Workers AI 驱动的聊天或图像生成。 用 AI Search 为自有文档构建检索功能。 通过 AI Gateway 转发模型调用，实现缓存和厂商间回退。 以示例项目为起点开发 Workers AI 或多厂商 AI 应用。

ai 怎么安装和运行？

克隆仓库: git clone git@github.com:cloudflare/ai.git 进入目录并使用 pnpm 安装依赖: cd ai && pnpm install 运行 Workers AI 示例: cd examples/workers-ai && pnpm dev

在哪里获取 ai？

源代码和安装说明在 GitHub 上：https://github.com/cloudflare/ai