Vercel AI SDK 集成
用 @ai-sdk/openai-compatible 一个 baseURL 接入本平台,或用 openai / anthropic / google 三个 provider 走各家协议
Vercel AI SDK 是 TypeScript 的 AI 应用工具包。本页按 AI SDK 7(2026-11-13 的 npm 版本:
ai7.0.173、@ai-sdk/openai-compatible3.0.92、@ai-sdk/openai4.0.118、@ai-sdk/anthropic4.0.105、@ai-sdk/google4.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/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 |
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_key | Key 是否复制完整(共 76 字符);环境变量是否传进了进程 |
400 model_not_found | 模型 ID 拼写,须与 模型列表 一致 |
402 quota_exceeded | 余额不足。所有 Key 共享同一账户余额,到 充值页 充值 |
错误码完整说明见 错误码。