小卡拉中转站

外观

小卡拉中转站使用说明 ​

小卡拉中转站是一个基于 New API 的 AI 模型中转服务。它提供 OpenAI 兼容接口，方便 Codex、OpenAI SDK、Chatbox、Cherry Studio、VS Code Codex 插件等客户端通过同一个入口调用已授权模型。

快速接入 ​

如果你已经有账号和 API Key，直接按下面填写：

配置项填写内容
控制台地址https://api.8511.top/
API Base URLhttps://api.8511.top/v1
API Key控制台创建的 API Key
Model控制台里可用的模型名

请求链路：

text
Codex / 客户端 -> https://api.8511.top/v1 -> 小卡拉中转站 -> 上游模型服务

适用场景 ​

小卡拉中转站适合这些场景：

  • 想在 Codex 中使用统一的模型入口。
  • 想在多个客户端中复用同一套 API 配置。
  • 不想在每个工具里分别维护不同模型供应商的原始 Key。
  • 需要由管理员统一分配 Key、模型权限、额度和调用记录。
  • 后续需要按用户或用途统计用量和费用。

用户接入流程 ​

1. 登录控制台 ​

访问：

text
https://api.8511.top/

如果还没有账号，请先注册或联系管理员开通。

2. 创建 API Key ​

登录后进入令牌或 API Key 管理页面。

建议每个设备或用途单独创建一个 Key，例如：

text
codex-laptop
codex-desktop
chatbox-phone

这样后续可以单独限额、停用、统计或排查。

3. 确认可用模型 ​

进入模型列表或可用模型页面，确认当前账号可以使用哪些模型。

客户端里填写的模型名必须和控制台里展示的模型名一致。如果模型名写错，客户端通常会提示模型不存在或请求失败。

4. 配置客户端 ​

在 Codex 或其他 OpenAI 兼容客户端里填写：

text
API Base URL: https://api.8511.top/v1
API Key: 你的 API Key
Model: 控制台里可用的模型名

5. 发起测试请求 ​

建议先用一个简单问题测试：

text
你好，请用一句话介绍你自己。

如果能正常返回内容，说明客户端、中转站和上游模型链路已经打通。

Codex CLI 配置 ​

Codex CLI 的核心配置文件在用户目录下的 .codex 文件夹中。

系统配置目录
Windows%USERPROFILE%\.codex
macOS / Linux~/.codex

需要准备两个文件：

  • config.toml：配置模型、中转站地址和 provider。
  • auth.json：保存 API Key。

安装 Codex CLI ​

安装前请确认本机已有 Node.js 和 npm。

bash
npm install -g @openai/codex

如 npm 访问较慢，可自行切换可用 npm 镜像源。

Windows 配置 ​

  1. 打开资源管理器。
  2. 在地址栏输入 %USERPROFILE% 并回车。
  3. 新建 .codex 文件夹。
  4. 在 .codex 文件夹内创建 config.toml 和 auth.json。

config.toml 示例：

toml
model_provider = "xiaokala"
model = "YOUR_MODEL_NAME"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.xiaokala]
name = "xiaokala"
base_url = "https://api.8511.top/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json 示例：

json
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

macOS / Linux 配置 ​

创建配置目录：

bash
mkdir -p ~/.codex

创建 config.toml：

bash
nano ~/.codex/config.toml

写入：

toml
model_provider = "xiaokala"
model = "YOUR_MODEL_NAME"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.xiaokala]
name = "xiaokala"
base_url = "https://api.8511.top/v1"
wire_api = "responses"
requires_openai_auth = true

创建 auth.json：

bash
nano ~/.codex/auth.json

写入：

json
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

如遇到权限问题，检查文件所有者和读写权限：

bash
chmod 600 ~/.codex/auth.json
chmod 644 ~/.codex/config.toml

启动 Codex ​

进入你的项目目录后运行：

bash
codex

也可以临时指定模型：

bash
codex -m YOUR_MODEL_NAME

将 YOUR_MODEL_NAME 替换为控制台里可用的模型名。

VS Code Codex 插件 ​

VS Code 插件通常需要本机已经安装 Codex CLI，并且能读取用户目录下的 .codex 配置。

推荐做法：

  1. 先完成 Codex CLI 配置。
  2. 在终端运行 codex，确认 CLI 可用。
  3. 安装官方 Codex 插件。
  4. 重启 VS Code。
  5. 在插件中选择继续使用 API 或本地配置。

如果插件无法识别配置，优先检查：

  • ~/.codex/config.toml 或 %USERPROFILE%\.codex\config.toml 是否存在。
  • auth.json 是否存在且包含 OPENAI_API_KEY。
  • config.toml 中的 base_url 是否是 https://api.8511.top/v1。
  • model 是否是控制台里可用的模型名。

