技术架构

MAX API 系统架构

MAX API 位于调用方与上游模型服务之间，通过统一入口承载控制台、管理 API、实时模型中继和异步多模态任务，并将鉴权、路由、限流、计费、审计和运维能力纳入同一治理边界。

整体架构分为四个相互协作的部分：

• 统一入口与请求治理：由 React Web Console 和 Gin Router 接收控制台及 /api、/v1、/v1beta、Task 请求，统一执行请求标识、请求体保护、身份鉴权、模型与 IP 策略、限流和渠道分发。
• 控制面与数据面：管理与治理服务负责用户、渠道、设置、支付、订阅和通知；实时 Relay 与异步任务链路分别处理同步模型调用和需要轮询、重试、最终结算的任务。
• 适配与计费：渠道及任务适配器统一处理 URL、认证、DTO 和错误；Pricing & Billing 负责估价、预扣、差额结算、退款与异常恢复。
• 运行基础设施：Main DB、Log DB、Redis、内存缓存、本地磁盘及多节点部署共同支撑治理数据、审计日志、限流、任务状态和运行时缓存。

组件视图

下面的组件图进一步展示 Web 前端、Go 后端、中继系统、存储和上游 AI 服务之间的关系。