计费与用量

追踪 API 用量、费用，并管理你的账户余额。

计费方式

• 预付费余额模式 — 先充值，每次请求按实际用量扣费
• 文本模型：按 Token 计费（Prompt、Completion、缓存 Prompt 各有不同单价）
• 视频模型：按消耗 Token 计费（Seedance 2.0：¥46/M tokens）
• 每次请求前检查余额，余额不足返回 403

用量查询 API

方法	路径	说明
GET	/v1/auth/key	查询余额和用量汇总
GET	/v1/generation?id=xxx	查询单条请求详情
GET	/portal/summary	今日 / 本月用量汇总
GET	/portal/usage	用量历史（分页）
GET	/portal/balance	当前余额
GET	/portal/activity/by-model	按模型分组的用量统计
GET	/portal/activity/by-key	按 API Key 分组的用量统计
GET	/portal/activity/export	导出 CSV

请求详情

curl "https://api.dsesnet.com/v1/generation?id=req-abc123" -H "Authorization: Bearer gw-your-key"

{
  "data": {
    "id": "req-abc123",
    "model": "deepseek-chat",
    "total_cost": 0.0015,
    "tokens_prompt": 10,
    "tokens_completion": 25,
    "latency": 1250,
    "finish_reason": "stop"
  }
}

响应头

每次对话补全响应都会包含用量相关的响应头：

X-RateLimit-Limit-Tokens: 500000
X-RateLimit-Remaining-Tokens: 495000
X-Dsesnet-Request-Id: eccb83f6ba72b907364afdb656358ec0
X-Usage-Cost-Estimate: 0.00160000

关于 X-Usage-Cost-Estimate

这个头是粗略估算，不是结算依据。它在网关边缘用模型的基础单价即时算出， 因此不包含分时段定价、阶梯价、账户专属价、缓存创建与工具调用等费用项 —— 实际账单可能与它不同。

需要准确金额时，请用同一个响应里的 X-Dsesnet-Request-Id 查询 GET /v1/generation?id=<request-id>，其 total_cost 即为该次请求的实际扣费； 汇总数据用 /v1/auth/key 或 /portal/usage。

兼容性说明：该头原名 X-Usage-Cost，2026-08-19 起改名为 X-Usage-Cost-Estimate， 以免被误当作结算金额。改名正在各网关节点分批生效，期间部分响应可能仍是旧名 —— 两者含义相同， 都只是估算值。如果你的程序在解析它，请改用上面的 /v1/generation 取准确金额。