AruHub 文档

主题

OpenAI 兼容客户端通用配置 ​

本页适用于没有单独教程、但支持自定义 OpenAI 兼容接口的客户端。不同版本的菜单名称可能略有不同，请以当前客户端界面为准。

1. 这是什么工具 ​

这不是某一个软件，而是一套通用配置方法。“OpenAI 兼容接口”是指客户端按照常见的 OpenAI API 请求格式发送模型请求，同时允许把接口地址改成其他兼容服务。

AruHub 提供相应兼容接口。客户端必须同时允许自定义 Base URL、API Key 和模型 ID，才能按本页方法配置。

2. 适合什么用户 ​

适合以下情况：

  • 你使用的客户端不在工具配置列表中；
  • 设置里能看到 OpenAI Compatible、Custom OpenAI、API Host 或 Base URL；
  • 客户端允许手动填写模型 ID；
  • 你想先判断一个客户端能否连接 AruHub。

如果客户端只允许登录固定厂商账号，不允许修改 Base URL，本页配置通常不适用。

3. 开始前准备 ​

先准备三个值：

配置项AruHub 应填写的内容
Base URLhttps://api.aruhub.com/v1
API Key登录 AruHub 后，在“我的密钥”页面创建；示例只用 sk-xxxxxxxx
模型 ID从 AruHub 模型价格页、客户端实际加载出的模型列表或 AruHub /v1/models 返回结果确认

API Key 相当于账户密码，不要发给其他人，不要上传到 GitHub、网盘、截图或公开聊天。

不要随意硬编码网上看到的模型名。展示名称是给人看的文字，模型 ID 才是请求中使用的准确标识。

4. 安装或打开工具 ​

先从该客户端的官方网站或官方应用商店安装，并确认系统版本受支持。安装后打开 Settings（设置）、Preferences（偏好设置）、Models（模型） 或 Providers（提供商）。

常见字段对照如下：

客户端字段含义与 AruHub 填写方式
API Provider
Provider		模型服务类型；选择 OpenAI Compatible、Custom OpenAI 或意思相近的选项。
OpenAI Compatible表示允许连接 OpenAI 格式的自定义接口；选择此项。
Base URL
API Host		API 根地址；填 https://api.aruhub.com/v1。
Endpoint可能是根地址，也可能要求完整接口；先看客户端说明，若表示 Base URL 就填到 /v1。
API Key
Token		访问接口的秘密凭证；填自己的 AruHub Key，不是账号密码。
Model
Model ID		实际请求的模型标识；填准确模型 ID，不填展示名称。

如果客户端只写 Endpoint，必须先查看其官方文档，确认它要求根地址还是完整请求地址，不要猜。

5. 创建 AruHub API Key ​

  1. 浏览器登录 AruHub。
  2. 打开“我的密钥”。
  3. 点击创建密钥，设置便于识别的名称和需要的限制。
  4. 复制 Key，保存到自己的密码管理器。
  5. 本页示例只写 sk-xxxxxxxx；实际配置时替换，不要公开完整值。

6. 配置 Base URL ​

在客户端的 Base URL 或 API Host 字段填写：

text
https://api.aruhub.com/v1

Base URL 与完整接口地址的区别：

  • Base URL：https://api.aruhub.com/v1。绝大多数兼容客户端会自动拼接后续路径。
  • Chat Completions 完整地址：https://api.aruhub.com/v1/chat/completions。只有客户端明确要求完整请求地址时才填写。
  • Models 完整地址：https://api.aruhub.com/v1/models。它用于查询模型列表，不是聊天 Base URL。

典型错误包括：

  • 多写一次 /v1：https://api.aruhub.com/v1/v1；
  • 少写 /v1：只填 https://aruhub.com；
  • 把网页地址 https://docs.aruhub.com 或网站页面地址当成 API 地址；
  • 把完整的 /chat/completions 请求地址填进 Base URL。

7. 填写 API Key ​

在 API Key 或 Token 字段粘贴自己的 AruHub Key。示意格式：

text
sk-xxxxxxxx

粘贴后检查：

  1. 开头和结尾没有空格或换行。
  2. 没有把 Bearer 一起粘贴进去，除非客户端明确要求。
  3. 没有使用 ChatGPT 登录密码、浏览器 Cookie 或其他服务的 Token。
  4. 点击界面的 Save、Apply 或 Done 保存。

8. 填写或选择模型 ​

  1. 从 AruHub 模型价格页、客户端实际加载列表或 /v1/models 返回结果确认模型 ID。
  2. 在 Model 或 Model ID 字段中粘贴准确 ID。
  3. 若客户端只提供固定下拉列表且不能手动添加，先尝试刷新模型列表。
  4. 若仍没有目标模型，查看客户端是否支持“Custom Model”或手动输入。
  5. 不要把 replace-with-model-id 直接当成模型使用，它只是本文占位符。

需要特别区分：

  • 客户端支持 Chat Completions，不代表它支持 Responses API；
  • 某个模型存在，不代表它支持图片生成、工具调用或该客户端所用接口；
  • 客户端只支持固定模型时，即使 Base URL 可改，也可能不兼容。

9. 保存配置 ​

  1. 检查 Provider 是 OpenAI Compatible 或同类选项。
  2. 检查 Base URL 恰好为 https://api.aruhub.com/v1。
  3. 检查 API Key 无空格。
  4. 检查 Model ID 已替换占位符。
  5. 点击 Save、Apply、Done 或 Verify。
  6. 如果客户端提示重启或 Reload，完全退出后重新打开。

