Vercel AI SDK

Vercel AI SDK 是用 TypeScript 构建 AI 功能的主流工具包。把它的 @ai-sdk/openai-compatible provider 指向 Synthorai,整个模型目录就能用同一把 key 访问,Claude、GPT、Gemini 与开源权重系列并存。

开始之前

在 控制台 → API Keys. 创建一把 API key,创建后立即复制——它只会显示一次。

第一步 — 安装依赖

npm i ai @ai-sdk/openai-compatible

Synthorai 说的是 OpenAI Chat Completions 协议,所以不需要任何 Synthorai 专用包——官方的 OpenAI 兼容 provider 就是受支持的接入方式。

第二步 — 创建 provider 实例

import { createOpenAICompatible } from '@ai-sdk/openai-compatible';

const synthorai = createOpenAICompatible({
  name: 'synthorai',
  baseURL: 'https://synthorai.io/v1',
  apiKey: process.env.SYNTHORAI_API_KEY,
});

这里的 name 只是链路追踪和错误信息里的标签,不影响路由。路由由 baseURL 和你传入的模型 ID 决定。

⚠

base URL 必须以 /v1. 结尾。provider 会在后面拼接 /chat/completions 这类路径,漏了它就会请求到错误地址。

第三步 — 生成与流式输出

import { generateText } from 'ai';

const { text } = await generateText({
  model: synthorai('claude-sonnet-5-5'),
  prompt: 'Tell me about yourself in one sentence.',
});

console.log(text);

第一个参数是目录里的模型 ID。流式输出用同一个 provider 实例,不需要额外配置:

import { streamText } from 'ai';

const result = streamText({
  model: synthorai('claude-sonnet-5-5'),
  prompt: 'Write a short haiku about routing.',
});

for await (const textPart of result.textStream) {
  process.stdout.write(textPart);
}

怎么选模型

目录里的任何模型 ID 都可以用,下面是几个稳妥的默认选择:

参数	类型	说明
`claude-opus-5-5`	`agentic`	长会话 agent 任务和代码编辑的稳妥选择。
`gpt-5.4`	`reasoning`	混合负载下的通用推理。
`gpt-5.4-mini`	`fast`	快且便宜,适合分类和短输出。
`deepseek-v4-flash`	`cheapest`	目录中价格最低的一档模型之一,适合大批量调用。

改用 Anthropic 协议面

同一把 key 也在另一个路径上提供 Anthropic Messages 协议,AI SDK 通过它的 Anthropic provider 访问。需要 Anthropic 原生特性时用它,其余情况用上面的 OpenAI 兼容 provider。

import { createAnthropic } from '@ai-sdk/anthropic';

const synthoraiAnthropic = createAnthropic({
  baseURL: 'https://synthorai.io/v1',
  apiKey: process.env.SYNTHORAI_API_KEY,
});

⚠

注意它和原生 Anthropic SDK 的区别:原生 SDK 收的是主机根地址、由它自己拼上 /v1/messages,而 AI SDK 的 Anthropic provider 要的是已经含 /v1 的前缀。这里只填主机名会请求到错误路径。

排错

每次调用都 404。 base URL 必须以 /v1. 结尾。provider 会在后面拼接 /chat/completions 这类路径,漏了它就会请求到错误地址。

401 未授权。 环境变量是在模块加载时读的,进程启动之后才 export 的 key 不会生效。设完重启进程。

找不到模型。 模型 ID 区分大小写,必须和目录完全一致。用下面这条列出你这把 key 能访问的模型: curl https://synthorai.io/v1/models -H "Authorization: Bearer $SYNTHORAI_API_KEY"

所有模型 ID 和对应价格都列在 model price comparison 里。