跳转到主要内容
Chatbox 是一个跨平台 AI 聊天客户端，支持自定义模型服务商。AIOHub 以 OpenAI Chat Completions 兼容协议接入 Chatbox。 Chatbox 主要适合在移动设备上使用 AIOHub API。如果你希望在 iOS、Android 或平板设备上用自己的 AIOHub API 令牌聊天，Chatbox 通常比开发者工具类客户端更直接。

​
前置条件

  • 已安装 Chatbox，或使用 Chatbox Web / 移动端版本
  • 已 创建 AIOHub API 令牌
  • API 令牌的分组包含你要使用的 Chat Completions 模型
  • 账户有充足余额

​
配置方法

1

打开模型服务商设置

打开 Chatbox，点击侧边栏的设置入口，进入 Model Provider。
2

添加自定义服务商

点击服务商列表底部的 Add 或 Add Custom Provider，新建一个服务商：
字段值
NameAIOHub
API ModeOpenAI API Compatible
3

填写 API 信息

按 Chatbox 当前界面的字段填写：
字段值
API Keysk-你的API令牌
API Hosthttps://api.aiohub.org
API Path/v1/chat/completions
如果你的 Chatbox 版本把字段显示为 Base URL，并要求包含 /v1，则填 https://api.aiohub.org/v1，并把 API Path 保持为 /chat/completions。不要同时在 Host 和 Path 里重复填写 /v1。
4

添加模型

在模型列表中添加或勾选你要使用的模型，例如：
模型适合场景
gpt-4o日常对话、写作、翻译
gpt-4o-mini轻量任务和低成本对话
claude-sonnet-4-20250514长文分析、复杂写作
可用模型取决于 API 令牌的分组。以控制台模型列表和 /v1/models 返回为准。
5

检查连接

保存后点击 Check。如果连接成功，返回聊天页面并选择刚配置的模型。
6

开始聊天

新建对话，发送一条短消息。之后可在 AIOHub 控制台的 日志 页面查看调用记录和扣费。

​
推荐字段

Chatbox 字段AIOHub 值说明
API ModeOpenAI API Compatible使用 OpenAI Chat Completions 协议
API Hosthttps://api.aiohub.org配合默认或手动 API Path 使用
API Path/v1/chat/completionsChat Completions 请求路径
API Keysk-你的API令牌填完整 API 令牌值
Model当前分组可用模型例如 gpt-4o

​
可选设置

  • 如果 Chatbox 自动生成对话标题会产生额外调用，你可以在 Chatbox 设置中关闭标题生成，或改用更便宜的辅助模型。
  • 如果模型支持视觉输入、工具调用或图片能力，是否可用取决于 Chatbox 当前版本、模型能力和 API 令牌分组。
  • 如果你只需要普通聊天，先用文本模型验证，再开启高级能力。

​
常见问题

检查 API Key 是否以 sk- 开头，API Host 是否包含 https://，以及 API Path 是否为 /v1/chat/completions。如果 Host 已经包含 /v1，Path 应改为 /chat/completions。
常见原因是把 /v1 同时写进 API Host 和 API Path。AIOHub 的完整请求路径应是 https://api.aiohub.org/v1/chat/completions。
回到 AIOHub 控制台确认 API 令牌分组包含该模型。也可以请求 /v1/models 查看当前 API 令牌可见的模型。
可以，但需要通过 OpenAI Chat Completions 兼容路径调用，并且模型必须出现在当前 API 令牌可见模型中。如果需要原生 Claude Messages 协议，请使用支持 Anthropic Provider 的客户端或 Claude Cowork 3P。

​
官方参考