Vercel AI SDK 集成

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

Vercel AI SDK 是 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 创建 API Key,下面的示例从环境变量 PLATFORM_API_KEY 读它。

推荐:OpenAI Compatible provider#

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

npm install ai @ai-sdk/openai-compatible
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 模型由网关做协议翻译。完整列表见 模型列表。

按厂商协议调用#

Provider创建方式baseURL请求
@ai-sdk/openaicreateOpenAI({ baseURL, apiKey })https://qd.zsopc.com/v1openai("id") 走 /v1/responses;openai.chat("id") 走 /v1/chat/completions
@ai-sdk/anthropiccreateAnthropic({ baseURL, apiKey })https://qd.zsopc.com/v1/v1/messages
@ai-sdk/googlecreateGoogle({ baseURL, apiKey })https://qd.zsopc.com/v1beta/v1beta/models/{id}:generateContent
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 只有部分模型支持(见 兼容矩阵),调其他模型请用 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_keyKey 是否复制完整(共 76 字符);环境变量是否传进了进程
400 model_not_found模型 ID 拼写,须与 模型列表 一致
402 quota_exceeded余额不足。所有 Key 共享同一账户余额,到 充值页 充值

错误码完整说明见 错误码。

相关页面#