DeepSeek_API调用怎么查看token用量？

在使用DeepSeek API时，准确掌握每次调用的Token消耗是控制成本的关键。本地Token估算往往与实际计费存在偏差，因此必须依赖服务器返回的真实计费数据。以下将通过三种方式，系统地说明如何获取单次请求、账户整体用量以及历史账单的Token信息。

查单次请求的真实Token用量

要获取单次API调用的真实计费Token数，必须避开本地Tokenizer的估算陷阱，直接抓取服务器返回的权威数字。以下两种方法均有效，推荐优先使用第一种。

方法一：读取响应头 x-billed-tokens 字段（最权威）

• 发起 POST /v1/chat/completions 请求后，在HTTP响应头中查找 x-billed-tokens 字段。
• 该字段值为纯数字字符串，例如 "1247"，已包含输入Token与实际生成输出Token，

  不含内部开销
  。
• 注意：不是 X-RateLimit-Remaining，也不是 openai-ratelimit-remaining-requests。

方法二：使用官方SDK的 response.usage.total_tokens（推荐Python/Node.js）

• SDK自动解析 x-billed-tokens 并映射为结构化属性，值与响应头完全一致。
• 不要再去加总 prompt_tokens 和 completion_tokens —— 它们是调试字段，

  不参与计费
  。

建议在代码中直接打印 response.usage.total_tokens，并记录到日志中，便于后期核对成本。

查账户整体用量

除了单次请求，还需要了解账户的整体消耗情况，以监控预算和发现异常。有两种方式：控制台页面和计量API。

方法一：通过控制台 Billing & Usage 页面查看

1. 登录

   DeepSeek Platform
   控制台。
2. 进入

   「Billing & Usage」
   页面。
3. 查看剩余Token、本月已用明细及各模型消耗分布。
4. 数据可能有几分钟延迟，刷新页面可获取最新值。

方法二：调用计量接口（适合开发者）

• 向 https://api.deepseek.com/v1/usage 发送GET请求。
• 在请求头中携带 Authorization: Bearer YOUR_API_KEY。
• 解析返回JSON中的 total_usage 和 used_tokens 字段。
• 建议设定时任务每日自动拉取，便于追踪趋势。

为什么控制台数据显示比实际少？
答：控制台数据可能有几分钟延迟，且部分内部调试Token不会计入。若需实时数据，请使用计量接口。

查历史账单与周期用量

对于成本归因和长期分析，需要导出历史账单。具体操作如下：

1. 第一步：进入控制台，点击

   “Billing”
   菜单项。
2. 第二步：选择计费周期（本月/上月/自定义时间段）。
3. 第三步：查看按日分列的API调用次数与Tokens消耗摘要。
4. 第四步：点击

   “下载CSV”
   导出完整报告，用于存档或成本归因分析。

【若发现异常高峰，立即检查API密钥是否泄露】

建议每月初导出上月CSV，并与本地日志比对，确保无意外计费。同时，可通过控制台设置用量告警，避免超出预算。

通过以上三种途径，您可以全面掌握DeepSeek API的Token消费情况：从单次调用的实时计费，到账户整体用量监控，再到历史账单的归档分析。始终依赖服务器返回的权威数据，而非本地估算，是精准控制成本的核心原则。