API Reference用量与余额
用量与余额
查询账户余额、API 用量和近期积分流水。
用量与余额
用量接口返回当前账户余额、订阅额度、长期额度、API 汇总和近期积分流水。
GET /v1/usage?limit=20&offset=0
Authorization: Bearer YOUR_API_KEY查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
| limit | integer | 返回流水数量，范围 1 到 100 |
| offset | integer | 分页偏移量 |
| since | datetime | 仅统计指定时间之后的 API 用量 |
响应
{
"balance": 1200,
"subscriptionBalance": 900,
"longLivedBalance": 300,
"totalPurchased": 2000,
"totalConsumed": 800,
"apiUsage": {
"totalTasks": 12,
"succeededTasks": 11,
"failedTasks": 1,
"totalCreditsCharged": 600
},
"recentTransactions": []
}apiUsage.byEndpoint 会按 endpoint 汇总任务数量、成功失败数量、字符数和积分消耗。