01 · 创建账户与密钥
通过邮箱注册或 Google 登录,进入控制台的“接入配置”,填写名称并创建专属 Key。密钥只展示一次,请保存到安全位置。
账户开通计费并完成充值后,可以发起模型调用。所有密钥共用当前账户的余额,用量不会合并到其他账户。
创建我的 Key ↗02 · 连接你的工具
控制台提供专属配置包,也可以在支持 OpenAI 兼容接口的工具中手动填写以下地址与 Key。
https://pilot.tokenbots.top/v1
- Windows:完整解压配置包,按包内说明运行 install-native.cmd。
- macOS / Linux / CLI:安装 Node.js 20+ 和所需客户端,运行对应 setup 文件。
- WSL:在 WSL 内单独配置。模型与推理强度在客户端选择。
配置包包含你的 Key,请勿转发。桌面定制安装与手动 API 配置的支持范围以包内说明为准。
03 · 发起一次 API 调用
以下为 Python 示例。把你的 Key 放入本机环境变量 TOKENBOT_API_KEY,然后使用 OpenAI SDK 发起请求。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["TOKENBOT_API_KEY"],
base_url="https://pilot.tokenbots.top/v1",
)
response = client.responses.create(
model="gpt-6.1-sol",
input="用一句话介绍你能帮助我完成什么。",
reasoning={"effort": "low"},
)
print(response.output_text)可用模型以 GET /v1/models 为准。调用记录与 Token 统计会在控制台同步;网页显示可能稍有延迟。
Windows 检查更新与生图
已有“检查更新”按钮的 TokenBots Codex,直接在软件内更新。只有尚无此按钮的旧版才需要一次性更新包:保存任务并完全退出,完整解压后双击 更新现有客户端.cmd。更新保留现有 Key、项目和会话。
打开桌面上的 TokenBots Codex,在左下角账号菜单点击检查更新。当前版本最新时,会显示“已经检查过,是最新版本”、上次检查时间和 Last update(上次安装更新时间)。如果发现新版本,点击更新,下载完成后保存任务,完全退出并重新打开,完成安装。
网络或校验失败会提示重试,不会显示已是最新版本。检查更新同时核对 TokenBots 更新版本和客户端基础版本;不会强制中断正在进行的任务。旧版仍可在启动时后台获取更新。
本次更新:2026111501,客户端版本:26.1111.21308。基础包约 1 GB,下载完成后完全退出再重开;较老版本需先更新下载器,再重启一次完成基础客户端升级。现有 TokenBots 登录方式不变。插件仍需按各服务要求授权,更新不代表 GitHub 账号已经连接。
更新包含 Windows 桌面操作、浏览器工具与生图支持。桌面操作可使用当前已打开的软件和浏览器窗口;保持 Windows 会话解锁,更新后完全退出并重新打开,新建本地对话以加载工具。生图可输入“生成一张蓝底灯塔图片”,按提示允许生成后,在 Pictures/TokenBots 查看 PNG。
04 · 价格与账单
人民币充值 ¥1 = $1 站内额度。以官方标准 API 美元基准价的数值为基础,默认乘 0.5 模型倍率扣除站内额度。例如 GPT-6.1 Sol 基准输入价为 $2/百万 Token,实际输入费用为 ¥1/百万 Token。普通输入、输出、缓存读取与缓存写入分别计价,倍率只应用一次。最新金额以公开价格表和账户账单为准。
模型、速度及后台任务是否可用,取决于上游账户支持情况与实际返回;本站不再额外拦截后台任务或速度参数。输入中的缓存读取、缓存写入分别计算,并从普通输入中扣除,避免重复计费;推理 Token 已包含在输出用量中。
账户使用美元符号标记站内额度,不代表可兑换的美元现金。人民币充值严格按 1:1 入账,其他币种由管理员明确登记实收与对应额度。历史免费用量不追扣,人民币待启用金额不会自动兑换。余额不足时拒绝新请求,已开始的请求结算可能使余额小额为负。
查看余额与逐笔账单 ↗05 · 遇到问题
- 无法调用:核对 Key 状态、账户余额、模型 ID 和接入地址。
- 没有最新用量:等待采集更新,再点击控制台的刷新按钮。
- Key 丢失:停用旧 Key,再创建一把新的密钥。
- 希望定制业务助手:进入AI Agent 定制,描述场景并提交需求。