面向 AGI 应用时代的 AI Models 与 Agents 治理、智能运维和开放协作基础设施MAX API 2.0开启智能运维时代 · 从统一模型网关走向 AGI 原生治理与运营查看 MAX API 2.0 Preview 发布说明简体中文| 繁體中文 | English | Français | 日本語⭐ Star 项目• 加入社群• 查看文档• 获取版本加入社区 • 快速开始 • 为什么需要 • AGI 技术方向 • 当前能力 • 智能运维 • 生产部署MAX API 位于应用、Agent 与上游模型服务之间是统一的模型网关、治理控制平面和运营入口。MAX-API-Next 社区围绕 AGI 工程化持续建设本项目并面向开发者、研究者、企业工程团队、高校技术爱好者和开源贡献者开放协作。我们的目标是建设 AGI 应用真正需要的模型接入、权限、成本、Evidence、智能运维和安全控制基础。我们将在 AGI 领域持续交付先进而可验证的技术、将真实生产问题沉淀为开放工程能力、建立能够共同研究和贡献的社区。 加入 MAX-API-Next 社区MAX API 不只是一个代码仓库也是一项面向 AI Models、Agents、AgentOps 与 AGI 工程化的长期开放协作。无论你正在部署模型网关、开发 Agent、适配新模型、研究评测与治理还是愿意改进文档和国际化都欢迎加入社群交流并参与共建。加入社群你可以更快获取版本动态、模型与协议变化、部署经验、问题排查线索和社区共建机会。QQ 群950126533•微信群搜索 MAX-API社区入口用途MAX-API-Next GitHub关注社区项目、技术方向与开放协作MAX API Issues提交可复现问题、需求建议和兼容性变化MAX API Releases获取正式版与 Preview 版本动态Ask DeepWiki快速检索和理解项目代码技术与生态合作联系maxapimax-api.ai我们正在寻找这些共建者模型与协议贡献者适配新模型、新供应商、Reasoning、工具调用和多模态任务协议。Agent 与应用开发者分享 Dify、RAGFlow、Codex、MCP、工作流和研究 Agent 的接入与治理实践。可靠性与安全工程师完善跨数据库测试、异步任务恢复、结算安全、缓存一致性和权限边界。文档与社区贡献者改进部署教程、FAQ、案例、翻译、可复现实验和新贡献者指引。研究者与评测开发者共建 Evidence、Evaluator、Detector、Runbook 和受控自治方案。查看共建方向、协作原则与参与方式共建方向适合的贡献模型与供应商生态模型/协议适配、兼容测试、模型列表与弃用变化、渠道配置模板AgentOps 与 AGI 应用治理Agent 接入示例、令牌与权限边界、成本治理和运行实践SmartOps 与 Evidence脱敏故障样本、指标口径、告警规则、数据质量说明、诊断与评测方法可靠性、计费与安全幂等结算、异步任务恢复、跨数据库回归、缓存一致性和高风险操作验证文档、教程与国际化部署教程、架构说明、FAQ、案例、翻译和新贡献者指引协作时请尽量提供最小复现、版本、环境、脱敏日志或测试证据协议、数据库和用户契约变更需要说明兼容性、迁移与回滚路径。请勿提交真实 API Key、客户数据、支付原始记录、私有日志或未经授权的数据。涉及资金、安全、密钥、生产数据或自动执行的贡献需要更严格的测试、独立审查和明确责任人。你可以从以下方式开始提交一个可复现的问题、协议差异或模型兼容性变化。为已有问题补充失败测试、跨数据库用例、前端回归或脱敏 Evidence。完善模型/渠道配置、部署说明、FAQ、架构文档或多语言翻译。分享经过脱敏的 Agent 接入、成本治理、SmartOps 和私有化部署实践。提交 Evaluator、Detector、Runbook 或受控自治设计提案并明确能力边界与风险。配套生态max-api-key-toolKey 额度查询工具 · max-api-horizonMAX API 高性能优化版。欢迎模型厂商、Agent/工作流项目、开源社区、研究者和企业工程团队开展技术共建。正式合作、联合发布或机构名义使用应经过双方明确授权。[!IMPORTANT]面向公众提供生成式人工智能服务时使用者应自行完成所在司法辖区要求的上游授权、备案许可、内容安全、实名、日志留存、税务、支付和用户协议等合规义务。日志审计和内容留存仅应在具备合法依据、明确告知、权限隔离和数据安全措施的场景下启用。 面向 AGI 的技术方向AGI 应用不会长期依赖单一模型、单一协议或一次性请求。它们需要跨模型推理、工具调用、多模态任务、长期运行、成本约束、生产证据和可恢复的失败处理。MAX API 选择从这些可验证的工程问题出发建设 AI Models and Agents governance 基础。技术方向当前基础对 AGI 应用的价值多模型与多协议接入OpenAI Compatible、Responses、Claude Messages、Gemini、Realtime、多模态与异步任务协议让应用和 Agent 面对相对稳定的入口并能随模型生态变化持续迁移推理与工具上下文兼容Reasoning Effort、工具定义、Tool Call、工具响应关联和多轮上下文转换减少跨供应商切换时推理信息与工具调用语义丢失治理控制平面用户、令牌、模型范围、分组、路由、限流、额度、价格和管理员权限为不同 Agent、环境和任务建立独立身份、访问边界与预算边界可恢复计费与任务生命周期预扣、最终结算、幂等记录、失败退款、异步任务轮询和人工对账状态避免长任务、重试和异常窗口造成重复扣费、错误退款或不可追溯结果Evidence 与智能运维日志、错误、重试、性能桶、活动告警、渠道/模型性能和结算证据让诊断、评测和未来 Agent 建议建立在可追溯事实上而不是仅依赖提示词推断安全与组织治理Passkey、2FA、分作用域重新验证、会话撤销、审计和敏感操作限流为高风险配置、凭据和运营操作保留明确的责任边界受控自治与工程进化长期蓝图Policy、Budget、Approval、Shadow、Canary、Rollback、隔离 Coding Workspace让自动化能力先被评测、约束和审计再逐步进入低风险生产动作技术原则Evidence before Action先建立可验证事实再进行诊断、建议或自动动作。Governance before Autonomy身份、权限、预算、审批、审计和回滚必须先于自治能力。One Billing Truth生产计费、额度与结算保持单一事实来源不为 Agent 或插件建立第二套账务逻辑。Compatibility by Design持续支持 SQLite、MySQL、PostgreSQL、多供应商协议和可迁移的应用侧契约。Open Collaboration, Safe Boundaries开放协议适配、测试、文档、评测和治理方案高风险生产、资金、密钥与发布动作继续由明确责任人审批。MAX API 2.0 技术亮点Evidence-driven SmartOps把资源告警、渠道/模型性能、数据质量状态和计费结算证据汇聚到统一运维入口并保留人工审阅与真实财务状态之间的边界。面向先进模型协议持续演进增强 Responses、Claude Messages、Gemini 与 Ollama 的 Reasoning、缓存键、惩罚参数、工具定义和多轮 Tool Context 兼容。可恢复的计费与异步任务语义通过幂等 settlement、持久化 effect、任务 ID 和明确的 pending/manual 状态避免异常重试导致重复扣费、错误退款或任务丢失。高风险操作分作用域重新验证Passkey、2FA、Telegram、API Token 与会话撤销采用 scope-bound step-up verification并通过session_generation及时撤销旧会话。跨数据库与持续验证核心数据路径兼容 SQLite、MySQL 和 PostgreSQLGo 测试、前端 Bun 测试、TypeScript 类型检查、JSON 包装规则和测试镜像同步共同构成发布门禁。 为什么需要 MAX API维度直接连接多个供应商使用 MAX API应用接入分别维护 SDK、协议、鉴权和错误格式应用侧使用相对稳定的统一入口模型切换修改代码、密钥和部署配置通过渠道、模型映射、分组和路由调整可用性每个应用自行处理重试和上游故障集中配置权重、优先级、失败重试和切换权限与密钥凭据散落在应用和环境变量中集中管理令牌、模型范围、额度和有效期成本核算多家账单分散难以归因按用户、令牌、模型、渠道和分组统计故障排查日志分散跨供应商定位困难在网关侧统一观察请求、错误、重试和耗时一句话概括供应商负责提供模型Agent 框架负责编排业务MAX API 负责统一接入并守住治理边界。 快速开始本地体验默认使用 SQLite只需 Dockerdockerpull cscitechtop/max-api:latestdockerrun--namemax-api-d--restartalways-p3000:3000-eTZAsia/Shanghai-v./data:/data cscitechtop/max-api:latest启动后访问http://localhost:3000接下来完成三件事创建或确认管理员账号。添加一个具有合法授权的上游渠道和 API Key。创建访问令牌把应用中的 Base URL 指向 MAX API。[!TIP]生产环境建议使用正式版。Preview 版本用于测试和灰度验证升级前请备份数据库并准备回滚方案。[!WARNING]SQLite 适合本地体验、开发和小规模测试。正式环境建议使用 MySQL ≥ 5.7.8 或 PostgreSQL ≥ 9.6并配置 Redis、HTTPS、备份和恢复方案。✨ 当前能力以下能力已经在当前系统中提供能力主要用途统一模型入口接入 OpenAI Compatible、Responses、Claude Messages、Gemini、Realtime 和多模态任务接口多供应商路由管理渠道、权重、优先级、分组、模型映射、失败重试和跨供应商切换身份与访问控制管理用户、令牌、模型范围、分组、额度、有效期、限流和管理员权限成本与计费支持倍率、固定价格、表达式计费、异步任务 rate-card、预扣费、结算和失败退款日志与审计按用户、令牌、模型、渠道、分组和节点查看使用、错误、重试和管理操作智能运维中心集中查看活动告警、渠道性能、模型性能、系统信息和计费结算对账证据辅助管理员发现、定位和审阅生产问题私有化部署支持 SQLite、MySQL、PostgreSQL、Redis、多节点和独立日志库上游扩展支持协议适配、路径覆盖、参数/Header 覆盖、模型发现和任务状态映射适用场景团队或组织内部模型网关统一管理用户、令牌、模型、供应商、权限和费用。AI 应用与 Agent 运行底座为应用、Agent 和工作流提供模型访问控制、成本归因与异常定位。多供应商容灾与迁移通过模型映射、加权路由、失败重试和灰度切换降低单一上游风险。多模态任务治理统一管理图像、音频、视频、嵌入、重排序和实时对话接口。私有化与合规运营自主管理密钥、数据、日志、审计、价格和部署环境。 智能运维中心智能运维中心是 MAX API 2.0 的重大更新也是项目从统一模型网关走向 AGI 原生治理与运营基础设施的关键一步。它将生产观测、资源告警、模型与渠道性能、系统信息和计费结算对账集中到统一管理员入口。当前能力强调“看见问题、保留证据、通知管理员、受控审阅”并不是会自动修改渠道、路由、余额或主机的自治 Agent。模块当前提供的内容活动告警对当前节点的 CPU、内存和磁盘持续超阈值进行去重告警在恢复时发送恢复通知复用管理员已有的 Email、Webhook、Bark 或 Gotify 配置渠道性能查看请求与错误、消耗额度、估算成功率、日志延迟、重试、探测延迟和最近观测时间详情可查看该渠道最近 24 小时的模型与分组表现模型性能汇总所有模型的渠道数、请求与错误、消耗额度、估算成功率、日志延迟、吞吐量和重试详情提供各分组性能、延迟趋势和可用率趋势计费结算对账展示pending/manual正向最终结算、未结资金、重试和错误证据根管理员可配置默认用户阻断策略管理员可按id revision原子批量审阅并关闭告警系统信息查看节点、运行实例和系统任务等信息该模块继续要求超级管理员权限活动告警页面每 5 秒读取一次当前告警状态但不会触发新的检测或修复动作。渠道与模型列表默认查询最近 1 小时管理员可以输入1–168小时的自定义窗口它们不会自动反复统计大日志库只有点击“应用筛选”或“刷新”时才执行查询详情数据在打开时按需加载。计费结算对账把财务恢复状态与运维告警状态严格分离“审阅并关闭”只记录管理员审阅并关闭当前告警不会把结算标记为applied不会修改余额、已应用差额或 effect 状态。批量审阅绑定当前财务 revision刷新后记录发生变化时旧选择会自动失效避免使用过期证据作出操作。[!NOTE]当前生产性能主要聚合既有 Consume/Error 日志和perf_metrics估算成功率并非完整的 Relay Attempt 成功率吞吐量与趋势属于性能桶级近似值。日志关闭、历史数据缺失、采集关闭、窗口无样本或查询失败时页面会显示相应的数据质量状态。活动告警依赖性能监控和资源阈值配置阈值设为0时表示关闭该资源告警需连续两个有效样本才会触发。状态与通知队列只保存在当前进程内存中进程重启后不会保留多节点也不会自动合并为跨节点 Incident。渠道、模型和系统观测保持只读结算审阅仅更新审阅元数据与用户阻断策略不执行资金结算。智能运维中心不会自动测试、禁用、调权、切换渠道或修复主机。这一阶段的价值是先完成“看见问题、通知管理员、提供证据、受控审阅”的闭环为后续统一 Evidence、诊断 Agent、Evaluator 和受控自动化建立基础。 模型、接口与扩展实际可用能力取决于你的上游授权、渠道配置、模型映射和供应商支持。MAX API 负责治理这些能力不提供模型服务本身。类别接口或能力通用模型接口Chat Completions、Responses、Embeddings、Rerank、Images、Audio、Video原生与实时协议Claude Messages、Google Gemini、OpenAI Realtime 等入口推理与工具调用支持 Reasoning Effort、函数工具、Tool Call ID、工具名称和多轮工具响应关联并按不同上游能力进行协议转换异步任务任务提交、轮询、状态映射、结果代理和参数化计费自定义上游Base URL、路径、参数、Header、状态字段和结果字段映射覆盖 OpenAI、Claude、Gemini、Azure、AWS Bedrock、Vertex AI、Ollama 及多种国内模型平台也可治理 Codex、Dify、RAGFlow 和多模态任务服务。具体支持范围以当前版本和渠道类型为准。系统工作方式与技术栈应用 / SDK / Agent → 统一接口与身份鉴权 → 模型权限、限流、预算和安全检查 → 渠道选择、映射与失败重试 → 上游协议适配 → 可恢复结算、Evidence、日志和审计 → 智能运维中心与管理员治理后端使用 Go、Gin 和 GORM前端使用 React 19、TypeScript、Base UI 与 Tailwind CSS数据层兼容 SQLite、MySQL 和 PostgreSQL并可使用 Redis 与独立日志库。供应商协议适配位于独立 Relay/Channel 层计费与结算集中在统一服务边界中管理端通过 SmartOps 展示只读观测和受限治理入口。️ 治理与运营生产环境建议按以下顺序配置配置登录、安全限制和用户注册策略。添加合法授权的上游渠道确认模型、能力和协议配置。按团队、业务或环境设置分组、令牌、模型范围、额度和价格。为每个应用、Agent 或环境使用独立令牌避免共享凭据和成本归属。配置重试、日志与告警通过数据看板和智能运维中心持续观察。渠道能力校验、表达式计费、通用任务协议、管理员审计和性能参数等高级配置请查看 详细文档。 演进路线MAX API 将继续以AI Models and Agents governance为核心从统一网关、智能运维和可恢复结算出发逐步建设面向 AGI 应用的 Evidence、评测、策略与受控执行能力。长期方向不是让一个无边界 Agent 接管生产系统而是建立可验证、可审批、可停止、可回滚的工程闭环。阶段状态重点统一网关与智能运维现已提供接入、鉴权、路由、计费、日志、资源告警、渠道/模型性能、系统信息和计费结算对账Evidence 事实层近期建设统一模型请求、系统日志、指标、Task、路由、策略、结算和审计事件向 Agent 提供脱敏、限权、只读接口开放评测与治理模板规划中与社区沉淀模型/协议兼容测试、匿名故障样本、评测集、Runbook、Detector 和行业治理模板受控自治运维长期蓝图在 Policy、Budget、Approval、Shadow、Canary 和 Rollback 约束下评估低风险自动动作受控能力进化长期蓝图在隔离 Coding Workspace 中生成、测试和审阅候选改进不直接修改生产系统AGI 工程闭环长期方向将 Evidence、评测、治理策略、人工审批与可回滚执行连接为可验证闭环MAX API 不是基础模型也不宣称当前已经实现 AGI 或自治运维。路线图中的长期能力只有在证据、权限、预算、审批和回滚边界完善后才会逐步验证。 生产部署推荐使用 Docker Composegitclone https://github.com/MAX-API-Next/MAX-API.gitcdMAX-API# 修改 docker-compose.yml 中的数据库、Redis 密码和密钥dockercompose up-d部署检查组件建议数据库MySQL ≥ 5.7.8 或 PostgreSQL ≥ 9.6并配置备份与恢复缓存单机可使用内存缓存多节点部署建议使用 Redis入口配置 HTTPS 反向代理、请求大小限制和可信网络策略密钥显式配置随机SESSION_SECRETRedis/多节点场景统一CRYPTO_SECRET节点每个节点设置稳定且唯一的NODE_NAME日志根据合规和运维需要配置LOG_SQL_DSN、清理与保留策略多节点必须统一SESSION_SECRET和CRYPTO_SECRET并为每个节点使用不同的NODE_NAME。独立日志库使用LOG_SQL_DSN错误性能统计需要按需启用ERROR_LOG_ENABLED。完整环境变量和源码构建说明见 详细文档。 项目来源、致谢与二次开发MAX API 基于社区开源成果持续开发。感谢上游项目、贡献者以及所有参与协议适配、测试、文档、翻译与问题反馈的社区成员。如果你基于本项目进行二次开发并仅供自用欢迎在项目主页、页脚或“关于”页面等明显位置任选一种方式保留项目来源或社区鸣谢添加项目地址MAX-API-Next/MAX-API鸣谢社区MAX-API-Next满足上述任一展示要求并保持链接清晰可见即自动获得本项目的非永久临时商用授权无需另行申请或等待确认该授权仅在持续满足展示要求期间有效最新条件以正式 README 与社区公告为准。 许可证本项目采用 GNU Affero 通用公共许可证 v3.0AGPLv3 授权。临时商用授权仅覆盖 MAX API 项目方有权授权的新增与修改部分如果你修改并通过网络向用户提供本项目服务请理解并遵守 AGPLv3 对应的源码提供等义务。长期商用授权、机构合作或其他授权问题请联系maxapimax-api.ai。