Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
管理 API 密钥是专门用于 ARouter 管理员操作的独立凭证 — 用于创建、列出和删除 API 密钥。不能用于 LLM 推理。
| 密钥类型 | 前缀 | 用途 |
|---|---|---|
| 标准 API 密钥 | lr_live_... | LLM 推理，所有 /v1/* 端点 |
| 管理 API 密钥 | lr_admin_... | 密钥管理，仅限 /api/v1/keys/* 端点 |
/v1/chat/completions 或其他推理端点。标准密钥不能管理其他密钥。
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..."}
| 字段 | 类型 | 说明 |
|---|---|---|
hash | string | 唯一密钥标识符（可安全存储，不是密钥本身） |
name | string | 供您参考的内部名称 |
label | string | 控制台中显示的标签 |
created_at | string | ISO 8601 创建时间戳 |
last_used_at | string | ISO 8601 最后使用时间戳 |
usage.prompt_tokens | integer | 累计提示 token |
usage.completion_tokens | integer | 累计补全 token |
usage.cost | number | 累计费用（美元） |
limit_usd | number|null | 消费限额。null = 不限制 |
rate_limit.requests_per_minute | integer|null | 每分钟请求数限制。null = 不限制 |
allowed_models | string[]|null | 模型白名单。null = 允许所有模型 |
allowed_providers | string[]|null | 服务商白名单。null = 允许所有服务商 |