开发者文档

TokenAPIBay 提供兼容 OpenAI 和 Anthropic 协议的 API 接口，支持直接接入主流开发工具和 Agent 框架。

快速开始

1. 获取 API 密钥

登录 TokenAPIBay 控制台，进入 API 管理 → API 密钥，点击创建密钥。密钥格式为 sk-xxxxxxxxxxxx。

请妥善保管你的API密钥。该密钥仅在创建时于页面展示一次明文，服务端不会存储完整的密钥明文。一旦遗忘将无法找回，只能重新创建。

2. 确认接入协议

TokenAPIBay 提供两种协议接入点：

协议接入地址适用场景
OpenAI 兼容https://www.tokenapibay.com/v1/chat/completions兼容 OpenAI SDK 的工具和应用
Anthropic 兼容https://www.tokenapibay.com/v1/messages兼容 Anthropic SDK 的工具和应用

3. Agent / 工具接入

TokenAPIBay 兼容 OpenAI 格式，可直接接入主流 AI 工具和 Agent 框架。详细配置请见下方 Agent/工具接入 章节。

4. 对话 API 接入

以下演示使用 OpenAI 和 Anthropic 协议发起聊天补全请求：

OpenAI 兼容协议

cURL
curl https://www.tokenapibay.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen-Max",
    "messages": [
      {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
  }'
Python (OpenAI SDK)
from openai import OpenAI

client = OpenAI(
    api_key="sk-你的API密钥",
    base_url="https://www.tokenapibay.com/v1/chat/completions"
)

response = client.chat.completions.create(
    model="Qwen-Max",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
Node.js (OpenAI SDK)
import OpenAI from "openai";

const client = new OpenAI({
    apiKey: "sk-你的API密钥",
    baseURL: "https://www.tokenapibay.com/v1/chat/completions",
});

const response = await client.chat.completions.create({
    model: "Qwen-Max",
    messages: [{ role: "user", content: "你好" }],
});
console.log(response.choices[0].message.content);

Anthropic 兼容协议

cURL
curl https://www.tokenapibay.com/v1/messages \
  -H "x-api-key: sk-你的API密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "GLM-4",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'
Python (Anthropic SDK)
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-你的API密钥",
    base_url="https://www.tokenapibay.com/v1/messages"
)

response = client.messages.create(
    model="GLM-4",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)
print(response.content[0].text)
Node.js (Anthropic SDK)
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
    apiKey: "sk-你的API密钥",
    baseURL: "https://www.tokenapibay.com/v1/messages"
});

const response = await client.messages.create({
    model: "GLM-4",
    max_tokens: 1024,
    messages: [{ role: "user", content: "你好" }]
});
console.log(response.content[0].text);

接入协议

TokenAPIBay 同时支持 OpenAI 和 Anthropic 两种协议格式：

协议Header示例
OpenAIAuthorization: Bearer <key>Authorization: Bearer sk-xxx
Anthropicx-api-key: <key>x-api-key: sk-xxx

OpenAI 兼容接口

端点说明
POST /v1/chat/completions聊天补全

Anthropic 兼容接口

端点说明
POST /v1/messagesMessages API，兼容 Anthropic 格式

Agent / 工具接入

TokenAPIBay 兼容 OpenAI API 格式，所有支持 OpenAI 协议的第三方工具均可通过简单配置接入。以下是各主流工具的配置方法：

OpenClaw（大龙虾）接入

OpenClaw 是一款开源的 AI Agent 框架，支持全平台部署。

系统要求

平台要求
WindowsWindows 10+，推荐 PowerShell 管理员权限
macOSmacOS 12+，推荐安装 Homebrew
LinuxUbuntu 22.04+ 或同等发行版
Node.js≥ v22（一键脚本会自动安装）

安装 OpenClaw

方式一：一键脚本（新手推荐）

bash
# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows（PowerShell 管理员）
iwr -useb https://openclaw.ai/install.ps1 | iex

方式二：npm 全局安装（有 Node.js 环境）

bash
# 全局安装
npm install -g openclaw@latest

# 启动初始化向导
openclaw onboard --install-daemon

初始化配置

运行 openclaw onboard 按向导提示完成配置，选择 QuickStart 模式快速开始。

配置 TokenAPIBay 模型

编辑配置文件 openclaw.json
Mac/Linux: ~/.openclaw/openclaw.json
Windows: C:\Users\你的用户名\.openclaw\openclaw.json

