# Vercel AI SDK 集成

> 用 @ai-sdk/openai-compatible 一个 baseURL 接入本平台,或用 openai / anthropic / google 三个 provider 走各家协议

来源：https://qd.zsopc.com/docs/integrations/vercel-ai-sdk

> [Vercel AI SDK](https://ai-sdk.dev) 是 TypeScript 的 AI 应用工具包。本页按 AI SDK 7(2026-11-13 的 npm 版本:`ai` 7.0.173、`@ai-sdk/openai-compatible` 3.0.92、`@ai-sdk/openai` 4.0.118、`@ai-sdk/anthropic` 4.0.105、`@ai-sdk/google` 4.0.121)的官方文档核对。AI SDK 7 要求 Node.js 22 及以上,并且只能用 ESM 导入。

## 准备 API Key

在 [qd.zsopc.com/dashboard/keys](https://qd.zsopc.com/dashboard/keys) 创建 API Key,下面的示例从环境变量 `PLATFORM_API_KEY` 读它。

## 推荐:OpenAI Compatible provider

一个 provider 就能调本平台全部文本模型,请求走 `/v1/chat/completions`:

```bash
npm install ai @ai-sdk/openai-compatible
```

```ts
import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
import { generateText, streamText } from "ai";

const platform = createOpenAICompatible({
  name: "xiaozhan",
  baseURL: "https://qd.zsopc.com/v1",
  apiKey: process.env.PLATFORM_API_KEY, // 以 Authorization: Bearer 发送
  includeUsage: true,                   // 流式也返回 token 用量
});

const { text } = await generateText({
  model: platform("claude-sonnet-4-6"),
  prompt: "用一句话介绍你自己",
});
console.log(text);

const result = streamText({ model: platform("gpt-6.1-sol"), prompt: "写一首短诗" });
for await (const part of result.textStream) process.stdout.write(part);
```

模型 ID 换成 `gemini-3.1-pro-low`、`deepseek-v4.1-flash` 等都行,非 OpenAI 模型由网关做协议翻译。完整列表见 [模型列表](../reference/models.md)。

## 按厂商协议调用

| Provider | 创建方式 | `baseURL` | 请求 |
|---|---|---|---|
| `@ai-sdk/openai` | `createOpenAI({ baseURL, apiKey })` | `https://qd.zsopc.com/v1` | `openai("id")` 走 `/v1/responses`;`openai.chat("id")` 走 `/v1/chat/completions` |
| `@ai-sdk/anthropic` | `createAnthropic({ baseURL, apiKey })` | `https://qd.zsopc.com/v1` | `/v1/messages` |
| `@ai-sdk/google` | `createGoogle({ baseURL, apiKey })` | `https://qd.zsopc.com/v1beta` | `/v1beta/models/{id}:generateContent` |

```ts
import { createAnthropic } from "@ai-sdk/anthropic";

const anthropic = createAnthropic({
  baseURL: "https://qd.zsopc.com/v1", // 这个 provider 的 baseURL 要带 /v1
  apiKey: process.env.PLATFORM_API_KEY,
});
const { text } = await generateText({ model: anthropic("claude-sonnet-4-6"), prompt: "Hello" });
```

注意:

- **`@ai-sdk/openai` 默认走 Responses API**。`/v1/responses` 只有部分模型支持(见 [兼容矩阵](../reference/compatibility-matrix.md)),调其他模型请用 `openai.chat("id")`,或直接用上一节的 OpenAI Compatible provider。
- **`@ai-sdk/anthropic` 的 `baseURL` 带 `/v1`**,与 Claude Code 用的 `ANTHROPIC_BASE_URL=https://qd.zsopc.com`(不带 `/v1`)不同。环境里已经为 Claude Code 设过这个变量时,请在代码里显式传 `baseURL`。
- **`@ai-sdk/google`** 当前文档用 `createGoogle`,旧名 `createGoogleGenerativeAI` 仍可用。`baseURL` 带 `/v1beta`。

## 常见问题

| 现象 | 排查 |
|---|---|
| 404 | 对照上表核对 `baseURL`:三个 provider 都要带版本段(`/v1` 或 `/v1beta`) |
| 503 `no_channel_available` | 用 `@ai-sdk/openai` 的默认写法调了不支持 `/v1/responses` 的模型,改用 `openai.chat()` |
| 401 `invalid_api_key` | Key 是否复制完整(共 76 字符);环境变量是否传进了进程 |
| 400 `model_not_found` | 模型 ID 拼写,须与 [模型列表](../reference/models.md) 一致 |
| 402 `quota_exceeded` | 余额不足。所有 Key 共享同一账户余额,到 [充值页](https://qd.zsopc.com/dashboard/billing) 充值 |

错误码完整说明见 [错误码](../reference/errors.md)。

## 相关页面

- [LangChain](./langchain.md) — Python / JS 应用框架
- [LiteLLM](./litellm.md) — 统一调用层与 Proxy
- [流式响应](../guides/streaming.md) — SSE 细节、中断与超时
