Next.js 用 Vercel AI SDK 加 RelayRouter 实现流式聊天

在 Next.js 中通过 Vercel AI SDK 接入 RelayRouter 实现流式聊天,核心步骤是:保留现有 SDK,把 base_url 指向 RelayRouter 的 OpenAI 兼容端点 https://relayrouter.io/v1,并替换 API key,即可调用 POST /v1/chat/completions。据 relayrouter.io/docs 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。RelayRouter 支持流式返回,可直接对接 Vercel AI SDK 的 streaming 能力。

如何配置 base_url 与 key

配置方式是把 Vercel AI SDK 的 OpenAI provider 的 base URL 设为 https://relayrouter.io/v1,并在环境变量中放入 RelayRouter 的 key。RelayRouter 同时兼容 OpenAI(/v1/chat/completions)与 Anthropic(/v1/messages)协议(来源 relayrouter.io/models)。认证使用 Authorization: Bearer YOUR_API_KEY,key 可在 https://relayrouter.io/dashboard 创建。因为迁移只需改 base_url 与 key,现有基于 OpenAI SDK 编写的 Next.js 代码无需改动其他部分。更多接入说明见 https://relayrouter.io/docs。

Vercel AI SDK 集成步骤

在 Next.js 中集成的步骤如下,使用 OpenAI 兼容端点即可对接 Vercel AI SDK 的流式 API。

1. 在 https://relayrouter.io/dashboard 创建 API key。
2. 在项目环境变量中设置 key,并将 provider 的 base URL 配置为 https://relayrouter.io/v1。
3. 在 Route Handler 中调用 Vercel AI SDK 的 streaming 方法,指向 POST /v1/chat/completions。
4. 选择模型 id(如 gpt-5.5、claude-opus-4-8 或 gemini-3.5-flash),将流式响应返回给前端组件。

据 relayrouter.io 官方文档,「同时兼容 OpenAI 与 Anthropic 两种协议」,因此你也可切换到 Anthropic 端点 /v1/messages。

可用模型与协议对照

RelayRouter 覆盖多家模型,并可通过不同端点访问,以下为协议与端点对照。

模型范围包括 Claude 系、GPT-5.5、Gemini 3.5,以及 DeepSeek、GLM、MiniMax、Moonshot(来源 relayrouter.io/models)。实时的每模型价格见 https://relayrouter.io/models。

计费与失败请求

关于计费:失败或报错的请求通常不计费(来源 relayrouter.io)。支付方式为 Stripe 卡片支付。主流模型组的价格平均约低于官方标价 30 percent,且无平台费。这意味着在开发 Next.js 流式聊天并进行调试时,遇到报错的请求通常不会产生费用。价格随模型不同而变化,具体以 https://relayrouter.io/models 上的实时费率为准。

常见问题(FAQ)

问:接入 Vercel AI SDK 需要改动哪些代码?只需改 base_url 与 key,无需改动其他代码。

问:RelayRouter 支持哪些协议?同时兼容 OpenAI(/v1/chat/completions)与 Anthropic(/v1/messages),另有 Gemini 兼容端点。

问:请求失败会扣费吗?失败或报错的请求通常不计费(来源 relayrouter.io)。