JSON
{
  "models": {
    "providers": {
      "tokenapibay": {
        "baseUrl": "https://www.tokenapibay.com/v1/chat/completions",
        "apiKey": "sk-你的API密钥",
        "auth": "api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "Qwen-Max",
            "name": "Qwen-Max",
            "contextWindow": 128000,
            "maxTokens": 64000
          },
          {
            "id": "DeepSeek-V3",
            "name": "DeepSeek-V3",
            "contextWindow": 128000,
            "maxTokens": 64000
          },
          {
            "id": "GLM-4",
            "name": "GLM-4",
            "contextWindow": 128000,
            "maxTokens": 32768
          }
        ]
      }
    }
  }
}

配置默认 Agent 模型

JSON
{
  "agents": {
    "defaults": {
      "model": { "primary": "tokenapibay/Qwen-Max" },
      "models": {
        "tokenapibay/Qwen-Max": { "alias": "Qwen-Max" }
      },
      "workspace": "~/.openclaw/workspace",
      "maxConcurrent": 4,
      "subagents": { "maxConcurrent": 8 }
    }
  }
}

验证配置

bash
openclaw gateway restart   # 重启网关
openclaw doctor            # 健康检查
openclaw models list       # 查看模型列表

常用命令

命令说明
openclaw onboard初始化配置向导
openclaw gateway status查看网关状态
openclaw tui启动 TUI 聊天界面
openclaw dashboard打开 Web 控制面板

Claude Code 接入

Claude Code 是 Anthropic 官方 CLI 开发工具，需先安装 Node.js。

安装 Claude Code

平台安装方式
Windows以管理员身份运行 PowerShell：
npm install -g @anthropic-ai/claude-code
或通过 WSL 安装（推荐）
macOS终端执行：
brew install node@20 && npm install -g @anthropic-ai/claude-code
Linuxsudo apt install nodejs && npm install -g @anthropic-ai/claude-code

一键安装脚本

bash
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

安装 Node.js（如未安装）

平台命令
macOSbrew install node@20
Windows下载 nodejs.org LTS 版 .msi 安装包
Linuxcurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs

配置 TokenAPIBay 接入

方式一：环境变量（临时）

bash
# macOS / Linux
export ANTHROPIC_AUTH_TOKEN=sk-你的API密钥
export ANTHROPIC_BASE_URL=https://www.tokenapibay.com/v1/messages
export ANTHROPIC_MODEL=DeepSeek-V4-Pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=DeepSeek-V4-Flash
export ANTHROPIC_DEFAULT_SONNET_MODEL=DeepSeek-V4-Pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=DeepSeek-V4-Pro
export CLAUDE_CODE_SUBAGENT_MODEL=DeepSeek-V4-Flash
claude

# Windows PowerShell
$env:ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"
$env:ANTHROPIC_BASE_URL="https://www.tokenapibay.com/v1/messages"
$env:ANTHROPIC_MODEL="DeepSeek-V4-Pro"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="DeepSeek-V4-Flash"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="DeepSeek-V4-Pro"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="DeepSeek-V4-Pro"
$env:CLAUDE_CODE_SUBAGENT_MODEL="DeepSeek-V4-Flash"
claude

方式二：永久配置（推荐）

创建 settings.json
Mac/Linux: ~/.claude/settings.json
Windows: C:\Users\你的用户名\.claude\settings.json

JSON
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API密钥",
    "ANTHROPIC_BASE_URL": "https://www.tokenapibay.com/v1/messages",
    "ANTHROPIC_MODEL": "DeepSeek-V4-Pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "DeepSeek-V4-Flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "DeepSeek-V4-Pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "DeepSeek-V4-Pro",
    "CLAUDE_CODE_SUBAGENT_MODEL": "DeepSeek-V4-Flash"
  }
}

同时创建 .claude.json
Mac/Linux: ~/.claude.json
Windows: C:\Users\你的用户名\.claude.json

JSON
{
  "hasCompletedOnboarding": true
}

Haiku/Subagent 用 DeepSeek-V4-Flash（轻量），Sonnet/Opus 用 DeepSeek-V4-Pro（主力）。可根据需要调整，模型列表见模型广场。

方式三：VS Code 插件

VS Code 设置 → 搜索 claude-code.environmentVariables → 添加：

