TokLens 使用手册

开始使用

1. 注册

   邮箱注册，输入验证码。

2. 充值

   在定价页充值，银行卡 $10 起，USDC $1 起，单笔 $1,000 以内。

3. 创建 Key 并分配余额

   在「API Key」页创建 Key、选择服务，再到钱包给它分配余额。

4. 接入客户端

   打开「我的」里的「接入工具」，选好 Key 和工具，复制命令到终端运行。

钱包余额与 Key 额度

钱包余额不能直接调用 API。调用只扣 Key 的额度，Key 额度用完后，即使钱包还有余额，请求也会失败。

充值

$1–$1,000，一次性付款。银行卡 $10 起，通常 1 分钟到账；USDC $1 起，Solana 和 Polygon 几秒，Base 和 Arbitrum 通常几秒并等待链上确认，极端情况下可能更久。

分配给 Key

选 Key、填金额、确认分配。分配出去的余额不能转回钱包。

自动补充

默认关闭。开启后 Key 余额降到阈值就自动从钱包补，默认 $1 补 $5、日上限 $20。补款有几秒延迟，期间请求可能失败。有订阅额度时先用额度小额补，再用钱包余额；不扣银行卡，且只支持 1:1 到账的 Key。

密钥

每个 Key 属于一个服务，按该服务的价格计费。服务在创建后不能更改。

创建

在「API Key」页创建，选一个服务。不同服务需要不同的 Key。

查看 Key

在「API Key」页「我的 Key」里点「显示 Key」，即可看到完整 Key。

绑定管理员发放的 Key

在「API Key」页绑定，最多 20 个。

解绑与移除

「绑定 API Key」列表里的删除图标只解除绑定，Key 仍可用，额度保留。你创建的 Key 在「我的 Key」里点「详情」后删除，删除后立即失效，余额不退。管理员的 Key 联系管理员停用。

接入 Codex 和 Claude Code

登录后在「接入工具」中选好 Key 和工具，运行生成的命令。

安装命令

「接入工具」的命令不含完整 Key：能自动下发时用 15 分钟内有效、只能用一次的凭证，否则运行后在终端粘贴，浏览器不会收到。活动页「生成并复制命令」的命令已经带上活动 Key，只在自己的电脑上运行，不要发给别人。

检查是否接通

发一条请求，在「用量明细」里核对模型和扣费。

Codex Fast

Fast 模式响应更快，按标准价的 2 倍计费。

在当前会话开启

在 Codex 中输入 /fast on。/fast status 查看状态，/fast off 关闭。

始终开启

把下方配置写入 config.toml 并重启 Codex。用 TokLens 启动 Codex 的话，改 profile 目录里的 codex/config.toml，并使用 toklens-agentic 0.1.3 或更高版本；旧版本每次运行都会覆盖这个文件。

确认生效

发一条新请求，在「用量明细」的费用明细里看到「服务档位」快速、「档位倍率」2x 就对了。「账号/分组倍率」是另一项，1x 正常。

service_tier = "fast"

[features]
fast_mode = true

多智能体 Skills

一条命令安装本地 Skills，让 Codex、Claude 和 OpenCode 复用同一套工程流程。

适合做什么

多方案比较、蓝图执行、代码研究、架构优化和迁移规划。长任务会被拆开并发推进。

安装

在终端运行下面的命令。Skills 装在本机，不包含 Key，也不改动工具的接入配置。

curl -fsSL https://toklens.ai/agentic/scripts/install-b3ehive-skills.sh | bash

计费

价格单位为美元 / 百万 Token，按 Key 所属服务的价格从 Key 额度中扣除。

服务折扣

折扣服务旁标有「2 折」等标签，划线价是基准价，粗体是实际扣费价。

峰时与平峰

部分模型分峰时和平峰两档价格，时段标在模型下方，已换算为北京时间。

Fast 与 Flex

定价页显示标准价。Fast 2 倍、Flex 0.5 倍，部分模型有单独的 Fast 价。倍率和服务折扣分开算。

订阅

订阅每周发一笔美元额度，用任意 Key 调用任意模型都先扣它，再扣钱包余额。

周期

4 周（28 天）一期，付款后立即开始，并发放第一周额度。之后每 7 天发一次。

每周额度

额度先于钱包余额扣，和钱包余额同价计费，各服务的折扣照样享受。当周没用完的部分在周末作废，不累计到下周。

