知白AI 使用文档

一个账户、一个令牌，通过兼容 OpenAI / Anthropic 格式的接口调用多种主流大模型。本文档介绍接口地址、代码示例和常用工具的配置方法。

快速开始

1. 在 知白AI 用邮箱注册并登录。
2. 在官方小铺用微信或支付宝购买兑换码，到「钱包」输入兑换码，余额即时到账（按美元额度计）。
3. 在「API 密钥」页面点「创建 API 密钥」，复制以 sk- 开头的密钥。
4. 在你的代码或工具里填入下方的接口地址和密钥即可调用。

接口地址

不同格式的工具，地址填法不同，填错是最常见的报错原因：

可用模型

当前提供的模型及单价以「模型广场 / 模型价格」页面为准，调用时把示例中的模型名换成页面上的名称即可。本文示例使用 gpt-5.5。

也可以用接口查询你的令牌可用的模型列表：

curl https://kkzhibai.cn/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

接口一览

Claude 系列模型原生支持 Anthropic Messages 格式；GPT 等其他模型也可以用 Anthropic Messages 格式调用，网站会自动转换格式。

curl 示例

Chat Completions

curl https://kkzhibai.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

Responses

curl https://kkzhibai.cn/v1/responses \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "你好，介绍一下你自己"
  }'

Anthropic Messages

curl https://kkzhibai.cn/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

返回 HTTP 200 并带有模型回答，说明密钥和地址都正确。工具报错时，建议先用 curl 排除密钥和地址问题。

Python

使用官方 openai 库（pip install openai）：

from openai import OpenAI

client = OpenAI(
    base_url="https://kkzhibai.cn/v1",
    api_key="sk-你的密钥",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
)
print(resp.choices[0].message.content)

建议把密钥放在环境变量里，例如 api_key=os.environ["ZHIBAI_API_KEY"]，不要写死在代码中。

Node.js

使用官方 openai 包（npm install openai）：

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://kkzhibai.cn/v1",
  apiKey: process.env.ZHIBAI_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "你好，介绍一下你自己" }],
});
console.log(resp.choices[0].message.content);

流式输出

需要边生成边显示时，加上 stream 参数：

stream = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "写一首关于秋天的短诗"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

工具配置

以下工具都支持自定义接口地址。配置前请先确认你已创建令牌，并在「模型价格」页面选好要使用的模型名。

CC Switch（推荐，一键导入）

CC Switch 是一个开源的桌面工具（支持 Windows / macOS / Linux），可以用图形界面管理 Claude Code、Codex 等工具的接口配置，不用手动改配置文件，还能在多个服务商之间一键切换。

第 1 步：安装 CC Switch

从官网 ccswitch.io 或 GitHub 发布页 farion1231/cc-switch 下载安装。为了安全，请只从这两个地址下载。

第 2 步：一键导入知白AI

方法一（推荐，令牌自动带入）：

1. 登录知白AI，进入「API 密钥」页面（还没有密钥的话，先点右上角「创建 API 密钥」）。
2. 在要使用的密钥那一行，点最右侧「操作」列的「⋯」（三个点）。
3. 在弹出的菜单中选择「CC Switch」。
4. 在「填入 CC Switch」窗口中选择应用（Claude / Codex），从下拉列表选好主模型（Claude 还可以分别选 Haiku / Sonnet / Opus 模型）。
5. 点「打开 CC Switch」，浏览器询问时选择打开，然后在 CC Switch 弹出的窗口中确认导入。

方法二：在下面粘贴令牌，点击对应按钮导入：

导入后的默认设置：

第 3 步：启用

在 CC Switch 中选中「知白AI」并点启用，然后重新打开 Claude Code 或 Codex 即可。想换模型，可以在 CC Switch 里编辑该服务商，把模型名改成「模型价格」页面上的名称。

手动添加（一键导入打不开时）

在 CC Switch 对应的应用页（Claude 或 Codex）点「添加服务商」→ 选择「自定义」，按上表填写名称「知白AI」、接口地址和你的令牌，保存后启用。

Codex CLI

手动配置

1. 打开 Codex 的配置文件夹：
   • Windows：按 Win + R，粘贴 %USERPROFILE%\.codex，回车。
   • macOS：打开「访达」，按 Cmd + Shift + G，粘贴 ~/.codex，回车。
   提示找不到文件夹的话，先在终端运行一次 codex 再关掉，或者手动新建一个名为 .codex 的文件夹。
2. 打开配置文件：用记事本（Mac 用「文本编辑」）打开文件夹里的 config.toml。没有这个文件就新建一个，文件名必须是 config.toml，不能是 config.toml.txt（Windows 可在资源管理器「查看」里勾选「文件扩展名」确认）。
3. 粘贴下面的内容并保存：

   model = "gpt-5.5"
   model_provider = "zhibai"
   
   [model_providers.zhibai]
   name = "知白AI"
   base_url = "https://kkzhibai.cn/v1"
   env_key = "ZHIBAI_API_KEY"
   wire_api = "responses"

   如果文件里原来就有内容：model = … 和 model_provider = … 这两行要放在文件最前面，[model_providers.zhibai] 整段放在文件末尾。