JSON
"claude-code.environmentVariables": [
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的API密钥" },
  { "name": "ANTHROPIC_BASE_URL", "value": "https://www.tokenapibay.com/v1/messages" },
  { "name": "ANTHROPIC_MODEL", "value": "DeepSeek-V4-Pro" },
  { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "DeepSeek-V4-Flash" },
  { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "DeepSeek-V4-Pro" },
  { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "DeepSeek-V4-Pro" },
  { "name": "CLAUDE_CODE_SUBAGENT_MODEL", "value": "DeepSeek-V4-Flash" }
]

npm 镜像加速（国内用户）

bash
npm config set registry https://registry.npmmirror.com

Claude Code IDE 接入

Claude Code VS Code 扩展可在 IDE 中使用 Claude Code 全部功能。

方式一：VS Code 设置

VS Code 设置 → 搜索 claude-code.environmentVariables → 添加：

JSON
"claude-code.environmentVariables": [
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的API密钥" },
  { "name": "ANTHROPIC_BASE_URL", "value": "https://www.tokenapibay.com/v1/messages" },
  { "name": "ANTHROPIC_MODEL", "value": "DeepSeek-V4-Pro" },
  { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "DeepSeek-V4-Flash" },
  { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "DeepSeek-V4-Pro" },
  { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "DeepSeek-V4-Pro" },
  { "name": "CLAUDE_CODE_SUBAGENT_MODEL", "value": "DeepSeek-V4-Flash" }
]

方式二：~/.claude/settings.json 配置（推荐）

Mac/Linux: ~/.claude/settings.json
Windows: C:\Users\你的用户名\.claude\settings.json

JSON
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API密钥",
    "ANTHROPIC_BASE_URL": "https://www.tokenapibay.com/v1/messages",
    "ANTHROPIC_MODEL": "DeepSeek-V4-Pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "DeepSeek-V4-Flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "DeepSeek-V4-Pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "DeepSeek-V4-Pro",
    "CLAUDE_CODE_SUBAGENT_MODEL": "DeepSeek-V4-Flash"
  }
}
VS Code 扩展 v2.0.0+ 可能忽略 environmentVariables 设置。推荐使用 ~/.claude/settings.json 并添加 "claudeCode.disableLoginPrompt": true。

Codex 接入

Codex 是 OpenAI 开源的终端 AI 编码 Agent。

安装 Codex

平台安装方式
macOSbrew install codex
Windowswinget install OpenAI.Codex
Linux从 GitHub Releases 下载二进制
npmnpm install -g @openai/codex

配置 TokenAPIBay 接入

方式一：配置 config.toml
Mac/Linux: ~/.codex/config.toml
Windows: C:\Users\你的用户名\.codex\config.toml

TOML
model = "Qwen-Max"
openai_base_url = "https://www.tokenapibay.com/v1/chat/completions"
sandbox_mode = "workspace-write"

设置环境变量：

bash
# macOS / Linux
export OPENAI_API_KEY="sk-你的API密钥"

# Windows PowerShell
$env:OPENAI_API_KEY="sk-你的API密钥"

方式二：自定义 Provider（支持多 Provider）

TOML
model_provider = "tokenapibay"
model = "Qwen-Max"

[model_providers.tokenapibay]
name = "TokenAPIBay"
base_url = "https://www.tokenapibay.com/v1/chat/completions"
env_key = "TOKENAPIB_API_KEY"

设置对应环境变量：export TOKENAPIB_API_KEY="sk-你的API密钥"

Codex 默认使用 OpenAI Responses API。如遇兼容性问题，可在配置中添加 wire_api = "chat.completions"。

OpenCode 接入

OpenCode 是终端 AI 编码 Agent，支持 OpenAI 兼容协议。

配置 opencode.json
Mac/Linux: ~/.config/opencode/opencode.json
Windows: C:\Users\你的用户名\.config\opencode\opencode.json

JSON
{
  "$schema": "https://opencode.ai/config.json",
  "model": "tokenapibay/Qwen-Max",
  "provider": {
    "tokenapibay": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenAPIBay",
      "options": {
        "baseURL": "https://www.tokenapibay.com/v1/chat/completions",
        "apiKey": "sk-你的API密钥"
      },
      "models": {
        "Qwen-Max": { "name": "Qwen-Max" },
        "DeepSeek-V3": { "name": "DeepSeek-V3" },
        "GLM-4": { "name": "GLM-4" }
      }
    }
  }
}

使用环境变量（推荐）

JSON
"apiKey": "{env:TOKENAPIB_API_KEY}"

