端点 GET /v1/billing/costs
查询当前鉴权 API Key 在指定时间范围内的账单汇总，只返回汇总数据，不返回逐请求明细。
请求
鉴权使用 Authorization: Bearer sk-xxxxxx。
参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
start_time | 查询串 | integer | 是 | 开始时间（Unix 秒），包含该时间点 |
end_time | 查询串 | integer | 是 | 结束时间（Unix 秒），不包含该时间点 |
时间范围最长 90 天，超过返回 400 invalid_request。
响应
json
{
"start_time": 1784044800,
"end_time": 1784131200,
"total_amount": { "value": "1.280000", "currency": "USD" },
"requests": 86
}| 字段 | 说明 |
|---|---|
start_time / end_time | 实际生效的查询范围 |
total_amount | 范围内的费用合计，value 为字符串金额 |
requests | 范围内的请求次数 |
价格可能调整，历史账单以接口返回的金额为准，不能用当前价格表反推。
示例
bash
curl "https://caapi.top/v1/billing/costs?start_time=1784044800&end_time=1784131200" \
-H "Authorization: Bearer sk-xxxxxx"错误
| HTTP 状态 | error.code | 触发条件 |
|---|---|---|
| 400 | invalid_request | 参数无效，例如 end_time 不大于 start_time，或范围超过 90 天 |