# 一个 AI SDK provider，覆盖所有模型系列

> https://router.one/zh/integrations/vercel-ai-sdk 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 最后更新：2026-08-24

Vercel AI SDK 用统一接口抽象各家 provider——Router One 把它们进一步收敛：用网关 base URL 配置一次 OpenAI provider，改一个 model 字符串就能在 GPT、Claude、Gemini、DeepSeek 系列之间切换。流式输出、工具调用、generateText/streamText 全部照常工作，每次请求在网关侧都有成本 trace。

## 把 Vercel AI SDK 配置到 Router One base URL

用 createOpenAI 加 Router One base URL 创建 provider，然后用目录里任意模型 ID：

`ai-sdk-example.ts`

```bash
import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";

const router = createOpenAI({
  baseURL: "https://api.router.one/v1",
  apiKey: "sk-your-router-one-key",
});

const { text } = await generateText({
  model: router("<model-id-from-/models>"),
  prompt: "Hello!",
});
```

## Vercel AI SDK 该填哪个模型 ID？

从 /models 页复制精确的模型 ID——ID 区分大小写，页面同时列出每个模型的上下文窗口、能力和当前单价。建议为每个工具单独建一个 API Key，并设置 maxSpend 消费上限，这样单个工具跑飞不会影响其他工作负载。

## 在 trace 里验证 Vercel AI SDK 的调用

发出第一个请求后，到 Dashboard → Logs 查看它的完整 trace：模型、tokens、花费、延迟和状态码。Vercel AI SDK 的每一次调用从此都有账本和轨迹，不再是黑盒。

## 常见问题

### 流式输出走网关能用吗？

能——streamText 和流式 chat completions 照常工作，网关说的就是 OpenAI 流式协议。整个请求仍会作为一条 trace 记录 tokens 和花费。

### Vercel AI SDK 能通过网关用哪些模型？

目录里任何具备对话能力的模型——GPT、Claude、Gemini、Grok、DeepSeek、GLM、MiniMax、豆包等系列。/models 页是模型 ID 与单价的事实来源。

### 中国大陆能直连吗？

能。网关在大陆可直连、无需 VPN，配置与全球环境完全一致。

### 报 401/403/429 怎么排查？

先到 Dashboard → Logs 看请求有没有到达网关以及状态码，再对照错误码速查页逐项检查环境变量、Key 状态和限额。

## 相关页面

- 全部接入指南：https://router.one/zh/integrations
- Vercel AI SDK 的 401/403/429 排查：https://router.one/zh/llm-api-error-codes
- OpenAI SDK 接入：https://router.one/zh/integrations/openai-sdk
- Dify 接入：https://router.one/zh/integrations/dify
- 网关层负责什么：https://router.one/zh/llm-api-gateway
- OpenAI 兼容 API：https://router.one/zh/openai-compatible-api
- API 文档：https://router.one/zh/docs
- 本页规范地址：https://router.one/zh/integrations/vercel-ai-sdk
- 模型与每模型 token 价格：https://router.one/zh/models（markdown：https://router.one/zh/models.md）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md