目录
第一步:配置渠道
第二步:配置模型
第三步:创建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:
引入地址