额度用完之后

默认接着扣钱包余额。在「订阅」页关闭「额度用完后继续扣钱包余额」后，用完就暂停调用，直到下周发放。

自动续费

用银行卡购买时可勾选「到期自动续费」，每期结束前一天自动扣款续期，可随时在「订阅」页关闭。支付宝、微信、USDC 购买需手动续费。

用量明细

每次请求的模型、Token 数和实际扣费，支持筛选和导出。

费用明细

鼠标移到费用上可以看到服务档位和倍率明细。

导出

CSV 导出全部记录，小票可复制、下载或打印。

不登录查看一个 Key

在首页输入 Key，不注册也能查看该 Key 的额度和用量明细。

账号与安全

在「账号」中管理资料、密码和余额提醒。

密码与登录邮箱

在「账号 → 登录与安全」修改密码或更换登录邮箱。忘记密码时，先在登录页用邮箱验证码登录，再用验证码设置新密码。改完后所有设备需要重新登录。

钱包余额提醒

设一个金额，余额低于时会收到邮件提醒。

服务地区

每个模型只在其厂商支持的国家和地区提供，例如 GPT 系列按 OpenAI 的支持地区，Claude 系列按 Anthropic 的支持地区。详见「合规说明」。

活动与礼品卡

在「活动」里兑换礼品卡、一键生成活动 Key，额度直接可用。

活动入口

登录后，侧边栏「钱包」下面有「活动」。进行中的活动都列在这里，每个活动有自己的页面和地址，主办方可以直接把链接发给参与者。

兑换礼品卡

在活动页输入卡上的码，点「兑换」，赠送额度立刻到账，页面顶部会显示额度和到期时间。每个账号在同一个活动只能兑换一张。

一键生成活动 Key

兑换后，在「创建 Key」里点「创建 <分组名> 分组 Key」。系统会按活动设定的名称和服务创建 Key，并把这张卡的额度分配进去，不用再自己起名、选服务、分配。分配没成功时，点「重试分配额度」，只补分配，不会重复扣款。之后在「API Key」页可以查看这个 Key 和它的余额。

礼品卡额度的规则

先于钱包余额使用，可以直接分配给 Key（包括 Zenwork、KCode 等合作编程工具）。到期后没用完的部分作废，已分配进 Key 但没用掉的也会收回；不能提现、退款或转让。

接入客户端

拿到 Key 后，看活动页的「接入指引」。Codex CLI：选 macOS / Linux 或 Windows，点「生成并复制命令」，粘贴到终端运行；命令已带上活动 Key，没有 Node.js 时会先自动安装，以后在新终端输入 codex-toklens 启动。Zenwork：在登录方式里选 TokLens，授权页「调用模型使用的 Key」选「使用已有 Key」和活动 Key，再点「授权」。其他工具用「我的」里的「接入工具」。

常见问题

请求报错或到账异常时，先按下面的现象查找。

接入方式

所有服务都是 OpenAI 兼容接口：把 SDK 的 base URL 换成服务地址，请求头带上 Key 即可调用。

curl -sS https://hkg.toklens.ai/v1/chat/completions \
  -H "Authorization: Bearer $TOKLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"Hello"}]}'

图片与视频

图片同步返回；视频是异步任务：提交、轮询、下载。

curl -sS https://hkg.toklens.ai/v1/images/generations \
  -H "Authorization: Bearer $TOKLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-image-2.0","prompt":"a lighthouse at sunset, watercolor","aspect_ratio":"16:9","resolution":"2k","quality":"low"}'

curl -sS https://hkg.toklens.ai/v1/videos/generations \
  -H "Authorization: Bearer $TOKLENS_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model":"grok-imagine-video-1.5-lite","prompt":"waves rolling onto a beach","duration":6,"resolution":"720p"}'
# {"request_id":"vidreq_xxx"}

curl -sS https://hkg.toklens.ai/v1/videos/generations \
  -H "Authorization: Bearer $TOKLENS_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model":"grok-imagine-video-1.5","prompt":"the cat turns its head","image":{"url":"https://example.com/cat.png"},"duration":5,"resolution":"1080p"}'

错误码

错误为 OpenAI 格式 {"error": {"type", "message", "param"}}，param 指出出错的参数。失败的请求不扣费。