然后设置：export TOKENAPIB_API_KEY="sk-你的API密钥"

运行：

bash
opencode run -m tokenapibay/Qwen-Max "你的问题"

Cline 接入

Cline 是 VS Code 中 AI 编码 Agent 插件，提供独立侧边栏面板。

安装 Cline

  1. 在 VS Code 扩展市场搜索 Cline 并安装
  2. 安装后左侧侧边栏出现 Cline 图标

配置 TokenAPIBay 接入

  1. 点击 Cline 面板顶部的设置图标
  2. API Provider 选择 OpenAI Compatible
  3. 填写以下字段：
字段值
Base URLhttps://www.tokenapibay.com/v1/chat/completions
API Keysk-你的API密钥
Model ID如 Qwen-Max

注意：Base URL 末尾不要包含 /chat/completions，Cline 会自动拼接。如使用 Cline v3.34.0+，务必选择 OpenAI Compatible 而非 OpenAI，否则 Base URL 字段可能不显示。

Grok CLI 接入

Grok CLI 是 xAI 官方的终端 AI 工具，也支持社区版本（如 superagent-ai/grok-cli）。

环境变量配置

bash
export XAI_API_KEY="sk-你的API密钥"
export XAI_BASE_URL="https://www.tokenapibay.com/v1/chat/completions"

用户设置文件 user-settings.json
Mac/Linux: ~/.grok/user-settings.json
Windows: C:\Users\你的用户名\.grok\user-settings.json

JSON
{
  "apiKey": "sk-你的API密钥",
  "baseURL": "https://www.tokenapibay.com/v1/chat/completions"
}

Gemini CLI 接入

Gemini CLI 是 Google 官方终端 AI 助手。

OpenAI 兼容模式

Gemini 官方提供 OpenAI 兼容端点，可通过环境变量配置：

bash
export OPENAI_API_KEY="sk-你的API密钥"
export OPENAI_BASE_URL="https://www.tokenapibay.com/v1/chat/completions"

Python 调用示例：

Python
from openai import OpenAI

client = OpenAI(
    api_key="sk-你的API密钥",
    base_url="https://www.tokenapibay.com/v1/chat/completions"
)

response = client.chat.completions.create(
    model="Qwen-Max",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

AutoClaw 接入

AutoClaw 是 OpenClaw 生态的自动化工具，配置方式与 OpenClaw 完全兼容。

配置 openclaw.json
Mac/Linux: ~/.openclaw/openclaw.json
Windows: C:\Users\你的用户名\.openclaw\openclaw.json

与 OpenClaw 使用相同的配置格式：

JSON
{
  "models": {
    "providers": {
      "tokenapibay": {
        "baseUrl": "https://www.tokenapibay.com/v1/chat/completions",
        "apiKey": "sk-你的API密钥",
        "auth": "api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "Qwen-Max",
            "name": "Qwen-Max",
            "contextWindow": 128000,
            "maxTokens": 64000
          }
        ]
      }
    }
  }
}

验证配置：

bash
openclaw gateway restart
openclaw doctor
openclaw models list

Cursor 接入

Cursor 是 AI-first 代码编辑器，VS Code 用户可无缝切换。

安装 Cursor

平台安装方式
Windows下载 .exe 安装包，双击安装
macOS下载 .dmg，拖入 Applications 文件夹
Linux下载 .AppImage 或 .deb 安装包

下载地址：cursor.com/downloads

配置 TokenAPIBay 接入

  1. 打开 Cursor → Settings（Mac/Linux: Cmd + ,，Win/Linux: Ctrl + ,）
  2. 左侧菜单选择 Models
  3. 关闭默认模型开关（可选），避免误选官方模型
  4. 打开 OpenAI API Key 开关，填入 API Key
  5. 打开 Override OpenAI Base URL 开关，填写 API 地址
  6. 点击 + Add model，添加模型 ID（如 Qwen-Max）
  7. 点击 Verify 验证连接
字段值
Base URLhttps://www.tokenapibay.com/v1/chat/completions
API Keysk-你的API密钥
Model ID如 Qwen-Max、DeepSeek-V3

验证通过后，按 Cmd + L（Mac）或 Ctrl + L（Win/Linux）打开 Chat 面板，选择刚添加的模型测试。

Windsurf 接入

Windsurf 是 AI 驱动的 IDE。

  1. 打开 Windsurf → 设置 → API 配置
  2. 选择 OpenAI Compatible
  3. 填写：
