Aekor API 接入 Chatbox 使用教程

本文适用于在 Chatbox 中通过 Aekor API 添加第三方模型服务，并在 Chatbox 内正常调用模型对话。

一、准备工作

在开始配置前，请先准备好：

已安装好的 Chatbox 客户端
已注册并登录 Aekor ，在 Aekor 后台获取可用的 API 密钥，详细步骤请参考https://aekor.com/how-to-get-aekor-api-key.html

二、打开 Chatbox 设置

打开 Chatbox 客户端后，点击左下角的设置。

三、新增模型提供方

进入设置页面后，在左侧菜单中选择：模型提供方

这里是管理各种模型服务商的地方，例如 OpenAI、Claude、Gemini、DeepSeek 等。

在“模型提供方”页面中，找到左侧模型服务商列表底部的：添加

点击后，会弹出“添加模型提供方”窗口。

在弹窗中填写：

名称：Aekor

API 模式：根据自己的需求选择对应的

填写完成后，点击添加。

四、配置 Aekor API 信息

添加完成后，左侧列表中会出现新的服务商：Aekor

点击进入 Aekor 配置页面。

然后按照下面内容填写。

1. 名称

保持为：Aekor，这个名称只是 Chatbox 内部显示用，可以自定义，但建议直接使用 Aekor，方便识别。

2. API 密钥

在 Aekor 控制台中找到 令牌管理 / API Key / 密钥管理 等相关页面。

复制你的 API 密钥，然后粘贴到 Chatbox 的：API 密钥

3. API 主机

在 API 主机 位置填写：https://api.aekor.com 注意这里不要乱加其他路径。

Chatbox 会自动组合成类似：https://api.aekor.com/v1/chat/completions

所以 API 主机只需要填写主域名即可。

4. 改善网络兼容性

建议打开：改善网络兼容性

这个选项可以提高部分网络环境下的连接稳定性。

五、获取模型列表

API 密钥和 API 主机填写完成后，在模型区域点击右侧的：获取

Chatbox 会从 Aekor 接口拉取当前账号可用的模型列表。

成功后，下方会出现模型名称，例如截图中显示了：以 Aekor 后台权限为准。

六、检查模型是否可用

模型列表获取成功后，点击右侧的：检查

Chatbox 会弹出“选择测试模型”的窗口。

选择你想测试的模型，例如：gpt-5.4，然后等待测试结果。

如果配置正常，会显示：连接成功！

这说明该模型已经可以在 Chatbox 中正常使用。

模型列表能获取成功，不代表每一个模型都一定可用，最终以“检查”测试结果为准。有些模型可能后台没有额度、通道临时不可用，或者该模型不支持图片、工具调用等能力。

七、切换到 Aekor 模型使用

配置完成后，回到 Chatbox 主界面。

在聊天窗口右下角点击当前模型名称。

然后在模型列表中找到：Aekor

展开后选择你想使用的模型，例如：gpt-5.4

选择完成后，右下角会显示：Aekor / gpt-5.4

这时就可以直接在 Chatbox 中使用 Aekor API 进行对话了。

八、简单测试

可以在输入框中发送一句测试内容，例如：

你好，你有什么功能？

如果模型正常回复，说明 Aekor API 已经成功接入 Chatbox。

https://api.aekor.com任何售后问题可以咨询客服微信：L812ANNAN

九、常见问题排查

1. 点击“获取”没有模型列表

可以检查以下内容：

API 密钥是否复制完整
API 主机是否填写为 https://api.aekor.com
API 模式是否选择了 OpenAI API 兼容
Aekor 后台是否有可用额度
当前账号是否有模型调用权限

2. 检查模型失败

可以尝试：

换一个模型测试
检查 Aekor 后台模型是否可用
确认密钥没有过期或被删除
打开“改善网络兼容性”
重新点击“获取”刷新模型列表

3. 提示 401 或 Unauthorized

一般是 API 密钥问题。

重点检查：

API 密钥是否填错
API 密钥是否失效
是否多复制了空格
是否使用了其他平台的 Key

4. 提示 503 或模型不可用

这通常不是 Chatbox 配置错误，可能是 Aekor 当前模型通道临时不可用。