Fast AI
快速开始鉴权说明用量查询客户端选择指南Claude CodeCodexOpenCodeClineCherryStudioCC SwitchAPI 概览Chat Completions API网页对话服务条款隐私政策退款政策联系我们

用量查询

用网站、浏览器插件、CC Switch 或 skill 快速查看 API 使用情况和剩余额度。

网站
套餐与账单
更偏账号维度的请求记录、Token 和费用汇总。
浏览器插件 / CC Switch / Skill
/v1/usage
更偏当前 API Key 可见权益的剩余额度、最近请求和多权益视图。
推荐顺序
网站排查全局，插件 / Skill / CC Switch 排查单 Key
这样更不容易把不同口径的数据混在一起。

先理解四种查询方式的差异

网站控制台更适合看账号层面的请求记录、Token 消耗和费用趋势。

浏览器插件、CC Switch 和 fastai-usage skill 都会围绕 /v1/usage 工作，重点是“这把 API Key 当前能看到哪些权益、每个权益还剩多少、最近这把 Key 发过哪些请求”。

浏览器插件比 CC Switch 和 skill 多了一层“账户长期登录”模式，可以额外看账号统计、API Key 列表，并切换指定 Key 继续查 /v1/usage。

所以，如果你发现网站上的总用量和插件 / skill / CC Switch 看到的剩余额度没有一一对应，不一定是错误，通常只是统计口径不同。

不要混淆口径
网站控制台偏“账号整体使用记录”，而 /v1/usage 偏“当前 API Key 的可见权益视图”。排查问题时，先确认你要看的到底是哪一层。

方式一：在网站控制台查看

适合查看账号近期请求、费用、模型分布和时间范围筛选。

1
进入控制台用量页
登录后访问 https://fastai.run/console/usage。
2
查看汇总和明细
你可以看到总请求数、总 Token、总费用，以及按时间和模型过滤后的明细记录。
3
结合请求日志排查
如果你要判断某次调用是否成功计费、哪个模型消耗高，网站控制台通常最直接。

方式二：在 CC Switch 中查看

适合同时管理多个客户端时，直接在 provider 卡片中查看当前 API Key 可见权益。

  • CC Switch 会直接调用 Fast AI 的 /v1/usage。
  • 如果 all_entitlements 返回多个权益，卡片会展开成多套餐列表。
  • 这版脚本会按 all_entitlements 全量展开，并把当前绑定、限制类型、到期时间和失效状态一起显示出来。
查看 CC Switch 配置教程
包含安装步骤、provider 配置和完整用量脚本。

方式三：使用浏览器插件

适合在浏览器里直接看当前 Key 的多权益余额，也适合通过账户长期登录切换不同 API Key 查询。

  • 提供 API Key 直查模式，直接请求 Fast AI 的 /v1/usage。
  • 提供账户长期登录模式，不复用普通网页登录 Cookie，可以额外查看账户统计和 API Key 列表。
  • 适合在 Chrome / Edge 中做可视化排查，查看多权益、pay_as_you_go 和最近请求。
什么时候优先用插件
如果你不想切到终端，或者要让非开发同学也能直观看 Key 的权益、按量付费和账户统计，插件通常是最省事的入口。
查看浏览器插件仓库
查看源码、安装说明、发布说明和版本更新。
浏览器插件 Releases
下载最新 Chrome / Edge 发布包。

方式四：使用 fastai-usage skill

适合在 Codex、Claude Code 或 OpenCode 里直接查询当前环境中的 API Key 用量，不用切到浏览器。

skill 会查什么
它会优先读取当前环境中的 FASTAI_API_KEY、OPENAI_API_KEY 等变量，然后调用 /v1/usage，汇总当前权益、可见权益列表以及最近请求记录。
1
推荐：用 npx skills 直接安装
如果你已经安装了支持 skills 的客户端，直接用 npx skills 安装最省事。
npx skills
npx skills add https://github.com/FastAIRun/skills \
  --skill fastai-usage \
  -g \
  -a codex \
  -a claude-code \
  -a opencode \
  -y
2
手动安装（可选）
如果你不想使用 npx skills，也可以从 Fast AI 官方 skills 仓库 https://github.com/FastAIRun/skills 下载或复制 fastai-usage 目录到本地后手动放到客户端目录。
Clone Skills Repo
git clone https://github.com/FastAIRun/skills.git
cd skills
Codex
mkdir -p ~/.codex/skills
cp -R ./fastai-usage ~/.codex/skills/
Claude Code
mkdir -p ~/.claude/skills
cp -R ./fastai-usage ~/.claude/skills/
OpenCode
mkdir -p ~/.config/opencode/skills
cp -R ./fastai-usage ~/.config/opencode/skills/
3
执行查询
安装好后，在不同客户端中触发 skill。OpenCode 如果需要固定的 /fastai:usage slash command，再按它自己的 Commands 文档额外注册一个同名命令。
Codex
$fastai-usage
Claude Code
/fastai:usage
OpenCode
让 agent 直接调用 fastai-usage skill，或自定义 /fastai:usage 命令

如果你想直接打接口

排查自动化、CI 或脚本问题时，直接调用 /v1/usage 最直接。

curl
curl https://api.fastai.run/v1/usage \
  -H "Authorization: Bearer YOUR_API_KEY"
查看 API 概览
了解 `/v1/usage` 的字段结构、兼容字段和限制说明。
上一篇← 鉴权说明下一篇客户端选择指南 →