不同版本插件的配置项可能不同。优先使用 Codex CLI 的 config.toml 和 auth.json 作为统一配置来源。

通用客户端配置 ​

大多数支持 OpenAI 兼容接口的客户端，配置项类似：

text
API Host / Base URL: https://api.8511.top/v1
API Key: sk-xxxxxxxx
Model: 控制台里可用的模型名

如果客户端要求填写完整接口地址，请优先使用它的 Base URL 配置项，不要把 /chat/completions 手动拼进 Base URL。

调用测试 ​

查看模型列表 ​

bash
curl https://api.8511.top/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

未带 Key 或 Key 错误时会返回未授权，这是正常现象。

发起聊天请求 ​

bash
curl https://api.8511.top/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_NAME",
    "messages": [
      {
        "role": "user",
        "content": "请用一句话说明你能做什么。"
      }
    ]
  }'

需要替换：

  • YOUR_API_KEY：你在控制台创建的 API Key。
  • YOUR_MODEL_NAME：控制台里可用的模型名。

配置检查清单 ​

遇到问题时，先检查这几项：

  • Base URL 是否是 https://api.8511.top/v1。
  • API Key 是否来自小卡拉中转站控制台。
  • Model 是否是当前账号可用的模型名。
  • API Key 前后是否多复制了空格。
  • 客户端是否把 Base URL 又额外拼接了一层 /v1。
  • 本机是否存在其他 OpenAI 相关环境变量覆盖了当前配置。
  • Codex 是否读取的是你刚刚修改的那个 .codex 目录。

常见问题 ​

返回 401 未授权 ​

通常是 API Key 没有填写、填写错误，或者请求头格式不正确。

正确格式：

text
Authorization: Bearer YOUR_API_KEY

提示模型不存在 ​

优先检查：

  • 模型名称是否写错。
  • 当前 Key 是否有该模型权限。
  • 管理员是否已经配置对应上游渠道。

Unable to persist auth file ​

通常是 Codex 配置目录不存在，或者文件路径不正确。

处理方式：

  • Windows 检查 %USERPROFILE%\.codex。
  • macOS / Linux 检查 ~/.codex。
  • 确认目录中存在 config.toml 和 auth.json。

stream disconnected before completion ​

常见原因：

  • 本地网络不稳定。
  • 中转站到上游渠道连接波动。
  • 模型响应时间过长。
  • 客户端或上游服务主动断开连接。

建议先用短问题测试，再联系管理员查看调用日志。

error sending request for url ​

优先检查：

  • 当前网络是否能访问 https://api.8511.top/。
  • 代理或防火墙是否影响 HTTPS 请求。
  • Base URL 是否填写正确。

客户端一直连不上 ​

按顺序检查：

  1. 浏览器是否能打开 https://api.8511.top/。
  2. Base URL 是否填写为 https://api.8511.top/v1。
  3. API Key 是否正确。
  4. 模型名是否正确。
  5. 客户端是否支持 OpenAI 兼容接口。

总是要求确认命令 ​

这是 Codex 的执行审批和沙箱策略，不是中转站故障。

如果你清楚风险，可以在启动 Codex 时指定更适合自己的执行策略。例如：

bash
codex --sandbox workspace-write -a never

这会降低交互确认频率，但也会提高误操作风险。请只在可信项目中使用。

管理员说明 ​

管理员主要维护这些内容：

项目说明
上游渠道配置模型供应商、密钥、代理和可用模型
用户账号创建用户、停用用户、处理登录问题
API Key分配 Key、限制额度、禁用泄露或异常 Key
模型权限控制不同用户可以调用哪些模型
调用日志排查失败请求、超时、额度不足和模型错误
费用规则后续补充计费、充值、额度和结算说明

建议不要多人共用同一个 Key。每个用户至少一个独立 Key，重要设备或用途可以再拆分独立 Key。

费用说明 ​

费用规则暂未发布。

这里先预留费用说明位置，后续可以补充：

项目说明
计费方式待定
免费额度待定
模型单价待定
充值方式待定
额度有效期待定
超额处理待定
退款规则待定

在正式费用规则发布前，请不要把这里的占位内容理解为最终价格。

安全建议 ​

  • 不要把 API Key 发到公开聊天、截图或代码仓库。
  • 每个设备或用途单独创建 Key。
  • 不再使用的 Key 应及时禁用。
  • 怀疑 Key 泄露时，立即删除旧 Key 并创建新 Key。
  • 管理员应定期检查异常调用量。

对外说明文案 ​

可以这样向用户说明：

text
小卡拉中转站是一个统一的 AI API 入口。你只需要使用 https://api.8511.top/v1 作为 Base URL，
再填写分配给你的 API Key，就可以在 Codex 或其他 OpenAI 兼容客户端中调用已授权模型。