> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiohub.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Chatbox

> 将 AIOHub 配置为 Chatbox 的 OpenAI 兼容模型服务商。

[Chatbox](https://chatboxai.app) 是一个跨平台 AI 聊天客户端，支持自定义模型服务商。AIOHub 以 OpenAI Chat Completions 兼容协议接入 Chatbox。

Chatbox 主要适合在移动设备上使用 AIOHub API。如果你希望在 iOS、Android 或平板设备上用自己的 AIOHub API 令牌聊天，Chatbox 通常比开发者工具类客户端更直接。

## 前置条件

* 已安装 Chatbox，或使用 Chatbox Web / 移动端版本
* 已 [创建 AIOHub API 令牌](/cn/account/create-token)
* API 令牌的分组包含你要使用的 Chat Completions 模型
* 账户有充足余额

## 配置方法

<Steps>
  <Step title="打开模型服务商设置">
    打开 Chatbox，点击侧边栏的设置入口，进入 **Model Provider**。
  </Step>

  <Step title="添加自定义服务商">
    点击服务商列表底部的 **Add** 或 **Add Custom Provider**，新建一个服务商：

    | 字段       | 值                     |
    | -------- | --------------------- |
    | Name     | AIOHub                |
    | API Mode | OpenAI API Compatible |
  </Step>

  <Step title="填写 API 信息">
    按 Chatbox 当前界面的字段填写：

    | 字段       | 值                        |
    | -------- | ------------------------ |
    | API Key  | `sk-你的API令牌`             |
    | API Host | `https://api.aiohub.org` |
    | API Path | `/v1/chat/completions`   |

    <Note>如果你的 Chatbox 版本把字段显示为 Base URL，并要求包含 `/v1`，则填 `https://api.aiohub.org/v1`，并把 API Path 保持为 `/chat/completions`。不要同时在 Host 和 Path 里重复填写 `/v1`。</Note>
  </Step>

  <Step title="添加模型">
    在模型列表中添加或勾选你要使用的模型，例如：

    | 模型                         | 适合场景       |
    | -------------------------- | ---------- |
    | `gpt-4o`                   | 日常对话、写作、翻译 |
    | `gpt-4o-mini`              | 轻量任务和低成本对话 |
    | `claude-sonnet-4-20250514` | 长文分析、复杂写作  |

    可用模型取决于 API 令牌的分组。以控制台模型列表和 `/v1/models` 返回为准。
  </Step>

  <Step title="检查连接">
    保存后点击 **Check**。如果连接成功，返回聊天页面并选择刚配置的模型。
  </Step>

  <Step title="开始聊天">
    新建对话，发送一条短消息。之后可在 AIOHub 控制台的 **日志** 页面查看调用记录和扣费。
  </Step>
</Steps>

## 推荐字段

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

## 可选设置

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

## 常见问题

<AccordionGroup>
  <Accordion title="连接测试失败">
    检查 API Key 是否以 `sk-` 开头，API Host 是否包含 `https://`，以及 API Path 是否为 `/v1/chat/completions`。如果 Host 已经包含 `/v1`，Path 应改为 `/chat/completions`。
  </Accordion>

  <Accordion title="返回 404 或路径重复">
    常见原因是把 `/v1` 同时写进 API Host 和 API Path。AIOHub 的完整请求路径应是 `https://api.aiohub.org/v1/chat/completions`。
  </Accordion>

  <Accordion title="模型不可用">
    回到 AIOHub 控制台确认 API 令牌分组包含该模型。也可以请求 `/v1/models` 查看当前 API 令牌可见的模型。
  </Accordion>

  <Accordion title="Claude 模型能否在 Chatbox 中使用">
    可以，但需要通过 OpenAI Chat Completions 兼容路径调用，并且模型必须出现在当前 API 令牌可见模型中。如果需要原生 Claude Messages 协议，请使用支持 Anthropic Provider 的客户端或 Claude Cowork 3P。
  </Accordion>
</AccordionGroup>

## 官方参考

* [Chatbox model configuration](https://docs.chatboxai.app/en/guides/providers)
* [Chatbox OpenAI-compatible API guide](https://docs.chatboxai.app/en/chatbox-ai-premium/openai-compatible-api)