如何查看 Grok(xAI)API 用量和余额?
最后更新:2026年9月26日
登录 xAI Console。Usage Explorer 按天、API 密钥或模型显示你的 API 调用费用。Billing → API spend management 显示还剩多少预付余额。SuperGrok 或 X Premium 套餐单独计费,不会显示在那里。
下文介绍:每个页面显示什么、请求何时停止、发票如何运作、Management API 能读取什么,以及 AI Cockpit 显示什么。本页依据的是 xAI 自己的文档在上述日期的内容。
在哪里查看你的用量
在 xAI Console 中打开 Usage Explorer。它以美元显示你的 API 支出(也可切换为 Token),并可按 API 密钥、模型等分组和筛选。
- Dimension。默认为美元费用。你可以切换为 Token 或计费项数量。
- Granularity。例如按天。
- Group by 和 Filters。按 API 密钥、模型、请求 IP、集群或 Token 类型拆分或缩小图表范围。
xAI 把 Usage Explorer 描述为团队管理员的工具。如果你打不开,请联系你团队的管理员。xAI 的页面没有说明数字的更新频率,也没有说明能否导出。
对比数量时有个细节:xAI 指出,其接口会在每个请求中添加一些自己的 Token。所以你的提示词消耗的 Token 可能比分词器显示的多。
在哪里查看你的余额
在 xAI Console 中前往 Billing → API spend management。它显示你的预付余额,你也可以在那里购买额度或使用优惠码。
- 付款。额度立即扣款。银行转账需要两到三个工作日。
- 自动充值。你设定触发充值的余额、每次购买的金额(至少 $5),以及每月最多可充值的金额。
- 警告。当你用掉所设每月限额的 80% 时,API spend management 卡片会提醒你。
计费页面没有提到退款,也没有提到额度过期。
预付额度还是月度发票
xAI 提供两种 API 付费方式。预付额度是标准方式。月度发票计费默认关闭;你可以发邮件到 sales@x.ai,或通过 Billing 页面上的联系链接申请。
发票计费限额默认为 $0,因此预付余额用完后,xAI 会拒绝你的 API 请求。只有 xAI 为你开通了发票计费、而你又提高了该限额,后续使用才会计入月度发票。
- 顺序。总是先用预付额度。之后的使用才计入发票。
- 限额。你在 Billing → API Credits 下提高它(xAI 文档中的页面名称)。发票金额达到限额后,请求会停止,直到你再次提高限额。
- 发票。在 Billing → Invoices 下。xAI 表示目前无法重新生成发票,所以请先核对你的账单地址和税务信息。
这个限额不限制你的预付用量。如果只想用预付额度,xAI 建议把限额保持在 $0。
通过 Management API
xAI 也向脚本提供这些数字。你需要一个管理密钥,它与你的 API 密钥是分开的:xAI Console → Settings → Management Keys。你的账户需要 Management Keys 的读写权限;如果没有,你的团队管理员可以授予。基础地址是 management-api.x.ai。
读取数字的计费接口,每个对应一个团队:
GET …/prepaid/balance——预付余额及其变动。GET …/postpaid/spending-limits——发票用量的每月限额。GET …/postpaid/invoice/preview——本周期发票用量到目前为止的应付金额。POST …/usage——某段时间内的历史用量,按你选择的字段分组。
完整路径以 /v1/billing/teams/{team_id} 开头。其他接口会更改设置,例如限额或充值;请像对待密码一样对待管理密钥。
订阅还是 API
SuperGrok 或 X Premium 套餐包含 API 额度吗?xAI 的文档没有这样说。API 额度是单独的产品,在 xAI Console 中购买和计费。Grok 订阅在 grok.com 上管理;如果你通过 X Premium 付费,则由 X 管理。
订阅的使用情况有自己的页面:在 Grok App 或网页上的 Settings → Usage。它显示一条本周已用比例的进度条、按产品的拆分,以及每周重置的时间。这个拆分把“API”列为一个产品;xAI 的常见问题没有解释其中计入了什么,所以不要把它当作你的 Console 余额。
xAI 的常见问题还提到一点,值得了解:你不认识的大额发票,往往是 SuperGrok Heavy 年付套餐,而不是 API 使用。
在 AI Cockpit 中
Grok 卡片位于 Mac 菜单栏、iPhone 和 iPad 上的 App 中,以及 Windows 通知区域。Apple Watch 在服务列表中以一行显示它,由 iPhone App 传送。卡片需要 xAI Console 中的管理密钥,而不是平时的 xai- 密钥;App 会自己找到你的团队。
- 你的可用余额(美元)。余额为零时,简要摘要会变为警告。
- 如果设有发票用量限额:一条显示已用比例的进度条,以及限额本身。进度条使用与其他限额相同的警告颜色,Mac 上默认在 75% 和 90%,iPhone 和 Apple Watch 上在 80% 和 95%。在 Mac 上,你也可以把它选为菜单栏中显示的数字。
- 如果 xAI 只报告自动上限,卡片会把该金额显示为普通数字,不带进度条。
- 在 Mac 上,若在“设置”中开启了迷你折线图,会显示余额随时间变化的曲线。
- 默认每 15 分钟检查一次;你可以设为 5 到 60 分钟。
它不做的事:显示按模型的支出、Token 或每月合计,或购买额度。卡片自己也注明:按模型的用量只能在 Console 中查看。出于同样的原因,Grok 不计入 App 中套餐和 API 费用的每月合计。
AI Cockpit 如何读取其他 API 服务的费用,见一览 AI API 费用;OpenAI 见这个月 OpenAI API 花了我多少钱?。其他问题的简短解答,见常见问题页面。