如何通过单 API Key 统一接入 40+ 主流大模型实践教程

为什么需要统一聚合网关？

在构建现代 AI 原生应用（如 AI 编程助手、智能客服、文档自动化处理）时，通常需要根据任务类型灵活切换模型：

• 写复杂代码可能需要 Claude Sonnet 4.6；
• 大批量、低成本的文本处理可能选择 DeepSeek V4 Flash 或 Gemini 3.5 Flash Lite；
• 需要更强推理又在意价格时，可以选择 DeepSeek V4 Pro。

具体价格见 模型广场。

如果不使用统一网关，开发者必须在项目中引入 3 套不同的客户端库、维护多套鉴权机制，并手动编写渠道失败时的容灾重试逻辑。

SupaStore 将所有厂商的接口适配、密钥轮询、流式转发与重试降级全部封装在服务端，客户端只需保持标准 OpenAI SDK 即可自由切换。

---

3 步快速接入指南

第一步：获取 SupaStore API 凭证

1. 访问 https://supastore.cc/ 并登录系统。
2. 进入控制台中的【令牌管理】页面，点击【添加令牌】。
3. 自定义令牌名称、可用模型列表及额度，生成专属 sk-... 密钥。

---

第二步：配置环境与 Base URL

在您的项目配置文件或环境变量中，设置：

OPENAI_API_BASE=https://api.supastore.cc/v1
OPENAI_API_KEY=sk-your-supastore-token

---

第三步：代码集成示例

Node.js / TypeScript (使用官方 openai 库)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: 'https://api.supastore.cc/v1',
});

async function run() {
  const completion = await client.chat.completions.create({
    model: 'claude-sonnet-4-6',
    messages: [
      { role: 'user', content: '请简述 AI Agent 的四大核心要素。' }
    ],
    stream: true, // 流式返回
  });

  for await (const chunk of completion) {
    process.stdout.write(chunk.choices[0]?.delta?.content || '');
  }
}

run();

Vercel AI SDK 接入

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

const supastore = createOpenAI({
  baseURL: 'https://api.supastore.cc/v1',
  apiKey: process.env.OPENAI_API_KEY,
});

export async function POST(req: Request) {
  const { messages } = await req.json();

  const result = streamText({
    model: supastore('deepseek-v4-pro'),
    messages,
  });

  return result.toDataStreamResponse();
}

---

常用工具与桌面客户端配置指南

SupaStore 支持几乎所有主流 AI 桌面客户端与 IDE 插件：

客户端	配置方式
Cherry Studio	在设置中选择【OpenAI】类型，API 域名填写 https://api.supastore.cc，填入密钥即可加载模型。
Cursor / Roo Code	在自定义 OpenAI 兼容接口处，设置 Base URL 为 https://api.supastore.cc/v1。
NextChat / Chatbox	接口地址设置为 https://api.supastore.cc，无需尾部 /v1。

更多详细教程与常见故障排查，欢迎查阅官方文档：/docs。