成功保存后，设置页应继续显示 AruHub 地址和选中的模型；Key 通常会被隐藏成圆点或星号。

10. 发起第一次测试 ​

先用客户端发送一条简单消息：

text
请只回复：连接测试成功

如果客户端报错不清楚，可以用 curl 做最小连通性测试。curl 是从终端发送 HTTP 请求的工具。本示例使用 AruHub 当前文档已使用的 Chat Completions 路径；必须先确认所选模型支持该接口，并替换 Key 和模型占位符。

Windows PowerShell ​

打开 PowerShell，复制以下命令；把 sk-xxxxxxxx 和 replace-with-model-id 替换后运行：

powershell
curl.exe https://api.aruhub.com/v1/chat/completions `
  -H "Authorization: Bearer sk-xxxxxxxx" `
  -H "Content-Type: application/json" `
  -d '{"model":"replace-with-model-id","messages":[{"role":"user","content":"请只回复：连接测试成功"}]}'

macOS 或 Linux ​

打开终端，复制以下命令；把两个占位符替换后运行：

bash
curl https://api.aruhub.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"replace-with-model-id","messages":[{"role":"user","content":"请只回复：连接测试成功"}]}'

不同模型和模型服务返回的错误正文可能不同，不要依赖某一种固定 JSON 文案。

Python 最小示例 ​

如果电脑已安装 Python，在 PowerShell 或 macOS/Linux 终端安装官方 SDK：

bash
python -m pip install openai

把下面内容保存为 test_aruhub.py，替换两个占位符后，在同一文件夹运行 python test_aruhub.py：

python
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxx",
    base_url="https://api.aruhub.com/v1",
)

result = client.chat.completions.create(
    model="replace-with-model-id",
    messages=[{"role": "user", "content": "请只回复：连接测试成功"}],
)

print(result.choices[0].message.content)

示例把 Key 直接写在代码中只是为了展示字段。实际项目应放在本机环境变量或秘密管理工具中，并确保文件不上传 GitHub。

Node.js 最小示例 ​

如果电脑已安装 Node.js，在项目文件夹的 PowerShell 或 macOS/Linux 终端运行：

bash
npm install openai

把下面内容保存为 test-aruhub.mjs，替换两个占位符后运行 node test-aruhub.mjs：

javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxxxxxxx",
  baseURL: "https://api.aruhub.com/v1",
});

const result = await client.chat.completions.create({
  model: "replace-with-model-id",
  messages: [{ role: "user", content: "请只回复：连接测试成功" }],
});

console.log(result.choices[0].message.content);

Python 字段名是 base_url，Node.js 字段名是 baseURL，大小写不能混用。

11. 如何确认配置成功 ​

以下结果可以相互印证：

  1. 客户端收到模型回复。
  2. HTTP 状态码为 200。
  3. AruHub 用量记录出现对应时间和模型的请求。
  4. 没有 401、404、429 等错误。

客户端显示“已保存”只说明配置写入成功，不代表模型请求已经成功；必须至少发送一次测试消息。

12. 常见问题 ​

多写或少写 /v1 ​

正确 Base URL 是 https://api.aruhub.com/v1。/v1/v1 和只填域名都应修正。

把网页地址当成 API 地址 ​

文档站或普通网页地址不能代替 API Base URL。只使用本页给出的 https://api.aruhub.com/v1。

把完整接口填进 Base URL ​

除非客户端明确要求完整 Endpoint，否则不要在 Base URL 末尾加 /chat/completions。

API Key 前后有空格 ​

删除空格和换行，重新粘贴。401 通常先检查这一项以及 Key 是否有效。

使用展示名称而不是模型 ID ​

从价格页、实际加载列表或 /v1/models 复制准确 ID。模型展示名可能含空格或说明文字，不能直接用于请求。

客户端只支持 Chat Completions，但模型要求其他接口 ​

更换支持该接口类型的客户端或模型。模型存在不代表当前客户端协议匹配。

客户端不允许自定义 Base URL ​

这种客户端通常无法使用 AruHub 兼容配置。不要尝试修改系统代理、Nginx 或客户端程序文件来绕过限制。

401、404、429 ​

401 检查 Key；404 检查 Base URL、模型和接口；429 降低频率、检查额度并等待后重试。详细步骤见错误排查页。

13. 如何重置或修改配置 ​

  1. 回到客户端 Provider/Model 设置。
  2. 把 Provider 恢复为 OpenAI Compatible。
  3. 把 Base URL 恢复为 https://api.aruhub.com/v1。
  4. 重新粘贴 Key，重新选择准确模型 ID。
  5. 保存并完全重启客户端。
  6. 若仍失败，删除该自定义 Provider 后重新创建，但先记录已遮盖的配置项，避免丢失其他设置。

客户端不兼容时：

  • 检查是否支持自定义 Base URL；
  • 检查支持 Chat Completions 还是 Responses 等接口类型；
  • 检查是否可以手动填写模型 ID；
  • 查看客户端最新官方文档；
  • 更换明确支持 OpenAI 兼容接口的客户端。

14. 安全注意事项 ​

  • API Key 相当于账户密码，不要发给其他人。
  • 不要把 Key 上传到 GitHub、网盘、截图或公开聊天。
  • 示例代码中的 sk-xxxxxxxx 和模型占位符必须替换，但真实值不要提交到代码仓库。
  • 排查时提供时间、模型、状态码和已遮盖错误，不提供完整 Key。
  • 不要为了兼容客户端而关闭系统安全功能或使用来源不明的修改版软件。

15. 相关文档 ​

AruHub · 统一 API 网关

Copyright © 2026 AruHub