跳转到主要内容
ARouter 使用两种具有不同权限的 API 密钥类型：
密钥类型前缀用途
标准 API 密钥lr_live_...LLM 推理，所有 /v1/* 端点
管理 API 密钥lr_admin_...密钥管理，仅限 /api/v1/keys/* 端点
管理密钥不能调用 /v1/chat/completions 或其他推理端点。标准密钥不能管理其他密钥。

​
创建管理 API 密钥

  1. 前往 ARouter 控制台
  2. 点击新建密钥
  3. 选择管理密钥类型
  4. 复制密钥 — 仅显示一次

​
使用场景

管理密钥专为以下场景设计：
  • CI/CD 流水线 — 在部署时轮换应用密钥
  • 密钥配置服务 — 为每个用户或租户创建密钥
  • 管理脚本 — 审计或清理未使用的密钥
  • Terraform / 基础设施即代码 — 管理密钥生命周期

​
密钥管理端点

所有管理端点都需要管理 API 密钥：

​
列出密钥

curl https://api.arouter.ai/api/v1/keys \
  -H "Authorization: Bearer lr_admin_xxxx"

{
  "data": [
    {
      "hash": "abc123...",
      "name": "production-app",
      "label": "Production",
      "created_at": "2026-01-01T00:00:00Z",
      "last_used_at": "2026-04-01T12:00:00Z",
      "usage": {"prompt_tokens": 1500000, "completion_tokens": 450000, "cost": 12.50},
      "limit_usd": 100.0,
      "rate_limit": {"requests_per_minute": 100}
    }
  ]
}

​
创建密钥

curl -X POST https://api.arouter.ai/api/v1/keys \
  -H "Authorization: Bearer lr_admin_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "staging-app",
    "label": "Staging",
    "limit_usd": 25.0,
    "allowed_models": ["openai/gpt-5.4", "anthropic/claude-sonnet-4.6"]
  }'
响应： 
{
  "key": "lr_live_xxxx...",
  "hash": "def456...",
  "name": "staging-app"
}
key 值仅在创建时返回一次。请安全存储 — 之后无法再次获取。

​
更新密钥

curl -X PATCH https://api.arouter.ai/api/v1/keys/{key_hash} \
  -H "Authorization: Bearer lr_admin_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Staging (v2)",
    "limit_usd": 50.0
  }'

​
删除密钥

curl -X DELETE https://api.arouter.ai/api/v1/keys/{key_hash} \
  -H "Authorization: Bearer lr_admin_xxxx"

{"deleted": true, "hash": "def456..."}

​
密钥对象参考

字段类型说明
hashstring唯一密钥标识符（可安全存储，不是密钥本身）
namestring供您参考的内部名称
labelstring控制台中显示的标签
created_atstringISO 8601 创建时间戳
last_used_atstringISO 8601 最后使用时间戳
usage.prompt_tokensinteger累计提示 token
usage.completion_tokensinteger累计补全 token
usage.costnumber累计费用（美元）
limit_usdnumber|null消费限额。null = 不限制
rate_limit.requests_per_minuteinteger|null每分钟请求数限制。null = 不限制
allowed_modelsstring[]|null模型白名单。null = 允许所有模型
allowed_providersstring[]|null服务商白名单。null = 允许所有服务商

​
自动密钥轮换

请参阅 API 密钥轮换 获取使用管理密钥进行零停机密钥轮换的完整指南。

​
相关文档