项目说明
allmodel.top 的整体架构与核心设计理念。
设计目标
allmodel.top 的核心目标是解决以下痛点:
- 多平台管理复杂 — 每个 AI 提供商都有独立的 API 体系、计费方式和 SDK,接入和维护成本高
- 成本不透明 — 各平台定价不同,费用难以预估和控制
- 额度限制 — 单一平台有请求频率和并发限制,大规模应用受制约
- 接口不统一 — OpenAI、Anthropic、Google 各有各的 API 格式,切换成本大
技术架构
allmodel.top 基于 OpenAI API 协议构建统一网关:
架构图
┌─────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Your App │────▶│ allmodel.top │────▶│ OpenAI API │
│ (SDK) │ │ (统一网关) │ │ │
└─────────────┘ │ · 认证鉴权 │ └─────────────────┘
│ · 负载均衡 │ ┌─────────────────┐
│ · 用量计费 │────▶│ Anthropic API │
│ · 请求路由 │ └─────────────────┘
│ · 协议转换 │ ┌─────────────────┐
└──────────────────┘────▶│ Google Gemini │
└─────────────────┘
API 协议兼容
allmodel.top 完整兼容 OpenAI Chat Completions API 协议,支持以下工具直接接入:
- OpenAI 官方 Python/Node.js/Go SDK
- 任何兼容 OpenAI 格式的库(如 LangChain、LlamaIndex)
- 任何使用 HTTP 调用 OpenAI API 的自定义代码
认证方式
通过 HTTP Header 传递 API Key:
认证 Header
Authorization: Bearer am-your-api-key-here
请求格式
所有请求使用 HTTPS POST,Content-Type 为 application/json:
请求示例
POST https://allmodel.top/v1/chat/completions
Authorization: Bearer am-your-api-key
Content-Type: application/json
{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "Hello!"}]
}
错误处理
allmodel.top 遵循 OpenAI 错误格式,返回标准 HTTP 状态码:
| 401 | API Key 无效或已失效 |
| 403 | 余额不足或账户被禁用 |
| 429 | 请求频率超限,请降低调用频率 |
| 500 | 服务端内部错误,稍后重试 |
| 503 | 上游服务商不可用 |
SLA 保障
- 服务可用性:99.9%
- API 响应时间 P99 < 3s(含上游延迟)
- 每日监控告警,故障自动切换
allmodel.top