SupaStore 架构解析:为 AI Agent 打造的高可用多模型网关与经济基础设施
解析 SupaStore 的核心设计:如何用一个 API Key 调用 OpenAI、Anthropic、Google、DeepSeek 等厂商的模型,以及渠道故障转移、Prompt 缓存计费与按量计费的工作方式。
SupaStore 架构团队 · · 更新时间:

什么是 SupaStore?
SupaStore(官网:https://supastore.cc/)是专为企业级 AI 应用与自主智能体(Autonomous Agents)构建的高性能多模型聚合网关与经济基础设施。
在现代 AI 应用开发中,开发者往往面临以下痛点:
- 供应商锁定与接口碎片化:OpenAI、Anthropic Claude、Google Gemini、DeepSeek 各自拥有不同的认证方式、请求协议与限流规则。
- 单点故障与限流阻塞:单一供应商遭遇 429(Rate Limit)或 5xx 宕机时,业务直接中断。
- 计费黑盒与成本失控:多团队、多智能体并发调用导致账单混乱,缺乏细粒度配额分配与审计追踪。
SupaStore 通过统一的 OpenAI 兼容协议,提供来自 OpenAI、Anthropic、Google、DeepSeek、阿里巴巴、智谱等厂商的模型,并负责路由、容灾与计费。当前可用模型与实时价格见 模型广场。
核心架构与技术优势
1. Go 实现的流式转发
SupaStore 基于 Go 语言(Gin + GORM)构建。网关在内部完成鉴权、路由与限流判断后,上游返回的流式 Token 会被立即转发给客户端,因此网关自身的开销相对模型生成时间很小。每个模型在本站实测的延迟与成功率,可以在模型广场的模型详情页查看。
2. 渠道故障转移(Auto-Failover)
同一个模型可以由多个上游渠道提供。当某个渠道返回 429 限流或 5xx 错误时,网关会把请求切换到同一模型的其他可用渠道重试,减少单一供应商故障对业务的影响。
3. 上下文缓存(Prompt Caching)按缓存价计费
网关透传 Anthropic Prompt Caching、DeepSeek Context Caching、OpenAI 与 Gemini 的缓存机制。长系统提示词、多轮对话等重复前缀命中上游缓存后,这部分 Token 按模型的缓存价格计费。以 2026-10-29 的价格为例,claude-sonnet-4-6 的缓存输入为 $0.09/M,是普通输入($0.9/M)的 1/10。
快速接入示例
SupaStore 兼容官方 OpenAI SDK。仅需替换 base_url 与 API 密钥即可完成接入:
Python 接入
from openai import OpenAI
client = OpenAI(
api_key="sk-your-supastore-api-key",
base_url="https://api.supastore.cc/v1"
)
# 自由调用 Claude、Gemini 或 DeepSeek 模型
response = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[
{"role": "system", "content": "You are an expert AI architect."},
{"role": "user", "content": "Explain the role of AI gateways in agent workflows."}
]
)
print(response.choices[0].message.content)
cURL 快速验证
curl https://api.supastore.cc/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-supastore-api-key" \
-d '{
"model": "deepseek-v4-flash",
"messages": [{"role": "user", "content": "Ping"}]
}'
常见问题与解答 (FAQ)
Q: SupaStore 会存储我的请求数据吗?
答: 对话类接口(如 /v1/chat/completions)的提示词与回复内容不会写入数据库。消费日志只记录计费所需的元数据,例如模型名称、Token 数量与耗时。
Q: 如何查看支持的模型与实时单价?
答: 您可直接访问实时费率页面 https://supastore.cc/pricing 查询当前所有模型的输入、缓存与输出单价。