用量与计费

/v1/usage 用于让当前 API Key 查询自己的余额、额度和用量统计。

查询用量

接口说明：

项目	值
Method	`GET`
Path	`/v1/usage`
认证	`Authorization: Bearer YOUR_API_KEY`

Query 参数：

参数	类型	必填	说明
`days`	integer	否	日用量统计窗口，允许 `1-90`。
`timezone`	string	否	日统计使用的时区。
`start_date`	string	否	模型统计开始日期，格式 `YYYY-MM-DD`。
`end_date`	string	否	模型统计结束日期，格式 `YYYY-MM-DD`。

请求示例：

bash

curl 'https://api.llmapi.site/v1/usage?days=7&start_date=2026-05-01&end_date=2026-05-29&timezone=Asia%2FShanghai' \
  -H 'Authorization: Bearer YOUR_API_KEY'

响应模式

接口会根据 API Key 配置返回不同模式。

`mode`	说明
`quota_limited`	API Key 配置了总额度或速率限制。
`unrestricted`	API Key 未配置 Key 级额度，返回订阅或钱包余额视图。

额度受限响应示例：

json

{
  "mode": "quota_limited",
  "isValid": true,
  "status": "active",
  "quota": {
    "limit": 100,
    "used": 12.34,
    "remaining": 87.66,
    "unit": "USD"
  },
  "remaining": 87.66,
  "unit": "USD",
  "usage": {
    "today": {
      "requests": 42,
      "input_tokens": 12000,
      "output_tokens": 3400,
      "total_tokens": 15400,
      "cost": 0.82,
      "actual_cost": 0.82
    },
    "total": {
      "requests": 320,
      "input_tokens": 80000,
      "output_tokens": 25000,
      "total_tokens": 105000,
      "cost": 12.34,
      "actual_cost": 12.34
    },
    "average_duration_ms": 1820,
    "rpm": 3,
    "tpm": 1200
  },
  "daily_usage": [],
  "model_stats": []
}

钱包余额响应示例：

json

{
  "mode": "unrestricted",
  "isValid": true,
  "planName": "钱包余额",
  "remaining": 42.5,
  "unit": "USD",
  "balance": 42.5,
  "usage": {
    "today": {
      "requests": 10,
      "total_tokens": 3200,
      "actual_cost": 0.21
    }
  }
}

订阅分组响应示例：

json

{
  "mode": "unrestricted",
  "isValid": true,
  "planName": "Pro Plan",
  "unit": "USD",
  "remaining": 15.2,
  "subscription": {
    "daily_usage_usd": 1.2,
    "weekly_usage_usd": 4.5,
    "monthly_usage_usd": 18.3,
    "daily_limit_usd": 5,
    "weekly_limit_usd": 30,
    "monthly_limit_usd": 100,
    "expires_at": "2026-06-30T00:00:00Z"
  }
}

任务 API 计费

异步任务当前不写入传统 usage_logs，因此不会作为逐条记录出现在传统用量明细中。任务扣费会直接更新余额；请通过 GET /v1/tasks/{id} 或管理端任务详情查看 estimated_cost、actual_cost 和 billing_detail。

任务提交时预扣预估费用。成功后按当前支持的图片规格矩阵、视频时长或按次价格结算；实际费用低于预估费用会退回差额，高于预估费用会补扣差额。失败、超时或取消会释放预扣，不产生任务费用。当前视频上游返回的 token usage 不参与扣费。

错误码

状态码	原因
`400`	日期范围、时区等查询参数无效。
`401`	API Key 缺失或无效。
`403`	API Key 已停用或无权查询用量。
`500`	用量统计加载失败。

用量与计费 ​

查询用量 ​

响应模式 ​

任务 API 计费 ​

错误码 ​

用量与计费

查询用量

响应模式

任务 API 计费

错误码