Buu Wiki

4 min read

2026-04-11 AxonHub 项目 / API Key / 协议讨论摘录

Context（背景）

围绕 AxonHub 的第一次实际上手，重点讨论了项目、渠道、模型、API Key、profile、优先级、固定费用和协议兼容。

Key points from the discussion

  • Buu 当前已经创建项目：默认、YouTube、小红书。
  • Buu 当前已经创建至少一把翻译专用 API key，想限制它只暴露 Gemini 3 Flash 这个逻辑模型名。
  • Buu 在 AxonHub 中实际采用的是“逻辑模型名 + 多上游优先级 fallback”思路，而不是让客户端直接请求每个真实上游模型名。
  • Buu 明确说明：CCH 在自己的语境里指 Claude Code Hub，不是泛指别的 gateway。

Checked facts during the discussion（讨论中已核对事实）

  • AxonHub 当前实例数据库里存在项目：默认、YouTube、小红书。
  • 翻译 API key 当前有 activeProfile，profile 中限制了 modelIDs: ["gemini-3-flash-preview"]，并指定了 channelIDs。
  • gemini-3-flash-preview 这个逻辑模型当前挂了多条 association，优先级依次落到不同渠道，其中包含一个 gemini-3-flash-preview-thinking 的实际上游候选。
  • 用翻译 key 实际请求本地 /v1/models 时，只返回了 gemini-3-flash-preview，说明 API key 白名单限制的是逻辑模型名暴露面。
  • AxonHub 代码里：
    • API key profile 的 modelIDs 会用于模型访问控制。
    • project profile 和 API key profile 的 channelIDs / channelTags 会用于候选渠道过滤。
    • modelMappings 是可选映射层，不是优先级本身。
    • 模型 association 的 priority 数值越小，优先级越高。
  • AxonHub 路由同时暴露多种入口：
    • /v1/...（OpenAI 风格）
    • /anthropic/v1/...
    • /gemini/:version/... 与 /v1beta/...（Gemini 风格）
  • AxonHub 的认证中间件表明：
    • OpenAI 风格入口主要从 Authorization: Bearer ... 取 AxonHub API key。
    • Gemini 风格入口支持 query key=，也支持从通用 API key 提取逻辑进入认证。
  • 当前数据库中的图片模型价格配置显示：按次收费 flat_fee 目前挂在 prompt_tokens 这个 itemCode 上。

Practical conclusions captured from the discussion（讨论中记录的实际结论）

  • 项目更适合按稳定业务边界来分，不适合按每个小任务或每个灵感来源硬拆。
  • 图片 / 视频成本可以先在同一项目里靠渠道、模型、tag 区分；只有在权限、配额、账单边界需要彻底分开时才升级为独立项目。
  • API key profile 更像“这把 key 可以用哪些逻辑模型、哪些渠道范围、要不要做映射”的规则层。
  • 模型菜单里的 association + priority 才是“同一逻辑模型如何在多个实际上游之间切换”的主路由层。
  • 同一把 AxonHub API key 可以服务多个协议入口；协议入口和最后命中的上游协议不是一回事。

Graph View