303 个模型 · 40 个模型厂商了解更多
框架、代理程序与开发者工具

Vercel AI SDK + CoreAPI:建置多模型聊天路由

创建一个可串流的聊天端点,能在不更换应用整合的情况下切换 model ID。

链接的代码、云端与消息模块,构成一个 AI 整合工作流程
CA
CoreAPI 研究
AI 模型与 API 工程
2026 年 8 月 6 日 7 分钟阅读

重点摘要

将 CoreAPI key 保留在服务器端,并仅向用户端公开已核准的 model alias。
使用单一 provider 设置,并依工作负载变更 model ID。
以串流回应提升感知延迟表现。
在正式上线前加入请求预算、验证与 fallback。

安装并设置 provider

Vercel AI SDK 可以使用兼容 OpenAI 的 provider。只需设置一次 CoreAPI base URL,并将 API key 保存在服务器端环境变量中。

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

export const coreapi = createOpenAI({
  apiKey: process.env.COREAPI_KEY,
  baseURL: 'https://unixcore.io/v1',
});

创建串流聊天路由

在服务器端从 allowlist 中选择模型。这可防止用户端选取非预期的高成本模型,同时保留多模型弹性。

import { streamText } from 'ai';
import { coreapi } from '@/lib/coreapi';

const allowedModels = {
  fast: 'your-fast-model-id',
  quality: 'your-quality-model-id',
};

export async function POST(request: Request) {
  const { messages, route = 'fast' } = await request.json();
  const modelId = allowedModels[route as keyof typeof allowedModels];

  const result = streamText({
    model: coreapi(modelId),
    messages,
  });

  return result.toDataStreamResponse();
}

依工作负载切换模型

对于对话回合使用较快的路由,对于复杂分析、长篇代码变更或高价值审查则使用高质量路由。请保持路由逻辑可观测,以便日后比较成本与质量。

  • 在尝试自动分类之前,先依明确的产品模式进行路由。
  • 记录所选路由、model ID、token、延迟与请求结果。
  • 套用账户层级与请求层级的支出上限。

生产环境检查清单

在上线前,请加入结构验证、逾时处理、对暂时性失败的重试,以及兼容的 fallback 路由。切勿在浏览器代码中暴露上游 API key。

常见问题

Vercel AI SDK 可以使用兼容 OpenAI 的 API 吗?

可以。请以替代的 base URL 与 API key 设置兼容的 provider,然后在创建请求时提供 model ID。

用户应该能从浏览器选择任何 model ID 吗?

不应该。生产环境应用程序应将面向用户的路由名称对应到服务器端 allowlist,以维持成本、能力与安全性的可控性。

继续阅读 整合与工作流程
返回本区块总览与后续文章。
查看区块
Vercel AI SDK + CoreAPI:建置多模型聊天路由 | CoreAPI