4. 设置密钥（把 sk-你的密钥 换成你自己的）：
   • Windows：打开 PowerShell，运行下面这行，看到“成功”后关掉窗口，重新打开一个新的 PowerShell：

     setx ZHIBAI_API_KEY "sk-你的密钥"

   • macOS：打开「终端」，运行下面这行，然后关掉终端重新打开：

     echo 'export ZHIBAI_API_KEY="sk-你的密钥"' >> ~/.zshrc

5. 启动：在新终端里进入你的项目文件夹，运行 codex 即可。

想换模型，把第一行 model = "gpt-5.5" 改成「模型广场」上的其他名称即可。

Claude Code

手动配置

1. 打开 Claude Code 的配置文件夹：
   • Windows：按 Win + R，粘贴 %USERPROFILE%\.claude，回车。
   • macOS：打开「访达」，按 Cmd + Shift + G，粘贴 ~/.claude，回车。
   提示找不到文件夹的话，先在终端运行一次 claude 再关掉，或者手动新建一个名为 .claude 的文件夹。
2. 打开配置文件：用记事本（Mac 用「文本编辑」）打开 settings.json。没有就新建一个，文件名必须是 settings.json，不能是 settings.json.txt。
3. 粘贴下面的内容，把 sk-你的密钥 换成你自己的，然后保存：

   {
     "env": {
       "ANTHROPIC_BASE_URL": "https://kkzhibai.cn",
       "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
       "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
       "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
       "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
     }
   }

   如果文件里原来已经有其他设置、不知道怎么合并，建议改用 CC Switch 导入，它会自动帮你合并。
4. 重新启动：关掉所有正在运行的 Claude Code，重新打开终端运行 claude。
5. 确认生效：在 Claude Code 里输入 /status，看到「Anthropic base URL」显示 https://kkzhibai.cn 就说明成功了。

用 /model 切换 Opus / Sonnet / Haiku，就对应上面三个模型。想换成其他模型（包括 GPT 系列），把对应的模型名改成「模型广场」上的名称即可。

VS Code 插件

VS Code 里的 Claude Code 插件需要另外设置：在 VS Code 中按 Ctrl + Shift + P（Mac 为 Cmd + Shift + P），输入并选择「Preferences: Open User Settings (JSON)」，在最外层的大括号里加入下面这段（和前后内容之间用英文逗号隔开），保存后重启 VS Code：

"claudeCode.environmentVariables": [
  { "name": "ANTHROPIC_BASE_URL", "value": "https://kkzhibai.cn" },
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的密钥" }
]

Claude Desktop

Claude Desktop 不读取环境变量和 settings.json，需要在开发者菜单里配置「第三方推理」：

1. 更新到最新版 Claude Desktop，旧版本可能没有相关菜单。
2. 打开应用，不要登录 Anthropic / Claude 账号；如果已经登录，请先退出登录再配置，否则请求会继续走官方账号。
3. 菜单 Help → Troubleshooting → Enable Developer Mode，应用会重启并出现 Developer 菜单。
4. 菜单 Developer → Configure Third-Party Inference…。
5. 在 Connection 中把 Inference provider 设为 Gateway，然后按下面填写，保存并按提示重启。

Inference provider:  Gateway
Gateway base URL:    https://kkzhibai.cn
Gateway API key:     sk-你的密钥
Credential kind:     Static API key
Gateway auth scheme: Bearer

Gateway base URL 不要加 /v1；Credential kind 和 Gateway auth scheme 一般保持默认即可。

重启后直接使用，不要登录账号。模型列表会自动从本站读取，只显示 Claude 系列模型，选择即可使用。

WorkBuddy

WorkBuddy 的自定义模型使用 OpenAI 兼容协议，接口地址要填完整路径。

1. 打开 WorkBuddy 设置 → 「模型」，点击右上角「添加模型」。
2. 供应商：选择「自定义」。
3. 接口地址：填 https://kkzhibai.cn/v1/chat/completions（注意结尾的 /chat/completions 不能少）。
4. API Key：填 sk-你的密钥，可以点「测试连接」确认能连通。
5. 模型名称：填模型的准确名称，例如 gpt-5.5。请到「模型广场」直接复制，大小写、横杠、小数点都要一致，写错会提示模型不存在。
6. 高级配置：保持「工具调用」勾选；「输入」「输出」留空使用默认值即可。
7. 点「保存」，然后在对话中选择这个模型。

OpenClaw

在终端运行一条命令即可写入配置，先把命令里的 sk-你的密钥 换成你自己的：

