密钥管理

概览

ARouter 使用两种类型的密钥：

密钥类型	前缀	用途
管理密钥	`lr_mgmt_xxxx`	通过管理 API 创建、列出、更新和删除 API Key。
API Key	`lr_live_xxxx`	发起 LLM 请求（聊天补全、嵌入等）。

管理密钥可以创建具有范围访问权限的 API Key：

允许的服务商 — 例如只允许 OpenAI 和 Anthropic
允许的模型 — 例如只允许 gpt-5.4 和 claude-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
Python
Go
Node.js

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"
  }'

import requests

resp = requests.post(
    "https://api.arouter.ai/api/v1/keys",
    headers={"Authorization": "Bearer lr_mgmt_xxxx"},
    json={
        "name": "production-backend",
        "allowed_providers": ["openai", "anthropic"],
        "limit": 150,
        "limit_reset": "monthly",
        "expires_at": "2025-12-31T23:59:59Z",
    },
)
data = resp.json()
print("API Key:", data["key"])

key, err := client.CreateKey(ctx, &arouter.CreateKeyRequest{
    Name:             "production-backend",
    AllowedProviders: []string{"openai", "anthropic"},
    Limit:            float64Ptr(150),
    LimitReset:       "monthly",
})
fmt.Println("API Key:", key.Key)

const key = await router.createKey({
  name: "production-backend",
  allowed_providers: ["openai", "anthropic"],
  limit: 150,
  limit_reset: "monthly",
});
console.log("API Key:", key.key);

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_size、page_token 和 offset 查询参数进行分页。

更新 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}'

可以更新 name、disabled、limit、limit_reset、allowed_providers 和 allowed_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` 的短期密钥
服务商锁定	仅将预发布环境限制为廉价模型
速率保护	通过控制台按密钥调整限额

快速开始

核心概念

路由

功能特性

使用指南

隐私

管理

最佳实践

框架与集成

供应商接入

帮助

概览

创建 API Key

响应

列出 API Key

更新 API Key

删除 API Key

使用场景

​概览

​创建 API Key

​响应

​列出 API Key

​更新 API Key

​删除 API Key

​使用场景

概览

创建 API Key

响应

列出 API Key

更新 API Key

删除 API Key

使用场景