DeepSeek API 余额怎么查？接口与控制台两种方法

DeepSeek API 的余额有两条查询路径：一是登录开放平台控制台看余额和用量，二是直接调用官方余额接口 GET https://api.deepseek.com/user/balance 取数。下面把请求方式、返回字段含义、扣减规则和常见异常一次讲清。

查余额有两条路：控制台和余额接口

1. 控制台路线：适合人工偶尔看一眼，能看到余额、充值和按 API Key 的用量。
2. 接口路线：适合写进监控脚本，让程序在余额偏低时自动告警。

两条路查的是同一份余额数据，区别只是入口不同。

方法一：在 DeepSeek 开放平台控制台看余额

1. 打开 platform.deepseek.com 并登录。
2. 进入账户的余额／用量区域，这里会展示当前余额与调用产生的消耗。
3. 需要按接口维度拆分时，用官方 FAQ 里给出的按 API Key 查看用量的方式对照排查，避免把多个 Key 的消耗混在一起看。

控制台还承担充值、开票和 API Key 管理，日常排查建议固定从这一个入口进。

方法二：调 /user/balance 接口查余额

官方在 API 文档里单独给出了余额接口，请求格式是固定的：

1. 请求方法：GET。
2. 请求地址：https://api.deepseek.com/user/balance。
3. 请求头：Authorization: Bearer <你的 API Key>，并带上 Accept: application/json。

用 curl 写出来是这样：

curl -L -X GET 'https://api.deepseek.com/user/balance' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <TOKEN>'

接口不需要额外参数，返回的就是当前账户的余额信息，具体字段含义见 余额接口文档。

返回字段怎么读：可用状态、赠送余额、充值余额

带货币的余额是数组，所以程序里取值要先按 currency 选币种再读 total_balance，不要直接假定只有一条。

余额怎么扣：赠送余额优先，峰谷价差一半

官方的扣减规则很明确：费用等于 tokens 数量乘以单价，从充值余额或赠送余额中扣除，两种余额都有时优先使用赠送余额。所以想让充值金额消耗得慢一点，先把赠送余额合理用掉反而更划算。

价格侧还有两个容易忽略的点：

1. 高峰时段为 UTC 周一至周五的 01:00 到 04:00、06:00 到 10:00，其余时段为平峰，平峰价是高峰价的一半。
2. 缓存命中与未命中的输入价格不同，长上下文重复调用的场景要尽量命中缓存。

把批量任务挪到平峰时段跑，是最直接的省钱手段，完整单价见 DeepSeek 模型与价格文档。

余额显示不对或余额不足时怎么处理

1. 先看 is_available：为 false 说明余额已不足以继续调用，需要充值。
2. 刚充值完余额没变：先确认充到的是同一账号，再刷新控制台重试，控制台数据与接口存在更新时差。
3. 怀疑余额被异常消耗：先按 API Key 拆用量，定位到具体 Key 后立刻轮换，官方 FAQ 专门收录了 API Key 泄露后的处理条目。
4. 关心赠送余额会不会过期：官方 FAQ 有余额是否过期的说明，以该页口径为准，不要按第三方说法推算。

排查接口报错时，可以先排除是不是限流而不是余额问题，参考什么是 HTTP 429 限流；如果同时接多家模型，多模型聚合平台使用指南里的用量核算思路可以直接复用，免费额度怎么排可以看硅基流动免费额度说明。更多余额与充值问题见 DeepSeek 官方 FAQ。