跳转到主要内容

概览

ARouter 使用两种类型的密钥:
密钥类型前缀用途
管理密钥lr_mgmt_xxxx通过管理 API 创建、列出、更新和删除 API Key。
API Keylr_live_xxxx发起 LLM 请求(聊天补全、嵌入等)。
管理密钥可以创建具有范围访问权限的 API Key:
  • 允许的服务商 — 例如只允许 OpenAI 和 Anthropic
  • 允许的模型 — 例如只允许 gpt-5.4claude-sonnet-4.6
  • 消费限额 — 每日/每周/每月最大预算
  • 有效期 — 到期后自动失效
管理密钥: lr_mgmt_abc123
  ├── API Key 1: lr_live_def456  (OpenAI+Anthropic, $150/月, 2025年12月到期)
  ├── API Key 2: lr_live_ghi789  (仅 DeepSeek, $50/天)
  └── API Key 3: lr_live_jkl012  (所有服务商, 无限额)

创建 API Key

curl -X POST https://api.arouter.ai/api/v1/keys \
  -H "Authorization: Bearer lr_mgmt_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "production-backend",
    "allowed_providers": ["openai", "anthropic"],
    "allowed_models": ["gpt-5.4", "claude-sonnet-4.6"],
    "limit": 150,
    "limit_reset": "monthly",
    "expires_at": "2025-12-31T23:59:59Z"
  }'
key 字段仅在创建时返回一次。请安全存储,之后无法再次获取。

响应

{
  "data": {
    "hash": "abc123...",
    "name": "production-backend",
    "key_type": "regular",
    "disabled": false,
    "limit": 150,
    "limit_remaining": 150,
    "limit_reset": "monthly",
    "allowed_providers": ["openai", "anthropic"],
    "allowed_models": ["gpt-5.4", "claude-sonnet-4.6"],
    "usage": 0,
    "created_at": "2025-01-15T10:30:00Z",
    "expires_at": "2025-12-31T23:59:59Z"
  },
  "key": "lr_live_xxxxxxxxxxxxxxxx"
}

列出 API Key

curl "https://api.arouter.ai/api/v1/keys?page_size=20" \
  -H "Authorization: Bearer lr_mgmt_xxxx"
支持通过 page_sizepage_tokenoffset 查询参数进行分页。

更新 API Key

curl -X PATCH https://api.arouter.ai/api/v1/keys/KEY_HASH \
  -H "Authorization: Bearer lr_mgmt_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"disabled": true}'
可以更新 namedisabledlimitlimit_resetallowed_providersallowed_models

删除 API Key

curl -X DELETE https://api.arouter.ai/api/v1/keys/KEY_HASH \
  -H "Authorization: Bearer lr_mgmt_xxxx"
已删除的密钥立即失效,无法恢复。

使用场景

场景配置
按服务隔离每个微服务使用一个 API Key,具有特定模型访问权限
成本控制按团队或环境设置消费限额
临时访问为承包商设置带 expires_at 的短期密钥
服务商锁定仅将预发布环境限制为廉价模型
速率保护通过控制台按密钥调整限额