AxonHub 轻量部署实录[2]-配置篇

目录

第一步:配置渠道

第二步:配置模型

第三步:创建API Key


在上篇内容中,我们介绍了AxonHub的安装,本篇内容是AxonHub的第二篇,介绍如何配置渠道、模型,并在Agent中使用。如果还没有安装好,可移步到 AxonHub 轻量部署实录[1]-安装篇 查看安装步骤

第一步:配置渠道

登录AxonHub的控制台http://localhost:8090 此时已创建好默认的项目,由于我们是个人使用,因此直接使用Default,跳过项目管理,直接添加渠道。

依次点击“渠道”-“添加渠道”:

渠道管理

此时弹出添加渠道对话框,我们填入自己的服务商信息,每一个供应商都支持填入BaseUrl、APIKey、models等信息。我们按自己的实际情况填写。

关于API格式,目前常用的有下面几种(找时间单独聊一下,开发Agent的时候会用到):

  • • OpenAI Chat Completions:这是最老、最通用的一套格式,几乎所有国内厂商(DeepSeek、Kimi、阿里百炼、火山引擎)和大部分海外第三方平台都支持它。

  • • OpenAI Responses:这是 OpenAI 在 2025 年推出的新格式,Codex CLI、Claude Code 的某些工作流、以及 OpenAI 自家的 Agent 产品都在用它。国内厂商目前几乎都不支持这套格式(阿里百炼最近提供了支持,但没用过)。

  • • Anthropic Messages:Claude 的接口,和 OpenAI 的 Completions 有点像,但字段名和结构都不一样。目前国内厂商支持的比较好,CodingPlan 都会提供这种格式的API 地址(Kimi-K2.5 开了个好头)

  • • Google Gemini:Google自成一家,Gemini 的接口和前面三家差别更大,甚至连 HTTP 路径都不一样,只有他家自己的产品使用,国内无法使用,且国内厂商都不支持。

添加渠道

以火山方舟Coding Plan为例,在右侧服务商列表选择“火山引擎”,参数填写内容如下:

  • • API格式:自动带入“OpenAI Chat Compelations”,保持不变

  • • 渠道名称:随便填一个能记住的,我这里用“volces-plan”

  • Base Url:默认填入的是火山引擎计费models调用的地址,需要修改成我们Coding Plan的地址 https://ark.cn-beijing.volces.com/api/coding/v3

  • • API Key:你在火山方舟里面创建的API Key

  • • 支持的模型:填入火山方舟支持的模型,多个的时候以逗号分割,可以批量添加,我使用的有 ark-code-latest,kimi-k2.6,glm-5.1,deepseek-v4-pro,deepseek-v4-flash,doubao-seed-2.0-pro,doubao-seed-2.0-code

  • • 默认测试模型:这个参数是用在模型可用性测试上面的,这里我们填写 deepseek-v4-pro

其他参数我们使用默认值,不做变动,点击添加之后第一个渠道就创建好了。我们回到渠道列表,在状态列点击“启用”开关,启用这个渠道(启用的时候可以顺便测测速,火山引擎提供的Deepseek V4 Pro 速度周末几乎与官网持平,工作日高峰时候会有延迟)。

第二步:配置模型

我们添加并启用渠道之后,表示我们已经和上游服务商的链接打通了。模型表示我们要给下游提供哪些模型服务。

依次点击“模型”-“添加模型”,在弹出的模型列表中进行编辑(以deepseek-v4-pro为例):

  • • 开发者:选择DeepSeek

  • • 模型ID:选择deepseek-v4-pro

  • • 名称:自动带入DeepSeek V4 Pro

其他参数都会自动带入,我们直接点击“保持”

添加模型

保持完之后,我们要给这个模型添加关联,当用户请求我们的deepseek-v4-pro模型时,使用我们指定的渠道中的模型提供服务。

点击模型列表中的关联规则列中关联操作:

  • • 优先级:越低越优先

  • • 类型:选择“去岛内精准匹配模型”,渠道选择我们前面创建的“volces-plan”,模型选择渠道下的“deepseek-v4-pro”,点击保存。

    模型关联

第三步:创建API Key

我们创建一个API key给调用方,在左侧菜单里面找到“API 密钥”,填入密钥名称,类型选择“用户”,点击“创建”按钮,此时会生成一个新的密钥。

回到API 密钥列表,点击“API Key”列中的小眼睛可以查看如何在Agent中使用。例如我们要在codex中使用,将标签页切换到codex:

查看密钥

按照给出的步骤进行配置,配置完成后打开codex cli:

引入地址