SupaStore

返回博客列表

SupaStore 架构解析:为 AI Agent 打造的高可用多模型网关与经济基础设施

解析 SupaStore 的核心设计:如何用一个 API Key 调用 OpenAI、Anthropic、Google、DeepSeek 等厂商的模型,以及渠道故障转移、Prompt 缓存计费与按量计费的工作方式。

SupaStore 架构团队 · · 更新时间:

SupaStore 架构解析:为 AI Agent 打造的高可用多模型网关与经济基础设施

什么是 SupaStore?

SupaStore(官网:https://supastore.cc/)是专为企业级 AI 应用与自主智能体(Autonomous Agents)构建的高性能多模型聚合网关与经济基础设施。

在现代 AI 应用开发中,开发者往往面临以下痛点:

  1. 供应商锁定与接口碎片化:OpenAI、Anthropic Claude、Google Gemini、DeepSeek 各自拥有不同的认证方式、请求协议与限流规则。
  2. 单点故障与限流阻塞:单一供应商遭遇 429(Rate Limit)或 5xx 宕机时,业务直接中断。
  3. 计费黑盒与成本失控:多团队、多智能体并发调用导致账单混乱,缺乏细粒度配额分配与审计追踪。

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 查询当前所有模型的输入、缓存与输出单价。