• macOS / Linux（终端）：

  openclaw onboard --non-interactive --accept-risk \
    --auth-choice custom-api-key \
    --custom-base-url "https://kkzhibai.cn/v1" \
    --custom-model-id "gpt-5.5" \
    --custom-api-key "sk-你的密钥" \
    --custom-provider-id "zhibai" \
    --custom-compatibility openai

• Windows（PowerShell，整行粘贴）：

  openclaw onboard --non-interactive --accept-risk --auth-choice custom-api-key --custom-base-url "https://kkzhibai.cn/v1" --custom-model-id "gpt-5.5" --custom-api-key "sk-你的密钥" --custom-provider-id "zhibai" --custom-compatibility openai

运行完成后重新启动 OpenClaw 即可。想换模型，把 gpt-5.5 换成「模型广场」上的其他名称再运行一次。

OpenCode

1. 打开 OpenCode 的配置文件夹：
   • Windows：按 Win + R，粘贴 %USERPROFILE%\.config\opencode，回车。
   • macOS：打开「访达」，按 Cmd + Shift + G，粘贴 ~/.config/opencode，回车。
   找不到的话，先运行一次 opencode 再关掉，或者手动依次新建 .config 和 opencode 文件夹。
2. 打开配置文件：用记事本（Mac 用「文本编辑」）打开 opencode.json，没有就新建一个（不能是 .txt 结尾）。
3. 粘贴下面的内容，把 sk-你的密钥 换成你自己的，保存：

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "zhibai": {
         "npm": "@ai-sdk/openai-compatible",
         "name": "知白AI",
         "options": {
           "baseURL": "https://kkzhibai.cn/v1",
           "apiKey": "sk-你的密钥"
         },
         "models": {
           "gpt-5.5": { "name": "GPT-5.5" }
         }
       }
     }
   }

   如果文件里原来已有内容，把 "zhibai": { … } 这一段加到原有的 "provider" 里面。
4. 启动：运行 opencode，输入 /models，选择「知白AI / GPT-5.5」。

想加更多模型，在 "models" 里按同样格式再加一行，例如 "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" }（前一行末尾记得加英文逗号）。

Hermes Agent

方法一（推荐）：按提示填写即可，不用改文件。

1. 在终端运行 hermes model。
2. 选择「Custom endpoint」。
3. 依次填入：接口地址 https://kkzhibai.cn/v1、你的密钥、模型名称（如 gpt-5.5）。
4. 完成后运行 hermes 开始使用。

方法二：直接编辑配置文件 ~/.hermes/config.yaml，把 model: 这一段改成：

model:
  default: gpt-5.5
  provider: custom
  base_url: https://kkzhibai.cn/v1
  api_key: sk-你的密钥

注意：添加新服务商要在聊天外运行 hermes model；聊天中的 /model 只能在已配置好的模型之间切换。

Grok CLI

1. 打开 Grok 的配置文件夹：
   • Windows：按 Win + R，粘贴 %USERPROFILE%\.grok，回车。
   • macOS：打开「访达」，按 Cmd + Shift + G，粘贴 ~/.grok，回车。
   找不到的话，先运行一次 grok 再关掉，或者手动新建 .grok 文件夹。
2. 打开配置文件：用记事本（Mac 用「文本编辑」）打开 config.toml，没有就新建一个（不能是 .txt 结尾）。
3. 粘贴下面的内容，把 sk-你的密钥 换成你自己的，保存：

   [models]
   default = "gpt-5.5"
   
   [model."gpt-5.5"]
   model = "gpt-5.5"
   name = "GPT-5.5 via 知白AI"
   base_url = "https://kkzhibai.cn/v1"
   api_backend = "responses"
   api_key = "sk-你的密钥"

   如果文件里原来已有 [models]，只需把 default 改成 "gpt-5.5"，再把 [model."gpt-5.5"] 整段加到文件末尾。
4. 启动：重新运行 grok 即可，请求会通过知白AI 发送。

常见错误

用量与扣费

• 按实际调用的模型和 token 用量从余额中扣费，各模型单价见「模型价格」。
• 每次调用的模型、token 数量和费用可在控制台「使用日志」中查看。
• 可为每个令牌单独设置额度和有效期，适合分项目或分设备管理。
• 退款规则见《用户协议》。

密钥安全

• 不要把密钥发给他人，不要提交到公开的 GitHub 仓库或截图分享。
• 推荐把密钥放在环境变量或工具的本地配置文件里，而不是写进代码。
• 怀疑泄露时，立即在「API 密钥」页面删除该密钥并新建一个。
• 本站客服不会向你索要密码或完整密钥。

联系我们

客服邮箱：[email protected]，工作日一般 1 个工作日内回复。咨询时请提供注册邮箱和相关的请求 ID 或订单号，请勿发送密码或完整密钥。

© 2026 知白AI · 用户协议 · 隐私政策