looplj/axonhub

这是什么？

核心功能

• 01通过统一端点，用现有的 OpenAI、Anthropic、Gemini 风格 SDK 调用多家模型。
• 02在已配置的渠道之间自动故障转移和负载均衡。
• 03提供请求级追踪与时间线，便于排查问题。
• 04按输入、输出和缓存 Token 统计每次请求的成本。
• 05支持基于角色的访问控制、配额与数据隔离。
• 06支持对话、图片生成、Embedding 和 Rerank 接口。

适用场景

• 希望在不同大模型供应商之间切换、又不想修改应用代码的团队。
• 需要为多个用户做配额、成本统计和权限控制的平台。
• 要求某个模型服务不可用时自动切换备用渠道的应用。
• 通过统一网关接入 Claude Code、Codex 等 AI 编程工具的开发者。

快速上手

1. 1

   让你的 Agent 按照 deploy-axonhub 技能部署 AxonHub

2. 2

   打开 AxonHub 地址，创建管理员账号，然后用各提供商的 API Key 添加渠道

3. 3

   在 API Keys 页面创建供客户端使用的 AxonHub API Key

4. 4

   将 OpenAI SDK 的 base_url 指向 http://localhost:8090/v1 并发送第一个聊天请求

使用前须知

• !README 没有直接的安装命令，部署方式是通过 Agent 技能描述的。
• !你需要为每个上游模型提供商提供自己的 API Key。
• !AWS Bedrock 和 Google Cloud 的支持仍标注为测试中。

标签

常见问题

axonhub 是什么？

开源 AI 网关，无需改代码即可用任意 SDK 调用 100 多个大模型，支持故障转移、负载均衡与成本追踪。 AxonHub 是一个位于应用与模型供应商之间的 AI 网关。应用继续使用现有的 OpenAI、Anthropic 等 SDK，AxonHub 会把每个请求转换为目标供应商所需的格式。切换 GPT-4、Claude 或 Gemini 只需修改配置，无需重写客户端代码。

axonhub 可以免费使用吗？用的什么许可证？

axonhub 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

axonhub 还在维护吗？

活跃维护中。axonhub 最近一次提交是在 2026年10月21日。

axonhub 适合用来做什么？

希望在不同大模型供应商之间切换、又不想修改应用代码的团队。 需要为多个用户做配额、成本统计和权限控制的平台。 要求某个模型服务不可用时自动切换备用渠道的应用。 通过统一网关接入 Claude Code、Codex 等 AI 编程工具的开发者。

axonhub 怎么安装和运行？

让你的 Agent 按照 deploy-axonhub 技能部署 AxonHub 打开 AxonHub 地址，创建管理员账号，然后用各提供商的 API Key 添加渠道 在 API Keys 页面创建供客户端使用的 AxonHub API Key 将 OpenAI SDK 的 base_url 指向 http://localhost:8090/v1 并发送第一个聊天请求

在哪里获取 axonhub？

源代码和安装说明在 GitHub 上：https://github.com/looplj/axonhub