Arcflow

用量 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

FieldType说明
used_percentnumber密钥已消耗额度的百分比。
remaining_percentnumber密钥剩余额度的百分比。