计费与用量

追踪 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-Usage-Cost: 0.00160000