同一把 AxonHub API key 能不能跨协议使用

Question（问题）

如果上游 provider 有的吃 OpenAI 兼容接口，有的吃 Gemini 接口，有的两个都能吃，那么 AxonHub 这边是不是同一把 API key 可以跨这些协议入口使用？

Short Answer（简答）

基本可以。
AxonHub 的 API key 是网关自己的凭证，不是某个上游 provider 专属的 key。

Facts（事实）

• routes.go 当前同时注册了：
  • /v1/...（OpenAI 风格）
  • /anthropic/v1/...
  • /gemini/:gemini-api-version/...
  • /v1beta/...（Gemini 别名入口）
• API Keys（API 密钥）页面本身就内置多种使用示例页签：Anthropic SDK、OpenAI SDK、Gemini SDK、Claude Code、Codex。
• OpenAI 风格入口走 WithAPIKeyConfig，主要从 Authorization: Bearer *** 取 AxonHub API Key（API 密钥）。
• Gemini 风格入口走 WithGeminiKeyAuth，支持 query key=，也能从通用 API Key（API 密钥）提取逻辑认证。
• 不同 Channel（渠道）的 transformer 会把请求转成各自上游真正需要的协议格式。

Interpretation（解释）

所以协议其实分两层：

• 你怎么调用 AxonHub
• AxonHub 最后怎么调用上游

这两层不是同一回事。

同一把 AxonHub API key 可以服务多个协议入口；至于最后往上游走 OpenAI、Gemini 还是 Anthropic，要看最后命中的 channel 和 transformer。

Related Pages（相关页面）

• AxonHub
• AxonHub 的 API key profile 到底在管什么
• 固定请求一个逻辑模型名时，AxonHub 会不会 fallback 到别的上游模型

Open Questions（待解问题）

• 哪些特殊 provider 参数在跨协议转换时还会有边角兼容问题？
• 后续是否需要专门整理一页“哪些功能是协议无关、哪些是协议相关”？

Next Checks（后续核查）

• 后续在真实使用里继续留意：相同逻辑模型从不同协议入口进入时，行为是否完全一致。
• 如果发现某类请求只在某个入口协议下工作更稳，再补充例外规则。