字段值
Base URLhttps://www.tokenapibay.com/v1/chat/completions
API Keysk-你的API密钥
Model如 Qwen-Max

ChatBox 接入

ChatBox 是轻量级桌面 AI 客户端。

  1. 打开 ChatBox → 设置 → 模型提供商
  2. 选择 OpenAI API
  3. 填写：
字段值
API 域名https://www.tokenapibay.com/v1/chat/completions
API Keysk-你的API密钥
模型手动输入模型名称

Cherry Studio 接入

Cherry Studio 支持多模型管理的桌面客户端。

  1. 打开 Cherry Studio → 设置 → 模型服务
  2. 点击 添加 → 选择 OpenAI 兼容协议
  3. 填写：
字段值
名称TokenAPIBay
API 地址https://www.tokenapibay.com/v1/chat/completions
API Keysk-你的API密钥
模型从管理中手动添加模型名称

点击连通性检测，显示「连接成功」即可。

其他工具

任何支持 OpenAI API 兼容协议的工具均可通过以下三要素接入：

要素值
API Keysk-你的API密钥
Base URL（OpenAI 协议）https://www.tokenapibay.com/v1/chat/completions
Base URL（Anthropic 协议）https://www.tokenapibay.com/v1/messages
Model在模型广场查看可用模型列表

常见兼容工具：NextChat、LobeChat、Dify、FastGPT、LangChain、AutoGPT 等。

最佳实践

错误码

TokenAPIBay 在错误时返回与请求协议一致的错误格式：

HTTP 状态码

状态码说明处理建议
200请求成功-
400请求参数错误检查请求参数格式和必填字段
401认证失败检查 API Key 是否正确或是否已吊销，可在控制台重新生成
403权限不足检查账号认证状态或套餐权限
404接口或模型不存在验证请求路径和模型名称
429请求频率超限降低请求频率，或升级套餐提高限额
500服务器内部错误稍后重试，如持续失败请联系技术支持
502上游服务不可用检查模型提供商状态，稍后重试

OpenAI 协议错误格式

JSON
{
  "error": {
    "code": "insufficient_balance",
    "type": "insufficient_funds",
    "message": "账户余额不足"
  }
}

Anthropic 协议错误格式

JSON
{
  "type": "error",
  "error": {
    "type": "insufficient_funds",
    "message": "账户余额不足"
  }
}

CC Switch 配置教程

CC Switch 是跨平台桌面 GUI 工具，可一键切换 Claude Code / Codex / Gemini CLI / OpenCode 的 API 配置，免去手动修改 settings.json 的麻烦。

安装 CC Switch

平台安装方式
macOSbrew tap farion1231/ccswitch && brew install --cask cc-switch
Windows从 GitHub Releases 下载 .msi 安装包
LinuxArch: paru -S cc-switch-bin 或下载 .deb / .AppImage

添加 TokenAPIBay 提供商

  1. 启动 CC Switch，进入 Provider 管理 页面
  2. 点击 Add Custom Provider（若内置预设列表中没有 TokenAPIBay）
  3. 填写以下字段：
字段值
NameTokenAPIBay
API Keysk-你的API密钥
Claude Base URLhttps://www.tokenapibay.com/v1/messages
Codex Base URLhttps://www.tokenapibay.com/v1/chat/completions

配置模型映射

在 CC Switch 的 Model 映射 中，将 Claude Code 的三个 tier 模型指向 TokenAPIBay 支持的模型：

CC Switch 字段建议值
Haiku 模型DeepSeek-V4-Flash（轻量任务）
Sonnet 模型DeepSeek-V4-Pro（主力模型）
Opus 模型DeepSeek-V4-Pro（复杂任务）
Subagent 模型DeepSeek-V4-Flash（子代理低成本）

保存后点击 Apply，CC Switch 会自动写入 ~/.claude/settings.json，无需重启终端即可生效。

CC Switch 也支持 MCP 服务器管理、Skills 一键安装、Prompts 模板编辑等功能，详情见 GitHub 仓库。

常见问题

问题解决方案
401 错误API Key 错误或未实名认证，检查控制台密钥状态
无响应检查 Base URL 末尾是否包含正确路径
模型不存在在模型广场确认完整的模型标识
额度不足进入控制台充值或购买套餐
Token 消耗过快可在控制台设置调用限额
429 频率超限降低并发请求数或联系客服提高限额
还有问题？联系技术支持