Repolode
OpenRouterTeam

OpenRouterTeam/ai-sdk-provider

将 Vercel AI SDK 接入 OpenRouter 的 provider 包,通过统一接口调用数百个大模型。

Star
695
Fork
176
未关闭 Issue
46
最近提交
3天前

这是什么?

这是 Vercel AI SDK 的 OpenRouter provider 包。开发者只需把模型参数换成 OpenRouter 上的模型 ID,就能继续使用 generateText、streamText 等 AI SDK 函数调用数百个大语言模型。

除对话和补全外,该包还支持 embedding 与重排序(rerank)模型,并提供用于 AI SDK 评估的实验性决策模型。它可以向 OpenRouter 透传额外请求字段,为多模态输入设置图片细节和视频处理方式,支持 Anthropic 的提示词缓存和 beta 请求头,并提供结构化 JSON 输出的修复功能以及用量与费用统计。当前 v7 版本要求 Node.js 22 或更高版本且仅支持 ESM,早期版本分别对应 AI SDK v6 和 v5。

核心功能

  • 01只需更换模型 ID,即可在数百个 OpenRouter 模型之间切换。
  • 02为 AI SDK 提供 embedding 与重排序模型接口。
  • 03可通过 providerOptions 或模型设置向 OpenRouter 透传额外请求字段。
  • 04支持多模态输入的图片细节和视频处理选项。
  • 05支持 Anthropic 提示词缓存和 beta 请求头。
  • 06在 provider metadata 中返回 token 用量和请求费用。

适用场景

  • 在 Next.js 或 Node.js 应用中通过单一集成让用户选择多种大模型。
  • 借助 AI SDK 的 embedding 模型实现语义搜索或 RAG 功能。
  • 开启响应修复功能,获取更可靠的结构化 JSON 输出。
  • 在 AI 产品中统计每次请求的费用和 token 用量。

快速上手

  1. 1

    使用 npm 安装该包

    npm install @openrouter/ai-sdk-provider
  2. 2

    导入默认提供者,并使用模型 ID 调用 generateText

使用前须知

  • 面向 AI SDK v7,需要 Node.js 22 或更高版本。
  • 该包仅支持 ESM。
  • 评估模型所用的 Decisions API 仍处于 alpha 阶段,可能发生变化。

标签

常见问题

ai-sdk-provider 是什么?
将 Vercel AI SDK 接入 OpenRouter 的 provider 包,通过统一接口调用数百个大模型。 这是 Vercel AI SDK 的 OpenRouter provider 包。开发者只需把模型参数换成 OpenRouter 上的模型 ID,就能继续使用 generateText、streamText 等 AI SDK 函数调用数百个大语言模型。
ai-sdk-provider 可以免费使用吗?用的什么许可证?
ai-sdk-provider 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
ai-sdk-provider 还在维护吗?
活跃维护中。ai-sdk-provider 最近一次提交是在 2026年11月4日。
ai-sdk-provider 适合用来做什么?
在 Next.js 或 Node.js 应用中通过单一集成让用户选择多种大模型。 借助 AI SDK 的 embedding 模型实现语义搜索或 RAG 功能。 开启响应修复功能,获取更可靠的结构化 JSON 输出。 在 AI 产品中统计每次请求的费用和 token 用量。
ai-sdk-provider 怎么安装和运行?
使用 npm 安装该包: npm install @openrouter/ai-sdk-provider 导入默认提供者,并使用模型 ID 调用 generateText
在哪里获取 ai-sdk-provider?
源代码和安装说明在 GitHub 上:https://github.com/OpenRouterTeam/ai-sdk-provider

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目