要查 DeepSeek API 余额,不要从调用次数反推,直接请求官方的 GET /user/balance 接口。返回结果会告诉你当前余额是否足以继续调用,并分别列出总余额、赠送余额和充值余额。这个接口查的是 DeepSeek 官方开放平台账号;第三方应用里显示的点数或会员额度不是同一套账。
调用前准备
先在 DeepSeek 开放平台创建并保存 API Key。Key 只应放在环境变量或密钥管理工具里,不能写进网页、截图、聊天记录或要提交的代码。以下 PowerShell 示例从环境变量读取 Key:

$env:DEEPSEEK_API_KEY = "在本机临时填写,不要提交到仓库"
$headers = @{
Authorization = "Bearer $env:DEEPSEEK_API_KEY"
Accept = "application/json"
}
$result = Invoke-RestMethod `
-Uri "https://api.deepseek.com/user/balance" `
-Headers $headers
$result | ConvertTo-Json -Depth 5
官方余额接口文档给出的路径是 /user/balance,成功时返回 JSON。本文没有使用你的账号和真实 Key 发请求,示例中的变量需要你在自己的终端配置。
四个字段分别怎么看
| 字段 | 含义 | 检查重点 |
|---|---|---|
is_available |
余额是否足以继续 API 调用 | 它是布尔值,不能把字符串“false”当成可用 |
total_balance |
当前总可用余额 | 官方定义为赠送余额与充值余额之和 |
granted_balance |
尚未过期的赠送余额 | 赠送额度可能有到期规则,不等于现金 |
topped_up_balance |
充值余额 | 与赠送余额分开记录 |
balance_infos 是数组,每项还带 currency。记录余额时必须把币种一起保存,不能把不同币种的数字直接相加。金额字段按字符串读取更稳妥,后续计算应用十进制定点数,避免浮点误差。
怎样验证查询结果
- 确认 HTTP 状态为 200,响应能解析成 JSON,而不是登录页或代理报错页。
- 检查
is_available的类型和值,再遍历balance_infos,不要只取数组第一项后忽略币种。 - 对同一币种核对
total_balance是否与两个分项相符;若显示口径有变化,以官方字段说明为准。 - 在控制台财务页面查看同一账号,确认账号、组织或工作空间没有切错。
可复制的程序验收规则:
通过条件:HTTP 200;is_available 为布尔值;balance_infos 非空;
每项都有 currency、total_balance、granted_balance、topped_up_balance;
日志只记录币种和余额,不记录完整 API Key。
查询失败时按状态处理
- 401:检查 Key 是否缺失、复制不完整、已经撤销,或环境变量没有在当前终端生效。
- 403:检查账号权限和请求是否经过会改写请求头的代理。
- 网络超时:先记录为未知,不要把上一次缓存余额当成当前余额;稍后进行一次受控重试。
- 返回空数组或字段变化:保存脱敏后的状态码和响应结构,对照当前官方文档,不要用默认 0 伪装成功。
使用边界
余额可用只说明账户层面允许继续调用,不保证某个模型可用,也不代表不会触发速率限制。第三方客户端可能使用它自己的 API Key、代充值余额或会员次数,需到对应服务核对。本文依据 2026-10-01 读取的官方接口定义整理,未对你的账号、充值记录或扣费顺序进行实测;字段、币种和控制台入口以后可能调整。
Ai菜鸟网。发布者:AI小管家,转载请注明出处:https://www.alyyhw.com/32916.html