项目简介
One API Pro 的定位、核心特性与适用场景。
一句话
把 40+ LLM 提供商统一为一个 OpenAI 兼容 的 HTTP 网关，内置渠道路由、订阅/按量计费、微信/支付宝/银行收款、兑换码、去中心化多节点集群与运营仪表盘，开箱即用。
核心特性
| 模块 | 能力 |
|---|---|
| 多模型聚合 | OpenAI、Anthropic、Gemini、Qwen、DeepSeek、Doubao、Mistral、Cohere、xAI、VertexAI、AWS Claude 等；全部统一为 OpenAI /v1/chat/completions 协议 |
| 智能渠道路由 | 权重、并发、冷却时间、自动粘性会话（Sticky）、失败转移、自动下线低成功率渠道 |
| 订阅 + 按量 | Token Plan（套餐按期）、按量计费、分组折扣倍率、套餐升降级差价订单（UP 前缀） |
| 充值与支付 | 微信 Native、支付宝、银行转账，支持自定义金额、汇率换算、预设金额 chip（TP 前缀订单） |
| 兑换码 | 批量生成、导出、回收；用于拉新、运营活动、赠送 |
| 多节点集群 | 每节点独立 DB + Redis，通过 GORM 回调 + HTTP 主动推送同步（详见 Cluster 概览） |
| 运营仪表盘 | KPI、趋势图、模型分布 Top-N、用户排行、订单统计（/api/admin/dashboard/*） |
| 鉴权三件套 | Cookie Session、用户级 Access Token、sk- 形式的 API Key，分别服务不同场景 |
| 国际化 | 全量中英文 i18n（管理后台、登录页、落地页、条款隐私），Arco 组件本地化 |
适用场景
- 个人 / 小团队：自建 OpenAI 兼容代理，统一管理多家供应商账单。
- AI 应用开发商：为多个客户/项目分别配置渠道，按订阅/Token 配额做内部计费。
- 企业内部平台：聚合多家大模型做内部网关，配合 RBAC、审计、限流。
- 商业化分发平台：开启微信/支付宝收款，做 Token Plan + 充值混合计费，对外销售额度。
与上游 One-API 的关系
One API Pro 在上游 One-API 之上重构与扩展：
- 保留 / Kept：模型协议兼容、核心鉴权与计费流程、单二进制部署。
- 替换 / Replaced：路由 / 中间件 / 缓存策略 / 监控 / i18n / 支付 / 集群。
- 新增 / Added：套餐系统（Plan / Subscription）、充值、兑换码、运营仪表盘、去中心化集群、
v1/chat/completions流式 + non-stream 双协议兼容。