如何查看 Kimi（Moonshot AI）API 余额？

最后更新：2026年9月26日

登录 platform.kimi.ai，在控制台中打开费用明细页面。或者用你的 API 密钥调用 GET https://api.moonshot.ai/v1/users/me/balance。字段 available_balance 就是你还能花的金额。

下文介绍：三个余额字段的含义、余额为零时会怎样、为什么没有用量接口，以及为什么必须在两个平台中选对一个。Moonshot 以前就改过平台名称；本页依据的是其自己的文档在上述日期的内容。

Moonshot、Kimi 和两个平台

Kimi API 由 Moonshot AI 运营。其开发者网站已迁移：platform.moonshot.ai 现在跳转到 platform.kimi.ai，platform.moonshot.cn 跳转到 platform.kimi.com。API 主机保留旧名称：api.moonshot.ai 和 api.moonshot.cn。

这是两个独立的平台，而不是同一账户的两个入口。Kimi 建议中国大陆以外的用户使用 platform.kimi.ai。两边的账户、余额和密钥各自独立。你在一个平台上充值的余额不会显示在另一个平台上。

开放平台也与 Kimi 的其他产品分开。Kimi 的帮助页面明确说明，开放平台、Kimi Code 和 Kimi 会员不共享密钥或余额。会员不会变成 API 余额，API 余额也不能购买会员或 Kimi Code 套餐。

在控制台中

你当前的余额，
每日用量，
按模型的用量和费用，
随时间变化的历史支出。

计费数据有延迟，Kimi 没有给出固定的延迟时间。所以这个页面上今天的支出是初步数字，不是最终数字。

通过 API

余额接口是一个普通的 GET 请求，以你的 API 密钥作为 Bearer 令牌：

GET https://api.moonshot.ai/v1/users/me/balance
Authorization: Bearer <your API key>

在中国平台上，路径相同，主机是 api.moonshot.cn。返回结果包含三个数字：

available_balance——你还能花的金额：现金和代金券之和。这个数字决定你的调用能否通过。
voucher_balance——代金券余额。不会低于零。
cash_balance——你充入的钱。可以低于零；负数表示你欠 Moonshot 钱。

货币取决于平台。国际版文档以美元给出这三个字段；中国版文档以人民币给出。返回结果本身不带货币字段，所以你的代码必须知道密钥来自哪个平台。

充值活动赠送的代金券也会进入 voucher_balance。Kimi 的帮助页面建议你通过这个接口查看代金券是否已到账。

余额为零时会怎样

一旦 available_balance 为零或更低，Kimi 会以错误 exceeded_current_quota_error 拒绝对其模型的调用。这时你需要充值，或检查你的代金券是否仍然有效。

账户欠费或代金券过期时，也会出现同样的错误。Kimi 把它列为 429 响应的原因之一，与速率限制和过载并列。充值可以解决这一种。Kimi 说，对于过载，充钱没有用。

在余额降到零之前，Kimi 提供两道刹车：

余额提醒。Kimi 建议开启；余额低于你设定的金额时，平台会通知你。
每个项目的每日预算，在控制台的项目设置中设定。项目达到预算后，Kimi 会拒绝该项目中的所有 API 调用。由于计费有延迟，上限可能要过一段时间才生效。

没有用量接口

API 只报告余额，别无其他。每日用量、按模型的费用和历史支出只在控制台的费用明细页面上。

如果你想自己记录，一种方法是在固定时间读取余额，记下它下降了多少。只要中间不充值就行，但它无法区分模型或项目。其他 AI API 如何处理费用、Kimi 在其中处于什么位置，见一览 AI API 费用。

密钥返回 401 时

很可能是密钥属于另一个平台。platform.kimi.ai 的密钥只能用于 api.moonshot.ai，platform.kimi.com 的密钥只能用于 api.moonshot.cn。发到错误的主机，有效密钥也会返回 401。

Kimi 自己的检查清单还列出另外两个原因：密钥来自 Kimi Code 而不是开放平台，以及本地工具中的旧设置仍指向另一个密钥或主机。创建新密钥之前，先检查这些。

在 AI Cockpit 中

Kimi K3 卡片位于 Mac 菜单栏、iPhone 和 iPad 上的 App 中，以及 Windows 通知区域。在 Apple Watch 上（通过 iPhone App），Kimi 显示为一行可用余额。你在“设置”中输入 API 密钥并选择平台（国际版或中国版）；卡片随后调用上面介绍的余额接口。

可用余额，下方显示代金券和现金部分。
一个“活跃”或“空”标志，可用余额为零或更低时，卡片标题中显示警告。
卡片上注明 Kimi 不通过 API 提供用量。
仅限 Mac：如果你还输入了 Kimi Code 套餐的访问令牌，卡片会显示该套餐的会话配额，包括已用比例和重置时间。默认在 75% 和 90% 时变为警告颜色。你也可以把它放到菜单栏中。

它不做的事：充值、显示每日或每月支出，或在 Kimi 一侧设置提醒和预算。卡片总是以美元标注金额。在中国平台上，Moonshot 以人民币计算，所以在那里请把数字理解为人民币。

AI Cockpit 如何读取其他 API 的费用，见一览 AI API 费用。其他问题的简短解答，见常见问题页面。