知白AI 使用文档

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

快速开始

1. 在 知白AI 用邮箱注册并登录。
2. 在官方小铺用微信或支付宝购买兑换码，到「钱包」输入兑换码，余额即时到账（按美元额度计）。
3. 在「令牌」中创建 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

导入后的默认设置：

第 3 步：启用

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

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

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

Codex CLI

Codex 使用 Responses 接口。编辑 ~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml），添加自定义服务商：

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"

再把密钥写进环境变量，然后启动 codex：

# macOS / Linux
export ZHIBAI_API_KEY="sk-你的密钥"
codex

# Windows PowerShell（设置后需重新打开终端）
setx ZHIBAI_API_KEY "sk-你的密钥"

Claude Code

Claude Code 使用 Anthropic 格式，可以直接使用本站的 Claude 系列模型。编辑 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json）：

{
  "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"
  }
}

保存后重新启动 claude，用 /model 切换 Opus / Sonnet / Haiku 即对应上面三个模型。想换成其他模型（包括 GPT 系列），把对应的模型名改成「模型价格」页面上的名称即可。也可以临时用环境变量：

export ANTHROPIC_BASE_URL="https://kkzhibai.cn"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
claude

Claude Desktop

Claude Desktop 不读取环境变量，需要在开发者菜单中配置第三方推理：

1. 更新到最新版 Claude Desktop，旧版本可能没有相关菜单。
2. 打开应用，先不要登录 Anthropic 账户。
3. 菜单 Help → Troubleshooting → Enable Developer Mode，开启开发者模式。
4. 菜单 Developer → Configure Third-Party Inference。
5. 按下表填写，然后点 Apply Changes → Save & Restart。

Connection:      Gateway
Credential kind: Static API key
URL:             https://kkzhibai.cn
API key:         sk-你的密钥

WorkBuddy

WorkBuddy 的自定义模型使用 OpenAI Chat Completions 格式，地址要填完整路径。

方法一：图形界面

1. 打开模型设置，点击右上角「添加模型」，选择「自定义 / Custom」。
2. 模型 ID 填 gpt-5.5，名称可自定义（如「知白 GPT-5.5」）。
3. 接口地址填 https://kkzhibai.cn/v1/chat/completions。
4. API Key 填 sk-你的密钥，保存后在对话中选择该模型。

方法二：编辑 models.json

配置文件位于 ~/.workbuddy/models.json，只保存在本机：

[
  {
    "id": "gpt-5.5",
    "name": "知白 GPT-5.5",
    "vendor": "OpenAI",
    "url": "https://kkzhibai.cn/v1/chat/completions",
    "apiKey": "sk-你的密钥",
    "supportsToolCall": true,
    "supportsImages": false
  }
]

OpenClaw

用一条命令写入自定义的 OpenAI 兼容服务商：

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

OpenCode

编辑 ~/.config/opencode/opencode.json，添加 OpenAI 兼容的自定义服务商：

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

设置环境变量 ZHIBAI_API_KEY 后启动 opencode，在模型列表中选择「知白AI / GPT-5.5」。

Hermes Agent

编辑 ~/.hermes/config.yaml：

model:
  default: gpt-5.5
  provider: custom
  base_url: https://kkzhibai.cn/v1
  api_key: sk-你的密钥
  # GPT 系列模型可选开启，缓存命中率更高：
  # api_mode: codex_responses

Grok CLI

在 ~/.grok/config.toml 中添加一个模型条目，并设为默认：

[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-你的密钥"

模型条目中的 api_key 优先于 Grok 登录状态，请求会发往本站。

常见错误

用量与扣费

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

密钥安全

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

联系我们

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

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