用量 API
读取 Arcflow 密钥的用量和剩余预算。
GET /v1/usage 会返回用于认证请求的 sk-...* 密钥预算。
curl https://api.tryarcflow.com/v1/usage \
-H "Authorization: Bearer $ARCFLOW_API_KEY"响应
{
"object": "api_key.usage",
"id": "key_abc",
"name": "Claude Prod",
"redacted_value": "sk-...abcd",
"created_at": 1711471533,
"last_used_at": 1711555126,
"foundation": "all",
"budget": {
"used_percent": 40,
"remaining_percent": 60
},
"subscription": {
"product_id": "prod_pro",
"five_hour": { "window_seconds": 18000, "used_percent": 30, "remaining_percent": 70 },
"weekly": { "window_seconds": 604800, "used_percent": 42, "remaining_percent": 58 }
}
}额度消耗仅以百分比返回——底层的美元上限与支出在这个公开的、由密钥认证的
端点上被有意隐去。subscription 块仅在密钥属于某个订阅套餐时出现,报告滚动
5 小时窗口和每周窗口。
交互页面
公开的 /zh/usage 页面会从浏览器直接调用该端点。
它不会保存密钥,也不会经过 Next.js 后端 route。
Budget schema
| Field | Type | 说明 |
|---|---|---|
used_percent | number | 密钥已消耗额度的百分比。 |
remaining_percent | number | 密钥剩余额度的百分比。 |